Requests وResponses: كيف يجري الحوار؟

كل تكامل عبر الويب هو حوار من رسالتين: طلب (Request) تُرسله، واستجابة (Response) تعود إليك. الطلب يتكوّن من: - العنوان (URL) ووظيفته المقصودة. - الفعل (GET للقراءة، POST للإنشاء، PUT/PATCH للتعديل، DELETE للحذف). - الترويسات (Headers): بيانات مصاحبة كالمصادقة ونوع المحتوى. - المعاملات (Query Params): مرشّحات مثل ?limit=10. - الجسم (Body): البيانات المرسلة، عادةً JSON، ويُستخدم مع POST/PUT. الاستجابة تتكوّن من: - رمز الحالة (Status Code) وهو أسرع طريقة لفهم ما جرى: 200 نجاح، 201 أُنشئ، 400 طلبك خاطئ، 401 غير مصادق، 403 ممنوع رغم المصادقة، 404 غير موجود، 429 تجاوزت الحد، 500 خطأ لدى الخدمة. - الترويسات: معلومات مثل الحدود المتبقية. - الجسم: البيانات أو تفاصيل الخطأ. قاعدة ذهبية في التشخيص: أرقام 4xx مشكلتك أنت (طلب/مفتاح/صلاحية)، وأرقام 5xx مشكلة الطرف الآخر (تُعالَج بإعادة محاولة ذكية لا بتغيير الكود). وفي التكاملات مع الذكاء الاصطناعي، أضف بُعداً ثالثاً: الزمن. استدعاء النموذج أبطأ من استدعاء قاعدة بيانات بمراتب، لذا صمّم التكامل ليعمل بشكل غير متزامن حين يكون الانتظار طويلاً.