مستندات Genesis API
هرچه برای یکپارچهسازی لازم است: احراز هویت، محدودیتها، اندپوینتها و اسکیمای پاسخ.
مستنداتخطاها
خطاها
خطاها با وضعیت HTTP متناظر و یک بدنه برمیگردند:
json
{
"success": false,
"error": {
"code": "rate_limited",
"message": "Requests per second limit exceeded."
}
}| HTTP | کد | توضیح |
|---|---|---|
400 | bad_request | پارامترهای درخواست نامعتبر است — جزئیات در message |
401 | invalid_key | کلید غایب، نامعتبر یا لغوشده، یا اشتراک API منقضی شده است |
403 | plan_restricted | اندپوینت در پلن شما نیست |
404 | not_found | اندپوینت یا منبع پیدا نشد |
410 | gone | اندپوینت بازنشسته شده است — جایگزین در message |
429 | rate_limited | عبور از محدودیت — X-RateLimit و Retry-After را ببینید |
429 | download_limited | حجم دانلود از حد مجاز گذشته است: 60 MB داده فشرده در هر 10 ثانیه برای هر کلید — Retry-After را ببینید |
500 | internal_error | خطای داخلی، بعداً دوباره تلاش کنید |
503 | snapshot_not_ready | دادهها در حال بازسازی است یا منبع آن در حال راهاندازی مجدد است — چند ثانیه بعد دوباره تلاش کنید، Retry-After را ببینید |
هر پاسخ هدر X-Request-Id دارد. هنگام تماس با پشتیبانی آن را همراه زمان درخواست به UTC، اندپوینت و وضعیت بفرستید — هرگز کلید خود را نفرستید.