Эхлэх

Алдаа

Ямар нэг зүйл буруу болбол 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 алдааны дараа давтана уу. Бусад алдаа нь хүсэлт эсвэл түлхүүрт засвар шаарддаг.