تخطَّ إلى المحتوى الرئيسي

ما رموز حالة HTTP التي تُعاد؟

يحمل كل خطأ رمز حالة HTTP ورمز خطأ ثابتًا. اعتمد في منطقك على الرمز، لا على الرسالة.

تتضمن كل استجابة خطأ رمز خطأ ورسالة مكتوبة ليقرأها شخص. والرموز هي:

  • 400 invalid_parameter: معامل غير معروف أو غير سليم الصيغة أو خارج النطاق المسموح
  • 400 invalid_cursor: المؤشر غير سليم الصيغة أو منتهي الصلاحية أو صادر لمفتاح آخر أو لعوامل تصفية أخرى
  • 401 unauthenticated: لم يُرسَل أي مفتاح، أو أنه غير معروف أو أُلغي
  • 403 أحد الرموز ip_not_allowed أو key_paused أو country_not_entitled أو upgrade_required: للاطلاع على التفاصيل، راجع المقالة «لماذا أتلقى الخطأ 403؟»
  • 404 not_found: المسار غير موجود
  • 405 method_not_allowed: كل نقاط النهاية تستخدم GET
  • 429 أحد الرمزين rate_limited أو quota_exceeded: انتظر انقضاء المدة المحدّدة في الترويسة Retry-After
  • 500 internal_error: أعد المحاولة في وقت لاحق
  • 503 أحد الرمزين not_configured أو service_unavailable: أعد المحاولة في وقت لاحق

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

أما زلت بحاجة إلى مساعدة؟

إذا لم يُجب هذا عن سؤالك، فتواصل معنا وسنساعدك.

التواصل مع الدعم