الأخطاء
شكل رسائل الخطأ ورموز HTTP في واجهة عطرنا البرمجية، وما تفعله عند كل واحد.
كل خطأ يأتي بالشكل نفسه، ومعه request_id — أرسله لنا عند السؤال عن طلب.
JSON
{
"error": {
"code": "insufficient_credits",
"message": "No credits left on this account. Top up or upgrade.",
"request_id": "req_41ab…"
}
}| HTTP | code | المعنى |
|---|---|---|
400 | bad_request | معامل ناقص أو غير صالح |
401 | unauthorized | مفتاح مفقود أو خاطئ أو ملغى |
402 | insufficient_credits | نفد الرصيد: اشحن أو رقِّ الخطة |
403 | forbidden_scope | خارج صلاحيات المفتاح أو من IP/نطاق غير مسموح |
404 | not_found | العطر أو المورد غير موجود |
413 | payload_too_large | الصورة أكبر من 10 ميغابايت |
415 | unsupported_media_type | ليست JPEG أو PNG أو WebP |
429 | rate_limited | تجاوزت حد السرعة: انتظر Retry-After |
503 | unavailable | الخدمة مشغولة مؤقتاً: أعد المحاولة |
الطلبات التي تعيد خطأ لا تخصم رصيداً.