Interpréter les codes retour

En complément des informations sur les messages et les codes retour possibles consultables à l'adresse open-api, ci-dessous un tableau synthétique et général sur le sens et les suites à donner lorsque vous rencontrez un retour inattendu :

Code erreur	Description	Actions possibles
200 - 20X	Requête traitée avec succès	-
302	Requête redirigée	Hormis les cas classiques de redirection, vous pouvez être redirigé après une requête POST, si l'action s'est bien déroulée et que la vue prévoit de vous rediriger ensuite vers le détail de la ressource.
307	Token SSO expiré	L'`access_token` n'est valable que 5 minutes, et est arrivé à expiration. Vous devez le renouveler (voir S’authentifier) pour poursuivre vos requêtes.
400	Mauvaises données d'entrée	Le format de certains paramètres n'est pas respecté, ou la requête n'est pas exécutable en l'état. Ceci peut être dû à un état de l'objet incompatible avec l'action intentée (par exemple, vous avez voulu modifier une commande remisée). L'API Marketplace explicite autant que possible les erreurs dans la réponse serveur. Consultez le message et cherchez-le dans la documentation. Alternativement, vérifiez le format avec notre open-api.
401	Accès non autorisé	Vous n'avez pas pu être authentifié. Vérifiez que l'entête contient bien la propriété `Authorization` et qu'elle est correctement définie (cf. Définir les en-têtes).
403	Accès interdit	Vous êtes authentifié, mais n'avez pas la permission d'effectuer cette requête. Auriez-vous tenté de vous connecter à l'administrateur web ? Pour rappel, celui-ci est à usage interne de Lyra.
404	L'objet demandé est introuvable	Vous avez demandé une adresse ou un objet qui n'existe pas. Par exemple, vous souhaitez atteindre un objet `order` non trouvé par l'API. Vérifiez d'abord que l'adresse demandée existe, et vérifiez que vous n'avez pas mélangé les deux environnements. Attention de ne pas confondre l'`uuid` du vendeur avec l'`uuid` de la demande d'enregistrement - ce sont deux objets différents.
405	Méthode non applicable	Vous avez exécuté un `POST` alors que nous attendions un `GET` (ou vice-versa). Ou bien le `PUT` n'est pas possible en l'état (par exemple, le statut de l'objet ne permet pas la modification). Contrôlez le message retourné et la documentation. Autre cas possible: votre client a bien effectué le `POST` attendu, mais a relancé la requête vers la nouvelle ressource lorsque la réponse a débouché sur un redirection 302. Dans ce cas, vous devriez désactiver le suivi de la redirection.
423	Requête bloquée	Vous avez envoyé plusieurs requêtes d'exécution de commandes, la seconde nous étant parvenue avant que le premier processus ait abouti. Dans ce cas, nous continuons de traiter la première requête mais bloquons les suivantes.
500	Erreur interne du serveur	L'API marketplace a rencontré une erreur. Si le problème persiste, contactez le support en précisant une référence de commande, de transaction, etc. Par exemple l'`uuid` et la date et heure de l'échange.