عطرنا

الأخطاء

شكل رسائل الخطأ ورموز HTTP في واجهة عطرنا البرمجية، وما تفعله عند كل واحد.

كل خطأ يأتي بالشكل نفسه، ومعه request_id — أرسله لنا عند السؤال عن طلب.

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

الطلبات التي تعيد خطأ لا تخصم رصيداً.

مفتاحك الأول في دقيقتين

سجّل الدخول بحساب عطرنا، أنشئ مفتاح اختبار، وأرسل أول طلب.