رموز الاستجابة

محتويات الصفحة

    قد نحصل على استجابات HTTP مختلفة عند التعامل مع الواجهة البرمجية لزيتون، وسنستعرض في هذا المقال أهم رموز الاستجابة ودلالتها.

    رموز النجاح 2xx

    تشير الرموز 2xx إلى قبول الطلب الذي أرسلت الوكيل ومعالجته بنجاح، على سبيل المثال يدل الرمز 200 على نجاح طلبات GET، والرمز 201 على نجاح طلبات POST.

    رموز أخطاء جانب العميل 4xx

    تشير الرموز 4xx إلى وجود خطأ في الطلب المرسل من قبل العميل، وقد يقع نتيجة عدة أسباب تتعلق ببنية الطلب نفسه، أو بمفتاح الواجهة البرمجية API Key.

    ومن أهم رموز أخطاء 4xx نذكر:

    400 Bad Request

    طلب غير صحيح، بسبب وجود مشكلة في الترويسة، أو معاملات ناقصة، أو مهيأة بقيم غير صالحة

    Unauthorized 401

    مشكلة في الاستيثاق، بسبب مفتاح API Key خاطئ، أو رمز وصول Access Token خاطئ، أو بيانات دخول غير صحيحة.

    402 Request Failed

    فشل الطلب رغم صحة المعاملات المُقدمة لسبب ما كخطأ داخلي في الخادم، أو وجود مشكلة في الاتصال

    403 Forbidden

    الطلب صحيح، لكن الوكيل لا يملك صلاحية للوصول له وتنفيذه

    404 Not Found

    لا يمكن الوصول للمورد المطلوب، بسبب استخدام عنوان URL خاطئ، أو نقله أو حذفه

    409 Conflict

    وجود تعارض بين الطلب المرسل وطلب آخر قيد المعالجة، كمحاولة تغيير نفس البيانات بنفس اللحظة

    429 Too Many Requests

    إرسال عدد طلبات كثيرة جدًا إلى الواجهة خلال فترة زمنية معينة

    رموز أخطاء جانب الخادم 5xx

    تشير الرموز 5xx مثل 500 و 502 و 503 و 504 إلى وجود خطأ ما في الخادم نفسه أو في طريقة معالجة الطلبات، ولا علاقة لها بالطلب المرسل للواجهة البرمجية. وهذا النوع من الأخطاء نادر الحدوث ومؤقت.

    محتويات الصفحة