Aller au contenu principal
- Gestion des erreurs

Erreurs de l'API

Chaque échec de l'API renvoie une enveloppe d'erreur JSON avec un code stable, un statut HTTP, un message et un request id pour le support.

Enveloppe d'erreur

{
  "error": {
    "code": "asset_not_found",
    "message": "No asset with id 42 for this shop",
    "status": 404,
    "request_id": "req_..."
  }
}

Indiquez le request id lorsque vous contactez le support.

Codes d'erreur courants

HTTPCodeSignification
400invalid_requestJSON mal formé ou champ manquant.
400idempotency_key_requiredRequête d'écriture sans Idempotency-Key.
401unauthorizedJeton manquant, invalide, inconnu ou révoqué.
402plan_requiredL'accès à l'API n'a pas été activé pour la boutique.
404asset_not_found, mapping_not_found, order_not_found, category_not_found, job_not_foundLa ressource est introuvable ou appartient à une autre boutique.
409idempotency_conflictLa même clé a été réutilisée avec une requête différente.
409stamping_in_progressLe renvoi est bloqué tant que le filigranage du PDF est en attente.
409delivery_not_yet_releasedLe produit a un délai de livraison de téléchargement configuré et les fichiers de l'acheteur ne sont pas encore débloqués. error.details.release_at est l'instant ISO 8601 du déblocage ; le marchand peut libérer la commande par anticipation avec le point de terminaison grant-downloads.
422storage_quota_exceededLe téléversement ou l'import dépasserait le quota de stockage.
422key_limit_reachedLa boutique détient déjà le maximum de 25 clés d'API actives ; révoquez-en une d'abord.
422withdrawal_consent_requiredLa boutique a activé le consentement au droit de rétractation de l'UE et la commande n'a pas encore d'enregistrement de consentement ; les URL de téléchargement sont émises dès que le client consent.
429rate_limitedLa limite de clés d'API ou de renvois de commande a été atteinte.
500internal_errorErreur serveur inattendue.

Documentation de l'API

Cet article vous a-t-il été utile ?

Toujours bloqué ? Écrivez à admin@alvaapps.com.

Dernière mise à jour 2026-06-05