Viite

Virheet ja nopeusrajat

REST -virheet käyttävät tätä kirjekuorta. Säilytä tukipyyntö ID äläkä koskaan kirjaa API-avainta:

Aloita koodilla ja requestId

Vakaa koodi kertoo ohjelmallesi, mitä tapahtui. Ihmisen luettava viesti selittää tämän pyynnön. Tallenna requestId, kun otat yhteyttä tukeen.

JSON error response

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

Korjaa todennus- ja suunnitteluvirheet.

Tarkista 401:n osalta, että otsikon alussa on Bearer, jota seuraa yksi välilyönti ja aktiivinen avain. Tarkista 403:n tilisuunnitelma ja avaimen luomisen yhteydessä valitut laajuudet.

Korjaa lataustilan virheet

Jos kyseessä on 409 tai 422, varmista, että PUT on valmis, sisältötyyppi täsmää ja ladattu tavumäärä on yhtä suuri kuin sizeBytes. Luo uusi lähetystyö, jos väliaikainen URL on vanhentunut.

Koodi	HTTP	Merkitys
BAD_REQUEST	400 / 409	HTTP 400 tarkoittaa, että pyynnön runko on virheellinen; HTTP 409 tarkoittaa, että latausta ei voida suorittaa loppuun sen nykyisessä tilassa.
UNAUTHORIZED	401	API-avain puuttuu, on virheellinen tai peruutettu.
PAID_PLAN_REQUIRED	403	Tilillä ei ole kelvollista maksullista suunnitelmaa.
INSUFFICIENT_SCOPE	403	API-avain ei sisällä vaadittua kiiltoa.
NOT_FOUND	404	Omistettua latausta, tiedostoa tai jaettua sisältöä ei löytynyt.
UPLOAD_NOT_READY	409	Ladattu objekti ei ole valmis viimeisteltäväksi.
FILE_TOO_LARGE	413	Tiedosto ylittää sovellettavan kokorajoituksen.
OBJECT_VALIDATION_FAILED	422	Ladatun objektin vahvistus epäonnistui.
QUOTA_EXCEEDED	429	Latauskiintiö on käytetty loppuun.
RATE_LIMIT_EXCEEDED	429	API-pyyntönopeus on käytetty loppuun.
SERVICE_UNAVAILABLE	503	Vaadittu palvelu on tilapäisesti poissa käytöstä.

Rate-limit otsikot

Yritä uudelleen 429 vain Yritä uudelleen jälkeen. Yritä uudelleen väliaikaisia 503-virheitä eksponentiaalisella peruutuksella. Älä yritä automaattisesti uudelleen virheellisiä 400-, 401- tai 403-pyyntöjä.