انتقل إلى المحتوى
GiftUdevelopers
الأدلةمرجع APIv1.0.1

ابدأ التكامل / GiftU Partner API

الأخطاء وحدود الطلبات

استخدم حالة HTTP مع error.code، واحتفظ بـrequestId ليتمكن فريق قيفتو من تتبع الطلب.

الأخطاء الشائعة

400 / 6205 — مدخلات غير صحيحة. 401 / 6200 — فشل المصادقة. 404 / 6207 — منتج غير متاح. 404 / 6211 — الطلب غير موجود. 404 / 6216 — كشف الحساب غير موجود. الموارد خارج نطاق الشريك أو البيئة تعطي النتيجة نفسها للموارد غير الموجودة.

409 / 6209 — رصيد مسبق الدفع غير كافٍ. 409 / 6210 — تجاوز حد الائتمان. 409 / 6220 — استخدام المرجع مع محتوى شراء مختلف. 503 / 6206 — الكتالوج غير متاح مؤقتاً. 503 / 6201 — الشراء الجديد معطّل. 500 / 6227 — خطأ غير متوقع.

التزم بحدود الطلبات

تتضمن HTTP 429 والرمز 6218 ترويسة Retry-After بالثواني. انتظر هذه المدة على الأقل قبل إعادة المحاولة، وزد التأخير تدريجياً مع تفاوت عشوائي. قد تطبق الحدود على IP وعلى طلبات الشريك، وتختلف الحصة حسب البيئة.

أعد المحاولة بهوية الشراء نفسها

عالج أخطاء التحقق والمصادقة قبل إعادة الإرسال. عند غموض نتيجة الشراء، طابق الطلب باستخدام partnerReference الحالي واحتفظ بالمحتوى نفسه لكل محاولة. لا تغير المرجع لمجرد تجاوز الخطأ.

تحتاج مساعدة في التكامل؟تواصل مع فريق قيفتو