الأخطاء

بنية الخطأ:

{ "error": { "code": "...", "message": "..." }, "meta": { "request_id": "..." } }

الكود	HTTP	المعنى
unauthorized	401	رأس Authorization مفقود أو غير صالح
forbidden	403	موثَّق ولكن يفتقر إلى الصلاحية أو إلى تسجيل في البرنامج التجريبي
not_found	404	المورد غير موجود أو لا ينتمي إلى متجرك
bad_request	400	خطأ في التحقق؛ راجع message وحقل details الاختياري
method_not_allowed	405	المسار موجود لكن لطريقة HTTP أخرى
rate_limited	429	تجاوز الحد لكل دقيقة؛ يُرفق رأس Retry-After
quota_exceeded	402	تم بلوغ الحد الشهري؛ ارقَ إلى خطة أعلى أو انتظر
server_error	500	خطأ أصلي غير متوقع؛ آمن لإعادة المحاولة على النداءات الـ idempotent

أرفق meta.request_id دائمًا عند التواصل مع الدعم.