المتاجر · توثيق الـ API
البداية

الأخطاء

الأخطاء بترجع بكود HTTP حقيقي وبشكل JSON واحد:

{ "status": "error", "code": "not_found", "message": "Order not found." }

أخطاء التحقق بتضيف الحقول:

{ "message": "The status field is required.", "code": "validation_failed", "errors": { "status": ["The status field is required."] } }
الكود code إمتى
400 error الطلب مينفعش يتنفّذ بالشكل ده.
401 unauthenticated المفتاح ناقص أو غلط أو ملغي.
403 insufficient_scope المفتاح مالوش الصلاحية المطلوبة.
404 not_found السجل مش موجود في المتجر ده.
409 order_not_open … حالة السجل مش بتسمح.
422 validation_failed حقل ناقص أو غلط — شوف errors.
429 rate_limited عدّيت الحد — استنى Retry-After ثانية.
5xx — مشكلة عندنا. جرّب تاني بعد شوية.