الأخطاء واستكشاف المشكلات

استجابة الخطأ#

تحتوي الأخطاء على كائن error يتضمّن code وmessage وdetails وtrace. استخدم الرمز البرمجي في منطق التطبيق واحتفظ بـ trace للدعم. لا تسجّل مفتاح الوصول أو محتوى الرسائل الحسّاس.

{
  "error": {
    "code": "idempotency_key_required",
    "message": "This operation requires an Idempotency-Key.",
    "details": [],
    "trace": "<request-trace>"
  }
}

رموز الاستجابة الشائعة#

اجعل الخطوة التالية مفيدة#

احتفظ بنقطة الوصول وحالة HTTP ورمز الخطأ وtrace. عند تعارض الحالة، اقرأ المورد الحالي قبل إرسال طلب مصحّح. شارك مثالًا منزوع البيانات الحسّاسة مع الدعم، ولا ترسل مفتاحًا حقيقيًا.