Referencia

Hibák és sebességkorlátok

A REST hibák ezt a borítékot használják. Tartsa meg a támogatási kérelem azonosítóját, és soha ne naplózza API-kulcsát:

Kezdje a kóddal és a requestId-vel

A stabil kód elmondja a programnak, hogy mi történt. Az ember által olvasható üzenet magyarázza ezt a kérést. Mentse el az requestId-t, amikor kapcsolatba lép az ügyfélszolgálattal.

JSON error response

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

Hitelesítési és tervhibák javítása

401 esetén ellenőrizze, hogy a fejléc a Bearer-rel kezdődik-e, amelyet egy szóköz és egy aktív kulcs követ. 403 esetén ellenőrizze a fióktervet és a kulcs létrehozásakor kiválasztott hatóköröket.

Javítsa ki a feltöltési állapot hibáit

409 vagy 422 esetén ellenőrizze, hogy a PUT befejeződött, a Content-Type egyezik, és a feltöltött bájtok száma megegyezik a sizeBytes-al. Hozzon létre egy új feltöltési feladatot, ha az ideiglenes URL lejárt.

Kód	HTTP	Jelentése
BAD_REQUEST	400 / 409	A HTTP 400 azt jelenti, hogy a kérés törzse érvénytelen; A HTTP 409 azt jelenti, hogy a feltöltés nem fejezhető be jelenlegi állapotában.
UNAUTHORIZED	401	Az API-kulcs hiányzik, érvénytelen vagy visszavonva.
PAID_PLAN_REQUIRED	403	A fiók nem rendelkezik jogosult fizetett előfizetéssel.
INSUFFICIENT_SCOPE	403	Az API-kulcs nem tartalmazza a szükséges hatókört.
NOT_FOUND	404	A tulajdonban lévő feltöltés, fájl vagy megosztás nem található.
UPLOAD_NOT_READY	409	A feltöltött objektum nem áll készen a befejezésre.
FILE_TOO_LARGE	413	A fájl meghaladja a vonatkozó méretkorlátot.
OBJECT_VALIDATION_FAILED	422	A feltöltött objektum ellenőrzése sikertelen.
QUOTA_EXCEEDED	429	A feltöltési kvóta kimerült.
RATE_LIMIT_EXCEEDED	429	Az API kérési aránya kimerült.
SERVICE_UNAVAILABLE	503	Egy szükséges szolgáltatás átmenetileg nem érhető el.

Rate-limit fejlécek

429 újrapróbálkozás csak a Retry-After után. Próbálja újra az ideiglenes 503-as hibákat exponenciális visszalépéssel. Ne próbálja meg automatikusan újra az érvénytelen 400-as, 401-es vagy 403-as kéréseket.