التعامل مع أخطاء واجهة برمجة التطبيقات وإعادة المحاولة

، يوفر OAuth error.code، ويمكن أن تعيد مسارات Console error و error_description, المعنى النموذجي code, message و data.status.

الحالة	الاسترداد	200 مع كائن خطأ
نتيجة عدم توفر الجهاز في نقطة نهاية الدردشة الحالية.	افحص error.code ولا تعرضه كإجابة مساعد.	طلب غير صالح أو منحة OAuth.
400	صحح النص، المعلمات، الاستدعاء أو الكود المنتهي/المستهلك.	صحح النص الأساسي، المعلمات، الاستدعاء أو الكود المنتهي/المستهلك.
401	المصادقة مفقودة، منتهية الصلاحية أو غير صالحة.	تحقق من بيانات الاعتماد؛ قم بتحديث تصريح OAuth صالح فقط.
402	رصيد غير كافٍ أو رصيد غير متاح.	تحقق من رصيد الحساب المحدد قبل المحاولة مرة أخرى.
403	نطاق، ملكية، دور أو رفض حالة التمكين.	تحقق من حدود الإذن الموثقة.
404	مورد غير معروف أو مسار بوابة غير مدعوم.	تحقق من المضيف، المسار ومعرفات الموارد.
409	تعارض الحالة أو المراجعة.	اقرأ الحالة الحالية وأعد النظر في التغيير.
429	طلب أو حد التزامن.	احترم Retry-After واستخدم تأخيرًا محدودًا.
500 / 502 / 503	فشل توفر الخادم أو المصدر العلوي.	حافظ على المحاولات محدودة؛ احتفظ بمعرفات التشخيص.

تعامل مع الكتابة بحذر#

بالنسبة للفشل المؤقت في القراءة، انتظر مع زيادة التأخير والتذبذب، احترم Retry-After عند وجوده وتوقف بعد عدد محاولات أو ميزانية زمنية محددة. أظهر للمستخدم عندما تكون البيانات غير متوفرة بدلاً من التكرار بصمت.

رموز التحديث للاستخدام مرة واحدة#

لا تكرر تلقائيًا تحديث الأسعار، إنشاء النموذج أو أمر المشاركة عندما تكون النتيجة غير معروفة. اقرأ حالة المورد أو الأمر أولاً. استخدم Idempotency-Key فقط على النقاط النهائية التي توثق الدعم، مثل تغييرات الاتفاقية.

ما يجب تضمينه في طلب الدعم#

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

افحص دائمًا حالة HTTP قبل قراءة الرد كنجاح. يمكن لخدمات ShareAI أن تعيد مغلفات خطأ مختلفة: قد يوفر الاستدلال#

قم بتضمين النقطة النهائية، حالة HTTP، رمز الخطأ، الوقت ومعرف الاستجابة/المهمة عند توفرها. قم بإزالة رؤوس التفويض، ملفات تعريف الارتباط، الأسرار العميلة، رموز الوصول، رموز التحديث ومحتويات الطلب الخاصة.