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
