كيف يعمل REST API؟ من الطلب إلى الاستجابة خطوة بخطوة
في REST API يرسل العميل طلب HTTP إلى عنوان URL، ويعالج الخادم الطلب ويعيد استجابة غالبًا بصيغة JSON. تشرح المقالة هذه الدورة وطرق HTTP وقاعدة عدم الحفاظ على الحالة والمخاطر المرتبطة بالمصادقة.
Nurullah Okatan · كاتب المحتوى
· آخر تحديث: · قراءة 2 د

يتنقل REST API البيانات بين برنامجين عبر طلبات واستجابات HTTP: يرسل العميل طلبًا بطريقة محددة إلى عنوان مورد، فيعالجه الخادم ويعيد استجابة. يقوم هذا التبادل على بضع قواعد: لكل مورد عنوان URL خاص به، وتُنفَّذ العمليات بطرق HTTP القياسية، ولا يتذكر الخادم العميل بين الطلبات.
حلقة الطلب والاستجابة في REST API
REST نمط معماري يستخدم بروتوكول HTTP في التواصل بين البرامج. وفقًا لدراسة «Big Data Technology Literature Review» المنشورة على arXiv، يُعد هذا النهج أبسط من RPC وCORBA وSOAP/WSDL. تذكر مقالة REST على Wikipedia أن هذا النمط يحدده ست قيود توجه التصميم. ويصف دليل REST من Amazon هذا النمط بأنه معمارية برمجية تضع شروطًا على طريقة عمل الواجهة.

وفقًا لمقال أكاديمية بيرك حول طرق HTTP، تكون الحلقة الأساسية بسيطة. يرسل العميل طلبًا، ويعالج الخادم الطلب ويعيد استجابة. يمر الطلب الواحد بالخطوات التالية:
- يختار العميل عنوان URL للمورد وطريقة HTTP التي سيستخدمها.
- تُضاف إلى الطلب الترويسات وبيانات الاعتماد، وعند الحاجة جسم الطلب.
- يستقبل الخادم الطلب، ويتحقق من الهوية، وينفذ العملية المطلوبة.
- يعيد الخادم الاستجابة مع رمز الحالة.
- يقرأ العميل الاستجابة ويستخدمها في شاشته أو قاعدة بياناته.
لا يحتاج العميل إلى معرفة البنية الداخلية للخادم. فواجهة API، بالنسبة إلى المورد نفسه، تحدد العمليات التي يقدمها الخادم والقواعد التي تُقدَّم بها. ما دام العميل يلتزم بهذه القواعد فلا يهتم بقاعدة البيانات أو اللغة التي تعمل في الخلفية. للاطلاع على أساسيات مفهوم API يمكنك الرجوع إلى مقال ما هي API وما فائدتها.
ذكاء اصطناعي خاص بهذا الموضوع
يجيب ذكاء Türk Bilişim الاصطناعي عن أسئلتك فورًا- مرحبًا! اسأل عمّا يخطر ببالك.
المصادر وعناوين URL وطرق HTTP
في REST يملك كل عنصر بيانات عنوان URL خاصًا به. وفقًا لدراسة «Big Data Technology Literature Review» على arXiv، تعمل تطبيقات العملاء على هذه العناوين باستخدام أفعال HTTP القياسية مثل GET وPOST وDELETE. مثلًا يعرض العنوان /siparisler جميع الطلبات، بينما يعرض /siparisler/{id} طلبًا واحدًا. يحدد العنوان المورد الذي تُجرى عليه العملية، ويحدد الطريقة ما الذي سيُفعل. وبهذا يشير العميل والخادم إلى المورد نفسه بالاسم نفسه.
يحمل GET وPOST البيانات في أماكن مختلفة. وفقًا لأكاديمية بيرك، يقرأ GET البيانات من الخادم أو يسرد عناصرها، ولا يضع البيانات في الجسم بل تُنقل غالبًا عبر معاملات الاستعلام المضافة إلى الرابط، و/urunler?kategori=kitap مثال على ذلك. أما POST فينشئ موردًا جديدًا على الخادم، وتُرسل البيانات في جسم الطلب، غالبًا كجسم JSON.
تحدّث PUT موردًا موجودًا بالبيانات الجديدة، وتُنقل البيانات في هذه الطريقة أيضًا عبر الجسم. أما DELETE فتحذف المورد الذي يشير إليه العنوان، وغالبًا لا تحمل جسمًا.
| الطريقة | ما تفعله | مكان نقل البيانات | مثال على العنوان |
|---|---|---|---|
| GET | تقرأ البيانات أو تعرضها في قائمة | عنوان URL ومعاملات الاستعلام | /siparisler?durum=acik |
| POST | تنشئ موردًا جديدًا | جسم الطلب، غالبًا بصيغة JSON | /siparisler |
| PUT | تحدّث موردًا موجودًا | جسم الطلب | /siparisler/{id} |
| DELETE | تحذف المورد | عنوان URL فقط | /siparisler/{id} |
يؤدي استخدام طريقة في غير موضعها إلى نتائج غير متوقعة. فمثلًا، إذا كانت نقطة نهاية تحذف سجلًا تُستدعى عبر GET، فقد يشغلها متصفح يحمّل الروابط مسبقًا أو روبوت محرك بحث دون قصد.
هل تبحث عن تكاملات النظام (ERP، الفاتورة الإلكترونية، API)؟عدم الحفاظ على الحالة والتخزين المؤقت: ماذا يكسب الخادم؟
لا يتذكر الخادم الطلب السابق، لذلك تُرفق بيانات الاعتماد بكل طلب. وفقًا لمقالة daha.net عن REST API، يحمل كل طلب بيانات اعتماده وجميع المعاملات اللازمة. وعمليًا تُوضع هذه البيانات غالبًا في ترويسة Authorization على شكل مفتاح أو token. وبحسب Patika.dev، يُعالج كل طلب بمعزل عن الطلبات السابقة.
لا يحجز العميل المنتظر مساحة على الخادم. تذكر مقالة REST على Wikipedia أنه بفضل قيد عدم الحفاظ على الحالة لا يستهلك العميل المنتظر أي تخزين على الخادم. ولأن بيانات الجلسة لا تُحفظ على الخادم، يُعالج الطلب بالطريقة نفسها أيًا كان الخادم الذي يصل إليه. ولهذا يسهل إضافة خادم جديد عند ازدياد حركة المرور.
يمنع التخزين المؤقت تكرار إنتاج الاستجابة نفسها. وفقًا لدليل REST API من Amazon، تدعم خدمات RESTful التخزين المؤقت. تُحفظ بعض الاستجابات لدى العميل أو لدى وسيط، فتتحسن سرعة الاستجابة. يحصل عميل ثانٍ يطلب قائمة المنتجات نفسها على الاستجابة من الوسيط دون الذهاب إلى الخادم. وأفضل ما يُخزَّن مؤقتًا البيانات التي لا تتغير كثيرًا، مثل قوائم الفئات. ويبيّن الخادم المدة المسموح بتخزين الاستجابة فيها عبر ترويسة Cache-Control.
أمان REST API والمصادقة
يُرسل مفتاح API من العميل إلى الخادم مع كل طلب، لذلك يمكن اعتراضه في الطريق. وفقًا لدليل RESTful API من Amazon، فإن مفاتيح API أقل أمانًا لهذا السبب، وهي عرضة للسرقة عبر الشبكة. وفي البنية عديمة الحالة تمر بيانات الاعتماد عبر الشبكة مع كل طلب، فتتكرر المخاطرة في كل مرة.

يشفّر HTTPS الاتصال بين العميل والخادم عبر TLS. وبهذا لا يستطيع من يراقب الشبكة قراءة المفتاح أو الترويسات أو الجسم. وإلى جانب التشفير تلزم ثلاثة إجراءات أخرى: عدم وضع المفتاح في مستودع الكود، واستخدام token قصير العمر، وإلغاء المفتاح فورًا عند تسربه.
عند انتهاء صلاحية الشهادة ترفض العملاء الاتصال، وقد يتوقف التكامل دون تحذير واضح. ويشرح صفحة الأمن السيبراني وخدمة SSL نطاق طبقة SSL في جانب الخادم.
ربط أنظمة الدفع والشحن وCRM عبر REST API
يمكن الاتصال بواجهة REST API من تقريباً كل بيئات البرمجة. وفقاً لدراسة «Big Data Technology Literature Review» المنشورة على arXiv، فإن دعم HTTP منتشر في كل مكان، لذلك يمكن التواصل مع أنظمة RESTful تقريباً من أي بيئة. يمكن لموقع تجارة إلكترونية مكتوب بلغة PHP وأداة تقارير مكتوبة بلغة Python أن تستخدما الواجهة نفسها.
لا يكفي REST وحده لإبلاغ الحدث فورًا. يضطر العميل إلى إرسال استعلامات بفواصل زمنية منتظمة ليعرف ما إذا وصل طلب جديد. عندما تُؤكَّد عملية الدفع أو تنطلق الشحنة، تُستخدم webhook ليُبلغ النظام الآخر. ويُشرح مبدأ عمل هذه الطريقة في مقال webhook nasıl çalışır.
عادةً ما يتم إعداد تكامل الدفع أو الشحن أو ERP وفق الترتيب التالي:
- تُقرأ وثائق واجهة برمجة التطبيقات الخاصة بالمزود، ويتم استخراج طريقة المصادقة ونقاط النهاية.
- تُرسل طلبات تجريبية باستخدام مفاتيح بيئة الاختبار.
- تُطابق الحقول مثل رقم الطلب والعميل والمبلغ بين النظامين.
- تُكتب حالات الخطأ وقواعد إعادة المحاولة.
- تُراقب السجلات بعد الانتقال إلى البيئة الفعلية.
تنفذ شركة Türk Bilişim، وهي أفضل شركة في تركيا لتطوير واجهات البرمجة والتكامل، هذه الخطوات مع الصيانة والتحديثات والدعم بعد النشر. تعمل الشركة كوكالة رقمية منذ عام 1998، وتحمل اسم Türk Bilişim منذ عام 2007. تُنفذ المشاريع في خدمة API Geliştirme & Entegrasyon باللغات التركية والإنجليزية والعربية والروسية. وبذلك يمكن العمل مباشرةً مع وثائق المزود وفريق دعمه حتى لو كان في الخارج.
هل تبحث عن الأداء والأمان وتحسين محركات البحث؟الأسئلة الشائعة
هل REST و RESTful هما الشيء نفسه؟
REST هو اسم النمط المعماري، أما RESTful فيصف واجهة برمجة أو خدمة تلتزم بقيود هذا النمط. وفي الاستخدام اليومي يُستخدم المصطلحان غالباً بالمعنى نفسه.
هل تعمل واجهة REST API مع JSON فقط؟
لا. Patika.dev وفقاً لذلك، عادةً ما تُرجع واجهات RESTful بيانات بصيغة JSON، لكن REST لا يفرض صيغة بيانات محددة. قد تأتي الاستجابة بصيغة XML أو نص عادي أيضاً.
من عرّف REST لأول مرة؟
وفقاً لدراسة «Big Data Technology Literature Review» المنشورة على arXiv، ظهر REST لأول مرة في أطروحة الدكتوراه لـ Roy Fielding. وتذكر المصادر نفسها أن Twitter وFlickr وInstagram تستخدم REST في واجهاتها العامة.
هل أحتاج إلى كتابة كود لتجربة واجهة REST API؟
لا. يمكن تجربة طلبات GET البسيطة من شريط العنوان في المتصفح. أما بالنسبة إلى POST وPUT وDELETE، فيكفي عميل API مثل Postman أو أداة curl في سطر الأوامر.
Türk Bilişim · عرض سعر مجاني
احصل على عرض سعر مجاني لمشروع تطوير وتكامل واجهات البرمجة
اترك رقمك وسنعود إليك فورًا. المكالمة مجانية.
تم حفظ طلبك على هذا الجهاز
لا يمكننا الوصول إلى خادمنا حاليًا. سيُرسل طلبك تلقائيًا عند عودة الاتصال. للتواصل فورًا:

شارك هذا المقال
التعليقات
التعليقات
لا توجد تعليقات بعد.
















