راهنمای خطاهای API پیکو و تصمیم برای تلاش دوباره
برای ۴۰۱، ۴۰۲، ۴۰۳، ۴۰۴، ۴۲۹ و خطاهای سرویس بدانید کدام تنظیم را بررسی کنید و چه زمانی درخواست را دوباره بفرستید.
پیکو هوشانتشار: به‌روزرسانی: ۱ دقیقه مطالعه
در یک اپ واقعی، خطای API باید به یک تصمیم مشخص برسد. در پاسخ JSON به error.code نگاه کنید و کد HTTP را هم ثبت کنید. این دو با هم کمک می‌کنند خطای اعتبار، محدودیت کلید و اختلال موقت را از هم تشخیص دهید.
| پاسخ | اقدام در برنامه |
|---|---|
400 | شکل بدنه، نوع مدل، پیام‌ها و مقدار سقف خروجی را بررسی کنید. |
401 | هدر احراز هویت و فعال‌بودن کلید پیکو را بررسی کنید. |
402 | موجودی، سهمیه یا سقف رزرو همین درخواست را بررسی کنید. |
403 | به کد خطا نگاه کنید. ممکن است سقف ماهانه، مدل‌های مجاز کلید یا شرایط مسیر اقتصادی مطرح باشد. |
404 | مسیر URL و شناسهٔ مدل را با GET /v1/models تطبیق دهید. |
429 | در صورت وجود، Retry-After را رعایت کنید. همزمانی و تعداد ارسال‌ها را کم کنید. |
502 یا 503 | وضعیت سرویس را بررسی کنید. فقط برای کاری که تکرارش قابل قبول است، با تأخیر و سقف تلاش دوباره اقدام کنید. |
وقتی مرورگر یا worker ارتباط را قطع کرد
ممکن است پس از پردازش، پاسخ به مشتری نرسیده باشد. در چنین حالتی ارسال مجدد می‌تواند درخواست تازه‌ای بسازد. در اپ خود برای هر کار شناسهٔ مستقل، وضعیت اجرا و نتیجهٔ ذخیره‌شده داشته باشید. اگر وضعیت هنوز نامشخص است، ابتدا مصرف حساب را بررسی کنید یا کار را برای بررسی در صف بگذارید.
برای عیب‌یابی، زمان، نام مدل، کد خطا و شناسهٔ کار خودتان را ذخیره کنید. هنگام تماس با پشتیبانی همین چهار مورد کافی‌اند. وضعیت سرویس · تماس با پیکو
- عیب‌یابی API
- Retry
- محدودیت نرخ