رسیدگی به محدودیت نرخ و خطاهای سرور

رسیدگی به پاسخ 429

درخواست محدودشده با 429 Too Many Requests برمی‌گردد و مقدار detail.status برابر rate_limit_exceeded است. پیش از تکرار درخواست، سرآیندهای پاسخ را بخوانید:

• Retry-After حداقل زمان انتظار بر حسب ثانیه را برای درخواست ردشده می‌دهد.
• X-RateLimit-Limit سقف گروه درخواست‌ها را نشان می‌دهد.
• X-RateLimit-Remaining شمار درخواست‌های باقی‌مانده را نشان می‌دهد.
• X-RateLimit-Reset زمان بازنشانی گروه را نشان می‌دهد.

تا زمان مشخص‌شده در Retry-After صبر کنید و سپس با تأخیر نمایی و کمی تغییر تصادفی دوباره تلاش کنید. تعداد درخواست‌های هم‌زمان را کم کنید و کارها را در صف بگذارید تا به‌محض بازنشانی بازه، انبوه درخواست نفرستید.

رسیدگی به خطاهای سرور

در پاسخ 500، بدنه عمومی شامل خطایی کلی و request_id است؛ جزئیات استثنای داخلی برگردانده نمی‌شود. 503 می‌تواند به معنای در دسترس نبودن موقت سرویس ضروری باشد.

درخواست‌های فقط‌خواندنی را با تأخیر محدود تکرار کنید. پیش از تکرار درخواست ساخت، به‌روزرسانی، پرداخت یا هر درخواست تغییردهنده وضعیت، روشن کنید آیا تلاش اول انجام شده است یا نه. پایان مهلت یا پاسخ 5xx ثابت نمی‌کند تغییر ناموفق بوده و تکرار فوری می‌تواند کار را دوباره انجام دهد.

نگه‌داشتن داده‌های عیب‌یابی

زمان، روش، مسیر، وضعیت، بدنه پاسخ و X-Request-Id را ثبت کنید. هرگز مقدار x-api-key را ثبت نکنید. پس از چند تلاش محدود، تکرار خودکار را متوقف کنید و خطا را برای بررسی نشان دهید.