Vakioitu virheobjekti
JSON
{
"error": {
"code": "rate_limited",
"message": "Too many requests",
"request_id": "req_01J4N7"
}
}Luokittele ennen uudelleenyritystä
| Tila | Merkitys | Toiminta |
|---|---|---|
| 400 | Pyynnön validointi epäonnistui | Korjaa pyyntö; älä toista muuttamattomana |
| 401 | Todennus puuttuu tai on virheellinen | Korjaa tai kierrätä tunniste |
| 404 | Datasettiä, releasea tai buildia ei löytynyt | Varmenna vakaat tunnisteet |
| 429 | Nopeusraja ylittyi | Odota Retry-After ja toista satunnaisvaihtelulla |
| 500 | Tilapäinen palveluvirhe | Toista turvalliset lukupyynnöt kasvavalla odotuksella |
Käsittele metodit eri tavoin
GET-operaatiot voi toistaa tilapäisen verkkovirheen, 429:n tai 5xx:n jälkeen. POST /datasets/{dataset_id}/query on lukutyyppinen ja voidaan toistaa samalla rungolla. POST /builds luo työtä eikä sillä ole julkista v1-idempotenssiavainta, joten epäselvä tulos täytyy täsmäyttää ennen uutta lähetystä.
Säilytä häiriökonteksti
- 1Lokita request_id, kun se on saatavilla
- 2Lokita reittimalli salaisuuksien tai kokonaisten URL-osoitteiden sijaan
- 3Säilytä dataset-, release- ja build-tunnisteet
- 4Kirjaa yritysmäärä ja kulunut aika
- 5Erota pysyvät validointivirheet tilapäisistä saatavuusvirheistä