Référence

Erreurs et limites de débit

Les erreurs REST utilisent cette enveloppe. Conservez la demande d'assistance ID et n'enregistrez jamais votre clé API :

Commencez par le code et requestId

Le code stable indique à votre programme ce qui s'est passé. Le message lisible par l'homme explique cette demande. Enregistrez requestId lorsque vous contactez l’assistance.

JSON error response

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

Corriger les erreurs d'authentification et de plan

Pour 401, vérifiez que l'en-tête commence par Bearer suivi d'un espace et d'une clé active. Pour 403, vérifiez le plan de compte et les scopes sélectionnés lors de la création de la clé.

Corriger les erreurs d'état de téléchargement

Pour 409 ou 422, confirmez que PUT est terminé, que le type de contenu correspond et que le nombre d'octets téléchargés est égal à sizeBytes. Créez une nouvelle tâche de téléchargement si le URL temporaire a expiré.

Code	HTTP	Signification
BAD_REQUEST	400 / 409	HTTP 400 signifie que le corps de la demande n'est pas valide ; HTTP 409 signifie que le téléchargement ne peut pas être terminé dans son état actuel.
UNAUTHORIZED	401	La clé API est manquante, non valide ou révoquée.
PAID_PLAN_REQUIRED	403	Le compte n'a pas de forfait payant éligible.
INSUFFICIENT_SCOPE	403	La clé API n'inclut pas la portée requise.
NOT_FOUND	404	Le téléchargement, le fichier ou le partage détenu est introuvable.
UPLOAD_NOT_READY	409	L'objet téléchargé n'est pas prêt à être terminé.
FILE_TOO_LARGE	413	Le fichier dépasse la limite de taille applicable.
OBJECT_VALIDATION_FAILED	422	La validation de l'objet téléchargé a échoué.
QUOTA_EXCEEDED	429	Le quota de téléchargement est épuisé.
RATE_LIMIT_EXCEEDED	429	Le taux de requêtes API est épuisé.
SERVICE_UNAVAILABLE	503	Un service requis est temporairement indisponible.

En-têtes de limite de débit

Réessayez 429 seulement après Retry-After. Réessayez les erreurs 503 temporaires avec une interruption exponentielle. Ne réessayez pas automatiquement les demandes 400, 401 ou 403 non valides.