حالات الخطأ

في حال حدوث خطأ، من المتوقّع أن تعرض "هيئة حماية البيانات" رمز حالة HTTP مع استجابة HTTP التي يجب أن تتضمّن كائن JSON مع مزيد من المعلومات حول الخطأ. يجب أن يحتوي نص استجابة الخطأ على نسخة افتراضية من ErrorResponse.

{
  "errorMessage": string,
  "cause": enum(ErrorCause)
}

يجب أن تتوافق استجابة خطأ تعديل معالجة البيانات مع ما يلي:

  • المستخدم في وضع التجوال حاليًا وإيقاف طلب تعديل معالجة البيانات لهذا المستخدم. تعرض "هيئة حماية البيانات" الخطأ 403 مع عرض USER_ROAMING باعتباره سبب الخطأ.
  • تعرض "هيئة حماية البيانات" رمز الخطأ NOT_FOUND 404 الذي يشير إلى GTAF بأن مفتاح المستخدم غير صالح (أي مفتاح المستخدم غير موجود) مع INVALID_NUMBER.
  • تعرض "هيئة حماية البيانات" رمز خطأ GONE 410 مع BAD_CPID باعتباره الخطأ الذي يشير إلى أنّ البرنامج يجب أن يحصل على مفتاح مستخدم جديد في حال كان key_type = CPID وانتهت صلاحية CPID.
  • تعرض "هيئة حماية البيانات" رمز الخطأ NOT_IMPLEMENTED 501 يشير إلى أنّه لا يتوافق مع هذه المكالمة مع سبب خطأ SERVICE_UNAVAILABLE.
  • تعرض "تعديل بنود معالجة البيانات" (DPA) 429 طلب عدد كبير جدًا من الطلبات مع ظهور خطأ TOO_MANY_OPTIONS ويظهر مع العنوان "إعادة المحاولة" الذي يشير إلى أنّ "إطار الشفافية والموافقة" يُرسل عددًا كبيرًا جدًا من الطلبات إلى "هيئة حماية البيانات".
  • تعرض "هيئة حماية البيانات" رسالة الخطأ 409 CONFLICT التي تشير إلى أنّه لا يمكن إكمال الطلب بسبب تعارض مع الحالة الراهنة لهيئة حماية البيانات.
  • الخدمة غير متاحة مؤقتًا. تعرض "تعديل بنود معالجة البيانات" خدمة 503 غير متوفّرة مع عنوان إعادة المحاولة الذي يشير إلى الوقت الذي يمكن فيه محاولة طلب جديد.
  • تعرض "هيئة حماية البيانات" رمز الخطأ 500 INTERNAL server ERROR لجميع الأخطاء الأخرى غير المحدَّدة ERROR_CAUSE_UNSPECIFIED باعتبارها سبب الخطأ.

إذا حدثت أخطاء أثناء عملية شراء، تمثّل رموز الأخطاء التالية نتائج تعذّر إتمامها:

  • تعرض "هيئة حماية البيانات" رمز الخطأ 400 BAD REQUEST الذي يشير إلى رمز AFAF بأنّ رقم تعريف الخطة التي تم شراؤها غير صالح.
  • تعرض "هيئة حماية البيانات" رمز الخطأ 402 PAYMENT مطلوب يشير إلى GTAF بأنّ المستخدم ليس لديه رصيد كافٍ لإكمال عملية الشراء.
  • تعرض "هيئة حماية البيانات" رمز خطأ CONFLICT 409 يشير إلى GTAF بأن الخطة التي سيتم شراؤها غير متوافقة مع تشكيلة المنتج الحالية للمستخدم. على سبيل المثال، إذا كانت سياسة خطة بيانات عامل التشغيل لا تسمح بخلط خطط الدفع المُسبق والخطط المسبقة الدفع، ستؤدي محاولة شراء خطة دفع مُسبَق لمستخدم دفع مُسبَق إلى حدوث خطأ 409 CONFLICT.
  • تعرض "هيئة حماية البيانات" رمز الخطأ FORFORDEN 403 الذي يشير إلى GTAF بأن المعاملة الحالية نسخة طبق الأصل من معاملة تم إصدارها سابقًا. يجب أن تعرض "تعديل بنود معالجة البيانات" الخطأ التالي للاستجابة:
    • إذا تعذّر إكمال المعاملة السابقة، يجب أن يشير الخطأ إلى سبب تعذّر إتمام المعاملة.
    • إذا تمت المعاملة السابقة بنجاح، DUPLICATE_TRANSACTION.
    • إذا كانت المعاملة السابقة لا تزال في قائمة الانتظار، يمكنك طلب REQUEST_QUEUED.