Referință

Erori și limite de rată

Erorile REST folosesc acest plic. Păstrați ID-ul solicitării pentru asistență și nu vă înregistrați niciodată cheia API:

Începeți cu cod și requestId

Codul stabil spune programului dumneavoastră ce sa întâmplat. Mesajul care poate fi citit de om explică această solicitare. Salvați requestId când contactați asistența.

JSON error response

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

Remediați erorile de autentificare și de planificare

Pentru 401, verificați dacă antetul începe cu Bearer urmat de un spațiu și o cheie activă. Pentru 403, verificați planul de cont și domeniile selectate când a fost creată cheia.

Remediați erorile de stare de încărcare

Pentru 409 sau 422, confirmați PUT terminat, tipul de conținut se potrivește și numărul de octeți încărcat este egal cu sizeBytes. Creați o nouă sarcină de încărcare dacă URL temporar a expirat.

Cod	HTTP	Înțeles
BAD_REQUEST	400 / 409	HTTP 400 înseamnă că corpul cererii este invalid; HTTP 409 înseamnă că încărcarea nu poate fi finalizată în starea sa actuală.
UNAUTHORIZED	401	Cheia API lipsește, este nevalidă sau este revocată.
PAID_PLAN_REQUIRED	403	Contul nu are un plan plătit eligibil.
INSUFFICIENT_SCOPE	403	Cheia API nu include domeniul necesar.
NOT_FOUND	404	Încărcarea, fișierul sau distribuirea deținute nu au fost găsite.
UPLOAD_NOT_READY	409	Obiectul încărcat nu este gata de finalizare.
FILE_TOO_LARGE	413	Fișierul depășește limita de dimensiune aplicabilă.
OBJECT_VALIDATION_FAILED	422	Obiectul încărcat nu a reușit validarea.
QUOTA_EXCEEDED	429	Cota de încărcare este epuizată.
RATE_LIMIT_EXCEEDED	429	Rata de solicitare API este epuizată.
SERVICE_UNAVAILABLE	503	Un serviciu necesar este temporar indisponibil.

Antete pentru limita de rată

Reîncercați 429 numai după Retry-After. Reîncercați erori temporare 503 cu retragere exponențială. Nu reîncercați automat solicitările 400, 401 sau 403 nevalide.