خطاهای API و تلاشهای مجدد را مدیریت کنید
خطاهای احراز هویت، محدوده، دسترسی به مدل و دسترسی ShareAI را بدون نوشتنهای تکراری یا تلاشهای تازهسازی ناامن تشخیص دهید.
در این صفحه
همیشه وضعیت HTTP را قبل از خواندن پاسخ بهعنوان موفقیت بررسی کنید. خدمات ShareAI میتوانند پاکتهای خطای مختلفی بازگردانند: استنتاج ممکن است ارائه دهد error.code، OAuth ارائه میدهد error و error_description، و مسیرهای کنسول میتوانند بازگردانند code, message و data.status.
| وضعیت | معنای معمولی | بازیابی |
|---|---|---|
| ۲۰۰ با یک شیء خطا | نتیجه عدم دسترسی به دستگاه در نقطه پایانی چت فعلی. | خطا.code را بررسی کنید و آن را بهعنوان پاسخ دستیار نمایش ندهید. |
| 400 | درخواست نامعتبر یا اعطای مجوز OAuth. | اصلاح بدنه، پارامترها، callback یا کد منقضی/مصرفشده. |
| 401 | احراز هویت گمشده، منقضی یا نامعتبر. | اعتبارنامه را بررسی کنید؛ فقط یک مجوز معتبر OAuth را تازهسازی کنید. |
| 402 | اعتبار یا موجودی قابلاستفاده ناکافی. | موجودی حساب انتخابشده را قبل از تلاش مجدد بررسی کنید. |
| 403 | انکار محدوده، مالکیت، نقش یا وضعیت فعالشده. | مرز مجوز مستندشده را بررسی کنید. |
| 404 | منبع ناشناخته یا مسیر دروازه پشتیبانینشده. | میزبان، مسیر و شناسههای منبع را بررسی کنید. |
| 409 | تضاد وضعیت یا بازنگری. | وضعیت فعلی را بخوانید و تغییر را مجدداً بررسی کنید. |
| 429 | محدودیت درخواست یا همزمانی. | Retry-After را رعایت کنید و از یک backoff محدود استفاده کنید. |
| 500 / 502 / 503 | خرابی دسترسی سرور یا بالادستی. | تلاشهای مجدد را محدود نگه دارید؛ شناسههای تشخیصی را حفظ کنید. |
خواندنها را با محدودیت دوباره امتحان کنید#
برای خرابیهای موقت در خواندنها، با تأخیر و جِیتر افزایشی منتظر بمانید، Retry-After را در صورت وجود رعایت کنید و پس از تعداد تلاش یا بودجه زمانی تعریفشده متوقف شوید. زمانی که دادهها در دسترس نیستند، به جای حلقه زدن بیصدا، به کاربر اطلاع دهید.
نوشتنها را با دقت مدیریت کنید#
بهطور خودکار بهروزرسانی قیمت، ایجاد مدل یا فرمان اشتراکگذاری را زمانی که نتیجه نامشخص است تکرار نکنید. ابتدا وضعیت منبع یا فرمان را بخوانید. فقط در نقاط پایانی که پشتیبانی مستند دارند، مانند تغییرات توافق، از Idempotency-Key استفاده کنید.
توکنهای تازهسازی یکبار مصرف هستند#
تازهسازی چرخش نیاز به قفل مجوز در بکاند شما دارد. تلاش مجدد کورکورانه برای یک توکن تازهسازی مصرفشده میتواند مجوز را لغو کند. مشاهده کنید تازهسازی امن توکن.
چه چیزی را در درخواست پشتیبانی شامل کنید#
در صورت امکان، نقطه پایانی، وضعیت HTTP، کد خطا، زمان و شناسه پاسخ/وظیفه را شامل کنید. هدرهای Authorization، کوکیها، کلیدهای محرمانه مشتری، توکنهای دسترسی، توکنهای تازهسازی و محتوای خصوصی درخواست را حذف کنید.
آخرین بهروزرسانی سپتامبر 15, 2026