Currixa.
اطلب عرضًا

الأخطاء

كل فشل استجابة Problem موحّدة برمز ثابت ومعرّف طلب.

أقسام الوثائق

الشكل

ستة حقول دائمًا: النوع، الرمز، الحالة، التفصيل، المورد، ومعرّف الطلب.

{
  "type": "urn:currixa:problem:version-ambiguous",
  "title": "VERSION_AMBIGUOUS",
  "status": 400,
  "detail": "The requested version matches more than one knowledge version.",
  "instance": "/v1/outcomes/crx_out_…",
  "request_id": "req_…"
}

لا تُعرض تتبّعات المكدّس ولا SQL ولا مسارات داخلية ولا أسرار — في أي بيئة.

الرموز

كل رموز العقد (29)
الرمزالحالةالمعنى
UNAUTHENTICATED401لا توكن صالح أو منتهي.
FORBIDDEN_SCOPE403النطاق أو الإذن لا يغطي العملية.
PUBLISH_NOT_AUTHORIZED403عملية نشر دون صلاحية.
MFA_REQUIRED403العملية تتطلب جلسة بعامل ثانٍ.
NOT_FOUND404المورد غير موجود أو خارج مستأجرك (404 دائمًا، لا 403).
CONFLICT409تعارض حالة.
VERSION_AMBIGUOUS400طلب النسخة يطابق أكثر من نسخة — حدّد الرقم الكامل.
VALIDATION_FAILED422جسم أو معاملات مرفوضة.
RATE_LIMITED429تجاوزت الحد — أعد المحاولة بعد Retry-After.
SIGNUP_DISABLED403التسجيل الذاتي مُوقَف.
BOT_CHECK_FAILED403فشل فحص الروبوتات عند التسجيل.
INVALID_INPUT422حقل من حقول التسجيل مرفوض.
IDP_SYNC_PENDING502الجهة أُنشئت، ومزوّد الهوية لم يُحدَّث بعد. أعد الطلب نفسه.
KEYS_DISABLED403مفاتيح الـ API غير متاحة هنا: معطّلة في هذا النشر، أو يدير المشغّل عملاء جهتك.
LIMIT_REACHED409بلغت حدًّا من خطة الجهة: عدد التطبيقات، أو المفاتيح الفعّالة في التطبيق.
QUOTA_EXCEEDED429استهلكت الجهة طلبات خطتها لهذا الشهر، لمفاتيح LIVE وعملاء M2M. أعد المحاولة بعد Retry-After، أو رقِّ الخطة. كل رد محسوب يحمل رؤوس Currixa-Quota.
SUBSCRIPTION_INACTIVE403اشتراك الجهة موقوف أو ملغى أو انتهت تجربته. تُرفض مفاتيحها وعملاؤها، ويبقى أشخاصها قادرين على الدخول.
SETTING_NOT_DECIDED409إعداد منصّي لم يُقبل قراره بعد، فلا تُكتب قيمته.
BILLING_INCOMPLETE409لا تصدر فاتورة إلا بعد اكتمال إعدادات البائع وبيانات فوترة الجهة: الاسم القانوني، والعنوان، والمدينة، والبلد.
INVOICE_IMMUTABLE409الفاتورة الصادرة لا تتغير إلا بدفعها أو إلغائها، وتُصحَّح بإشعار دائن.
WEBHOOK_URL_REFUSED422عنوان webhook ترفضه قواعد التسليم؛ والرد يذكر صنف السبب وحده.
WEBHOOKS_DISABLED503الـ webhooks غير متاحة في هذا النشر.
INVITATION_INVALID404الدعوة غير معروفة أو منتهية أو ملغاة أو مستخدمة.
INVITATION_EMAIL_MISMATCH403البريد الذي دخلت به ليس البريد الذي أُرسلت إليه الدعوة.
LAST_OWNER409التغيير يترك الجهة بلا مالك.
SECRETS_UNAVAILABLE503مخزن الأسرار غير متاح في هذا النشر (لإدارة المنصة وحدها).
SUPPORT_UNAVAILABLE503نموذج التواصل مغلق هنا؛ راسلنا بالبريد بدلًا منه.
MFA_ALREADY_ENROLLED409تطبيق المصادقة مسجّل بالفعل؛ أوقفه قبل تسجيل غيره.
INTERNAL500عطل داخلي بلا تفاصيل مسرّبة.

التتبع

كل استجابة تحمل x-request-id. اذكره عند التواصل — به وحده نجد طلبك في السجلات.