Эхлэх
Алдаа
Ямар нэг зүйл буруу болбол API тохирох HTTP статус болон error дотор code ба message агуулсан биеийг буцаана.
Програмдаа code талбарыг ашиглана уу. message нь алдаа засаж буй хүнд туслах англи текст бөгөөд өөрчлөгдөж болно.
Алдааны формат404
{
"error": {
"code": "not_found",
"message": "Item not found or you do not have access to it."
}
}Түлхүүргүй401
{
"error": {
"code": "missing_api_key",
"message": "Send your API key in the X-API-Key header or as Authorization: Bearer <key>."
}
}Алдааны кодууд
| Статус | Код | Хэзээ гардаг |
|---|---|---|
| 400 | key_in_query |
Түлхүүрийг хаягаар илгээсэн байна (api_key, apikey, key эсвэл token параметр). Түлхүүрийг толгойд илгээж, шинэ түлхүүр үүсгэнэ үү, учир нь өмнөх түлхүүр логт бичигдсэн байж болзошгүй. |
| 400 | invalid_parameter |
Параметрийн утга буруу байна, жишээ нь per_page дээд хэмжээнээс их. |
| 401 | missing_api_key |
Хүсэлтэд түлхүүр байхгүй. |
| 401 | invalid_api_key |
Түлхүүр байхгүй, хүчингүй болсон эсвэл түүний хэрэглэгч идэвхгүй болсон. |
| 404 | not_found |
Эндпоинт байхгүй, эсвэл зүйл байхгүй, эсвэл хэрэглэгчийн харах эрхгүй байгууллагад харьяалагддаг. |
| 404 | organization_not_found |
Заасан organization нь хэрэглэгч энэ төрлийн зүйлсийг харах эрхтэй байгууллага биш. |
| 405 | method_not_allowed |
API зөвхөн GET (болон HEAD) хүлээн авна. |
| 429 | rate_limited |
Хүсэлтийн хязгаарт хүрсэн. Retry-After толгойд заасан секундийг хүлээнэ үү. |
| 500 | server_error |
Дотоод алдаа. Хэсэг хугацааны дараа дахин оролдоно уу; үргэлжилсээр байвал тусламжийн багтай холбогдоно уу. |
Хэзээ дахин оролдох вэ
Ижил хүсэлтийг зөвхөн 429 (Retry-After хүлээсний дараа) эсвэл 500 алдааны дараа давтана уу. Бусад алдаа нь хүсэлт эсвэл түлхүүрт засвар шаарддаг.