The latest articles on Forem by Saad Suaid (@alarbtech). https://forem.com/alarbtech https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F3725465%2Ff3460eae-09dd-4655-af10-14873a71a804.jpg https://forem.com/alarbtech en Saad Suaid Thu, 22 Jan 2026 12:42:07 +0000 https://forem.com/alarbtech/what-is-an-api-lg-ltkhtb-byn-lbrmj-5fl8 https://forem.com/alarbtech/what-is-an-api-lg-ltkhtb-byn-lbrmj-5fl8 <p><a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.amazonaws.com%2Fuploads%2Farticles%2F5892yorxv7c8mf8d0j8z.png" class="article-body-image-wrapper"><img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.amazonaws.com%2Fuploads%2Farticles%2F5892yorxv7c8mf8d0j8z.png" alt="رسم توضيحي لمفهوم API يظهر خادماً وحاسوباً متصلين بكابل بيانات لنقل المعلومات، مع نص: What is an API? لغة التخاطب بين البرامج." width="800" height="488"></a><br> الـ API من أكثر المفاهيم تداولا في عالم البرمجيات ولكنه يربك الكثيرين في البداية رغم بساطته الجوهرية.</p> <p>في هذا المقال ستتعرف على الفكرة بشكل مبسط مع ربطها بأمثلة من التطبيقات التي تستخدمها يوميا.</p> <h2> ما هو الـ API؟ </h2> <p>كل تطبيق له مستخدم نهائي يتفاعل معه عبر واجهة رسومية (<strong>GUI</strong>) مليئة بالأزرار والنصوص والصور. لكن عندما يريد برنامج أن يتحدث مع برنامج آخر لا يمكنه "الضغط على الأزرار" مثل البشر! وهنا يأتي دور الـ API.</p> <p>الـ <strong>API</strong> (Application Programming Interface) هو لغة التخاطب الرسمية بين التطبيقات أو العقد الذي يحدد كيف يمكن لبرنامج ما أن يطلب خدمة أو بيانات من برنامج آخر.</p> <h2> كيف يعمل؟ </h2> <p>لنأخذ مثال زر "إعجاب" في تطبيق تواصل اجتماعي:</p> <ol> <li> <strong>المستخدم:</strong> يضغط على زر Like في الواجهة الرسومية للتطبيق (GUI).</li> <li> <strong>الطلب:</strong> الزر مرتبط بنقطة نهاية برمجية (API Endpoint) ترسل طلب HTTP إلى الخادم، يبدو شيئا كهذا: <code>POST /posts/20/likes { user_id: 5 }</code> </li> <li> <strong>المعالجة:</strong> الخادم (Server) يستقبل الطلب ويفسره وفق منطق مبرمج مسبقا ويسجل الإعجاب في قاعدة البيانات.</li> <li> <strong>الرد:</strong> الخادم يعيد استجابة (Response) إلى التطبيق تؤكد نجاح العملية.</li> <li> <strong>التحديث:</strong> يتم تحديث واجهة المستخدم فيتغير لون الزر أو عدد الإعجابات.</li> </ol> <p>بهذا الشكل يكون المستخدم قد تعامل مع زر بسيط، بينما في الخلفية جرى تواصل منظم بين الواجهة والخادم عبر API.</p> <h2> الباب الرسمي للبيانات </h2> <p>لكي يحصل تطبيق على بيانات من خدمة أخرى هناك طريقان شائعان في عالم البرمجيات:</p> <ul> <li> ✅ <strong>الطريق الرسمي:</strong> استخدام الـ API الذي توفره الخدمة (مثل ChatGPT API أو Google Maps API) وفق توثيق واضح ومفاتيح وصول (API Keys).</li> <li> ❌ <strong>الطريق الملتوي:</strong> مثل <strong>Scraping</strong> أو محاولة الالتفاف للحصول على البيانات بطرق غير رسمية. هذا غالبا مخالف للشروط وغير مستقر وقد يكون غير قانوني.</li> </ul> <p>وجود API رسمي يعني أن الشركة قررت فتح جزء من وظائفها وبياناتها للمطورين بشكل آمن وقابل للاستخدام على المدى الطويل.</p> <h2> مثال يومي: تطبيق الطقس ☀️ </h2> <p>عندما تفتح تطبيق الطقس على هاتفك، التطبيق نفسه لا يملك أقمارا صناعية أو محطات رصد جوي.</p> <p>ما يحدث عادة هو أن التطبيق يرسل موقعك الجغرافي عبر API إلى خدمة طقس متخصصة ويستقبل منها بيانات الطقس بصيغة <strong>JSON</strong> وثم يعرضها لك في واجهة مبسطة.</p> <p>هذا يسمح لعشرات التطبيقات المختلفة بأن تعتمد على نفس خدمة الطقس بدلا من إعادة بناء منظومة رصد من الصفر.</p> <h2> لماذا يعتبر الـ API مهماً للمطورين؟ </h2> <ul> <li> <strong>التكامل:</strong> يمكن التطبيقات من التكامل مع خدمات جاهزة مثل الدفع (Stripe) والخرائط والذكاء الاصطناعي وغيرها.</li> <li> <strong>توفير الوقت والتكلفة:</strong> بدلا من بناء كل شيء من الصفر، تستهلك خدمة عبر API وتبني القيمة المضافة فوقها.</li> <li> <strong>الأتمتة:</strong> يفتح الباب للأتمتة والتوسع مثل نشر المقالات أو إدارة البيانات برمجيا (كما هو الحال مع dev.to API نفسه).</li> </ul> <p>في النهاية، الـ API هو الجسر الذي يربط بين مكونات عالم البرمجيات ويجعل الأنظمة المختلفة قادرة على العمل معا دون إعادة اختراع العجلة في كل مرة.</p> <h2> Next Steps 🚀 </h2> <p>إذا فهمت الآن فكرة الـ API وتريد الانتقال للجانب العملي فإليك خطوات مقترحة:</p> <ol> <li><p>جرب بناء أول REST API لك باستخدام Go في هذا المقال:<br> <a href="https://dev.to/moficodes/build-your-first-rest-api-with-go-2gcj">Build Your First REST API with Go</a></p></li> <li><p>تعرف على GraphQL وكيف يختلف عن REST في هذا المقال:<br> <a href="https://dev.to/whitep4nth3r/an-introduction-to-graphql-and-how-to-use-graphql-apis-13i">An introduction to GraphQL and how to use GraphQL APIs</a></p></li> </ol> <p>ابدأ بمقال REST إن كنت تفضل الأسلوب التقليدي أو انتقل مباشرة إلى GraphQL لو كنت مهتما بالمرونة العالية في جلب البيانات.</p> beginners api webdev