Dokumentasyon ng API v1
Filipino
Wika ng dokumentasyon Pareho sa lahat ng wika ang mga halimbawa ng code at ang mga pangalan ng field.
Buksan ang control panel

Pagsisimula

Mga error

Kapag may nagkaproblema, sumasagot ang API gamit ang katumbas na HTTP status at isang body na may code at message sa loob ng error.

Gamitin ang code sa iyong program. Ang message ay tekstong nasa Ingles para tulungan ang nagde-debug, at puwede itong magbago.

Format ng error404
{
  "error": {
    "code": "not_found",
    "message": "Item not found or you do not have access to it."
  }
}
Walang key401
{
  "error": {
    "code": "missing_api_key",
    "message": "Send your API key in the X-API-Key header or as Authorization: Bearer <key>."
  }
}

Mga code ng error

Status Code Kailan nangyayari
400 key_in_query Ipinadala ang key sa URL (mga parameter na api_key, apikey, key o token). Ipadala ito sa header at gumawa ng bagong key, dahil maaaring naitala na sa mga log ang nauna.
400 invalid_parameter May invalid na value ang isang parameter, gaya ng per_page na lampas sa maximum.
401 missing_api_key Walang key ang request.
401 invalid_api_key Hindi umiiral ang key, binawi na ito, o naka-deactivate ang user nito.
404 not_found Hindi umiiral ang endpoint, o hindi umiiral ang item o kabilang ito sa isang organisasyong hindi nakikita ng user.
404 organization_not_found Ang ibinigay na organization ay hindi isang organisasyon kung saan nakikita ng user ang ganitong uri ng item.
405 method_not_allowed GET (at HEAD) lang ang tinatanggap ng API.
429 rate_limited Naabot na ang limitasyon ng mga request. Hintayin ang mga segundong nasa Retry-After.
500 server_error Internal na error. Subukang muli maya-maya; kung magpatuloy, makipag-ugnayan sa suporta.

Kailan susubok ulit

Ulitin lang ang parehong request pagkatapos ng 429 (hintayin ang Retry-After) o ng 500. Ang ibang error ay nangangailangan ng pagwawasto sa request o sa key.