Démarrer

Erreurs

Une erreur porte toujours un code stable, à tester dans un programme, un message qui dit ce qui ne va pas et un hint qui dit comment corriger.

Code Statut Signification
not_found 404 L'adresse appelée n'existe pas.
method_not_allowed 405 L'adresse existe, mais pas avec cette méthode HTTP. L'en-tête Allow liste les méthodes acceptées.
resource_not_found 404 L'élément demandé n'existe pas sur le compte lié à la clé.
https_required 400 L'appel a été fait en HTTP simple. Seul HTTPS est accepté.
key_in_url 400 Une clé a été placée dans l'URL. Elle doit être envoyée dans l'en-tête Authorization, et la clé exposée doit être révoquée.
api_disabled 503 L'API est momentanément indisponible. Réessayer plus tard.
too_many_failed_attempts 429 Trop d'appels avec une clé invalide depuis la même adresse IP. Attendre le délai indiqué par Retry-After.
missing_key 401 Aucune clé n'a été fournie.
invalid_key 401 La clé est inconnue ou a été révoquée.
api_not_activated 403 L'API n'est pas activée sur le compte. Le titulaire l'active dans son compte Wanapos.
account_not_eligible 403 Le compte n'a pas d'abonnement actif.
access_blocked 403 L'accès à l'API est suspendu sur ce compte.
missing_scope 403 La clé n'a pas la permission exigée. Le champ field nomme la permission manquante.
rate_limited 429 Trop d'appels dans la minute. Attendre le délai indiqué par Retry-After, puis espacer les appels.
daily_quota_exceeded 429 Le quota journalier de lecture ou d'écriture est atteint. Il revient à zéro à minuit, heure de Paris.
body_too_large 413 Le contenu envoyé dépasse la taille maximale. Découper l'envoi en plusieurs appels.
unsupported_media_type 415 Le contenu envoyé n'est pas déclaré comme du JSON.
invalid_json 400 Le contenu envoyé n'est pas un objet JSON valide.
validation_failed 422 Des données envoyées sont invalides. Le champ details liste chaque erreur avec son champ. Rien n'a été enregistré.
invalid_parameter 422 Un paramètre de l'URL est invalide. Le champ field le nomme.
idempotency_key_required 400 Cet appel exige l'en-tête Idempotency-Key.
idempotency_key_invalid 400 L'en-tête Idempotency-Key n'a pas la forme attendue (8 à 100 caractères : lettres, chiffres, tiret, tiret bas, point, deux-points).
idempotency_key_reused 422 Cet Idempotency-Key a déjà servi pour une requête différente. Utiliser un nouvel identifiant par nouvelle requête.
request_in_progress 409 Une requête portant le même Idempotency-Key est en cours de traitement. Réessayer dans quelques secondes avec le même identifiant.
account_busy 503 Une autre écriture est en cours sur ce compte. Rien n'a été enregistré : renvoyer la même requête après quelques secondes.
duplicate_email 409 Un client actif porte déjà cette adresse mail. L'erreur donne les identifiants existants : modifier le client existant, ou renvoyer avec ?allow_duplicate_email=true.
duplicate_barcode 409 Un autre produit porte déjà ce code-barres externe (bc_ext). L'erreur donne les identifiants des produits concernés : vérifier que le produit n'existe pas déjà, ou renvoyer avec ?allow_duplicate_bc_ext=true.
duplicate_name 409 Un fournisseur, une collection, une catégorie ou une valeur de liste porte déjà ce nom. L'erreur donne l'identifiant existant : l'utiliser au lieu de créer un doublon, ou choisir un autre nom.
points_out_of_range 409 L'ajustement ferait passer le solde de points sous 0 ou au-dessus du maximum. Le message donne le solde actuel. Rien n'a été modifié.
internal_error 500 Erreur interne. Réessayer, puis contacter l'assistance en indiquant le request_id.

Une question ? contact@wanapos.com