Referenca

Pogreške i ograničenja stope

REST pogreške koriste ovu omotnicu. Zadržite ID zahtjeva za podršku i nikada ne zapisujte svoj API ključ:

Počnite s kodom i ID-om zahtjeva

Stabilni kod govori vašem programu što se dogodilo. Čovjeku čitljiva poruka objašnjava ovaj zahtjev. Spremite ID zahtjeva kada kontaktirate podršku.

JSON error response

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "The API key is missing, invalid, or revoked.",
    "requestId": "req_..."
  }
}

Ispravite pogreške autentifikacije i planiranja

Za 401 provjerite počinje li zaglavlje s Bearer nakon kojeg slijedi jedan razmak i aktivni ključ. Za 403 provjerite plan računa i opsege odabrane prilikom izrade ključa.

Ispravite pogreške u stanju prijenosa

Za 409 ili 422 potvrdite da je PUT dovršen, da se Content-Type podudara i da je učitani broj bajtova jednak sizeBytes. Stvorite novi posao učitavanja ako je privremeni URL istekao.

Kodirati	HTTP	Značenje
BAD_REQUEST	400 / 409	HTTP 400 znači da tijelo zahtjeva nije valjano; HTTP 409 znači da se prijenos ne može dovršiti u trenutnom stanju.
UNAUTHORIZED	401	API ključ nedostaje, nije valjan ili je opozvan.
PAID_PLAN_REQUIRED	403	Račun nema odgovarajući plaćeni plan.
INSUFFICIENT_SCOPE	403	API ključ ne uključuje potrebni opseg.
NOT_FOUND	404	Prijenos, datoteka ili dijeljenje u vlasništvu nisu pronađeni.
UPLOAD_NOT_READY	409	Učitani objekt nije spreman za dovršetak.
FILE_TOO_LARGE	413	Datoteka premašuje primjenjivo ograničenje veličine.
OBJECT_VALIDATION_FAILED	422	Učitani objekt nije prošao provjeru valjanosti.
QUOTA_EXCEEDED	429	Kvota za učitavanje je iscrpljena.
RATE_LIMIT_EXCEEDED	429	Stopa API zahtjeva je iscrpljena.
SERVICE_UNAVAILABLE	503	Potrebna usluga je privremeno nedostupna.

Zaglavlja ograničenja brzine

Pokušaj ponovo 429 tek nakon ponovnog pokušaja. Pokušajte ponovno s privremenim pogreškama 503 s eksponencijalnim odmakom. Nemojte automatski ponovno pokušavati nevažeće 400, 401 ili 403 zahtjeve.