الردود على أخطاء واجهة برمجة التطبيقات
يوضّح الجدول التالي رموز الخطأ التي قد تعرضها واجهة Google Wallet API والأسباب المحتمَلة لها وحلولها.
استثناء | مثال على رسالة | الاقتراح |
---|---|---|
400 - BadRequestException | يحتوي الطلب على وسيطة غير صالحة. معرّف المورد غير صالح: {1234567891234567899 - ABCD1234567}. | تحقق من هيكل البيانات لمعرفة النوع والتنسيق والطول وتمرير الوسيطة الصحيحة. |
403 - PermissionDeniedException | تم رفض الإذن | تأكَّد من أنّ عنوان البريد الإلكتروني الصحيح لحساب الخدمة هو مستخدم مفوّض في Business Pay و"وحدة التحكّم في المحفظة". |
404 - NotFoundException | لم يتم العثور على عنصر المحفظة {1234567891234567899.عيّنةClubCardxf6a8edf-87ca-4022-a813-694cc57e9fd3}. | نفِّذ عملية GET على رقم تعريف العنصر قبل المحاولة قبل طلب PATCH أو PUT للتأكُّد من أنّ لديك عنصر تريد تعديله وأنّه هو الأحدث. |
404 - جهة إصدار المنتج فئة عدم العثور على استثناء | فئة عنصر المحفظة {1234567891234567899.ABCD.1234567} غير موجودة. | عند إجراء أي تعديل، احرِص على تنفيذ طلب GET قبل طلب PATCH أو PUT للتأكُّد من أنّه لديك صف للإشارة إلى أنّه آخر فئة. عليك التأكّد أيضًا من استخدام الحمولة الصحيحة (الكائن والفئة) في الطلب بشكل صحيح. |
409 - AlreadyExistsException | فئة عنصر المحفظة {1234567891234567899.ABCD.1234567} موجودة بالفعل. | نفِّذ عملية GET على رقم تعريف الفئة قبل محاولة إنشاء رقم تعريف الصف نفسه. في حال توفُّر المورد، قد تحتاج إلى استخدام PATCH أو PUT. |
رسائل خطأ مستندة إلى الويب
إذا حدث خطأ عند محاولة حفظ بطاقة باستخدام الرابط "الإضافة إلى محفظة Google"، ستظهر لك رسالة خطأ مفيدة لمساعدتك في تصحيح الأخطاء. لا تظهر هذه الرسائل إلا للمستخدمين الحاصلين على دور "المطوّر" أو "المشرف" في حساب "جهة الإصدار" المرتبط.
في ما يلي مثال على نوع رسالة الخطأ التي قد يتم عرضها:
![مثال لرسالة خطأ](https://developers.google.cn/static/wallet/images/web-error-message.png?authuser=2&hl=ar)