Referència
Errors i límits de velocitat
Els errors REST utilitzen aquest sobre. Conserveu la sol·licitud ID d'assistència i mai registreu la vostra clau API:
Comenceu amb el codi i requestId
El codi estable indica al vostre programa què ha passat. El missatge llegible pels humans explica aquesta petició. Deseu requestId quan contacteu amb l'assistència.
{
"error": {
"code": "UNAUTHORIZED",
"message": "The API key is missing, invalid, or revoked.",
"requestId": "req_..."
}
}Corregiu els errors d'autenticació i planificació
Per a 401, comproveu que la capçalera comenci per Bearer seguit d'un espai i una clau activa. Per al 403, comproveu el pla de compte i els àmbits seleccionats quan es va crear la clau.
Corregiu els errors d'estat de càrrega
Per a 409 o 422, confirmeu que PUT s'ha acabat, que el tipus de contingut coincideix i que el recompte de bytes carregats és igual a sizeBytes. Creeu un nou treball de càrrega si el URL temporal ha caducat.
| Codi | HTTP | Significat |
|---|---|---|
| BAD_REQUEST | 400 / 409 | HTTP 400 significa que el cos de la sol·licitud no és vàlid; HTTP 409 significa que la càrrega no es pot completar en el seu estat actual. |
| UNAUTHORIZED | 401 | Falta la clau API, no és vàlida o s'ha revocat. |
| PAID_PLAN_REQUIRED | 403 | El compte no té cap pla de pagament elegible. |
| INSUFFICIENT_SCOPE | 403 | La clau API no inclou l'abast requerit. |
| NOT_FOUND | 404 | No s'ha trobat la càrrega, el fitxer o la compartició de propietat. |
| UPLOAD_NOT_READY | 409 | L'objecte penjat no està preparat per completar-se. |
| FILE_TOO_LARGE | 413 | El fitxer supera el límit de mida aplicable. |
| OBJECT_VALIDATION_FAILED | 422 | L'objecte penjat ha fallat en la validació. |
| QUOTA_EXCEEDED | 429 | La quota de càrrega s'ha esgotat. |
| RATE_LIMIT_EXCEEDED | 429 | La taxa de sol·licitud API s'ha esgotat. |
| SERVICE_UNAVAILABLE | 503 | Un servei obligatori no està disponible temporalment. |
Capçaleres de límit de velocitat
Torna-ho a provar 429 només després de Reintentar-Després. Torneu a provar els errors 503 temporals amb retrocés exponencial. No torneu a intentar automàticament les sol·licituds 400, 401 o 403 no vàlides.