خطاها
شکل پایدار پاسخ خطا و راه recovery برای clientها.
شکل پاسخ
JSON
{
"error": {
"code": "invalid_query",
"message": "limit must be an integer between 1 and 100.",
"requestId": "..."
}
}معنای فیلدها
codeشناسهٔ پایدار برای منطق client.messageتوضیح قابل خواندن برای انسان.requestIdبرای پشتیبانی و trace کردن درخواست.موارد شناخته‌شده
| Status | Code | رفتار پیشنهادی |
|---|---|---|
| 400 | invalid_query | پارامتر را اصلاح کنید؛ retry بدون تغییر نتیجه نمی‌دهد. |
| 404 | not_found | resource وجود ندارد یا برای caller قابل مشاهده نیست. |
| 405 | method_not_allowed | v1 فقط GET و OPTIONS را می‌پذیرد. |
| 503 | private_access_not_configured | دسترسی private در runtime آماده نیست؛ با owner/operator هماهنگ کنید. |