Statut du processus API
Après avoir notamment confirmé des commandes et mis à jour votre offre via l'API, il est important de toujours demander un « statut de processus ». Sur cette page, nous expliquons ce qu'est un statut de processus et pourquoi il est important de le demander.
Après une requête où des données sont modifiées, comme la modification du prix d'un article ou le traitement d'une commande, il est important de toujours demander un statut de processus. Un statut de processus indique si ce type de requête (requête POST, PUT ou DELETE) a été réellement traité dans l'environnement bol. En d'autres termes, le statut de processus indique si votre modification a été prise en compte.
Explication du processus
Lorsque vous confirmez une commande bol depuis votre propre système, par exemple, cela ne signifie pas que la commande a été directement traitée correctement par bol. Les requêtes, c'est-à-dire les demandes de modification de données, sont d'abord placées dans une file d'attente. L'API Retailer travaille constamment à partir de la file d'attente pour traiter toutes les requêtes. En fonction du nombre de requêtes dans la file d'attente, le temps nécessaire pour traiter une requête peut varier. Lorsqu'une requête est en tête de file, nous la transmettons à un autre service interne. Un statut de processus indique si une requête a été réellement traitée correctement par nos services internes.
Lorsque vous demandez un statut de processus, nous renvoyons l'un des statuts suivants : SUCCÈS, ÉCHEC, EN ATTENTE ou TIMEOUT. Vous trouverez ci-dessous une brève explication des différents statuts :
- SUCCÈS indique qu'une requête a été correctement traitée par nos services, vous n'avez aucune autre action à entreprendre.
- ÉCHEC indique que la requête n'a pas été correctement traitée. Nous fournissons toujours une explication de la raison pour laquelle la modification n'a pas réussi. Utilisez l'explication dans le message d'erreur d'un ÉCHEC pour ajuster la requête, si nécessaire.
- EN ATTENTE indique que la requête doit encore être traitée. Demandez à nouveau le statut de processus de la requête un peu plus tard pour recevoir le statut définitif.
- Lorsque le système n'a pas pu traiter une requête dans un certain délai, nous attribuons le statut TIMEOUT. En cas de TIMEOUT, vous devez renvoyer la requête originale ultérieurement.
Vous trouverez plus d'informations sur le statut de processus ici.