L'API Lengow permet l'échange de données entre Lengow et votre back office (cela peut être votre propre back office, ou un logiciel comme Prestashop, Magento etc si vous utilisez notre module).
Plusieurs "endpoints" sont disponibles dans l'API Lengow:
- /orders/
Récupérez le listing de toutes vos commandes ou une commande en particulier pour n'importe quelle place de marché que vous avez paramétrée avec Lengow
- /orders/actions/
- /marketplaces/
Aucune action n'est possible ici.
Codes de réponse HTTP
L'API Lengow fournit des codes de réponse HTTP pour chaque requête qui correspondent aux paramètres appelés et à l'action que l'utilisateur a tenté.
Voici les codes de réponse les plus couramment utilisés par l'API Lengow:
- Code 200: OK = Le code de réponse d'état de réussite HTTP 200 OK indique que la demande a réussi.
- Code 201: Created = La demande a été satisfaite, une nouvelle ressource a été créée.
- Code 202: Accepted = La demande a été acceptée pour le traitement, mais le traitement n'est pas terminé.
- Code 400: Bad request = Le serveur ne peut pas ou ne traitera pas la demande en raison d'une erreur apparente du client (validation, URL de ressource incorrecte, etc.).
- Code 401: Access not granted = Utilisé lorsque l'authentification est requise et a échoué ou n'a pas encore été fournie.
- Code 403: Forbidden = La demande était valide, mais le serveur refuse l'action. Aucune autorisation d'utiliser la ressource.
- Code 404: Not Found = La ressource demandée n'a pas pu être trouvée mais pourrait être disponible à l'avenir.
- Code 429: Request limitation reached = Trop de demandes ont été effectuées dans un laps de temps trop court.
- Code 530: Logical Error = La requête a échoué probablement en raison de mauvais paramètres d'entrée (catalogue qui n'existe pas, règles de recherche invalides…). Voir le message d'accompagnement pour plus d'informations.
- Code 540: Technical Error = La demande a échoué en raison d'une erreur interne. Voir le message d'accompagnement pour plus d'informations.
Paramètres de format des données
Le paramètre "Accept" spécifie le format de la demande que vous souhaitez recevoir.
Le paramètre "Content-Type" définit le format que vous envoyez à l'API. En fonction de l'endpoint sur lequel vous êtes, l'API Lengow prend en charge un ensemble de formats différents de message.
Si vous souhaitez modifier le format des données renvoyées par l'API (exemple : afficher les retours API en XML), vous pouvez définir le paramètre "Accept". Le serveur vous répondra avec le format donné et modifiera le paramètre "Content-Type".
- Par défaut, le format est «application/json».
Pour obtenir tous les formats acceptés, vous pouvez utiliser la méthode OPTIONS comme ci-dessous:
/orders/
go to OPTIONS > headers
Key: Accept: application/json"
- Changez la clé (key) avec le format demandé.
source image : Postman
Paramètres de date et d'heure
Les champs de date et d'heure sont présentés dans la norme ISO-8601 tronqués en secondes avec un décalage par rapport à UTC.
Le format de date et d'heure utilisé pour l'API Lengow est répertorié ci-dessous (notre exemple est en JSON et peut varier dans d'autres langages de programmation. Veuillez consulter la documentation de votre langage pour plus d'informations).
Format: yyyy-MM-dd'T'HH:mm:ssXXX
Prix, devises et pays
- Tous les montants monétaires tels que les prix sont indiqués sous forme de nombre décimal.
Exemple: 5.50
- Toutes les devises sont spécifiées avec trois caractères, conformément à la convention ISO 4217.
Exemple : EUR
- Selon la ressource, les pays sont spécifiés avec deux ou trois caractères, conformément à la convention ISO 3166-2.
Exemple: FR
Méthodes HTTP
- GET
- POST
- PUT: Remplacer une donnée existente
- PATCH: Mettre à jour certains champs de données existants
- DELETE: Supprimer les données existantes
source image : Postman
Redirection HTTPS automatique
Arrêt des services HTTP au profit de l’HTTPS
Dans le cadre de l’amélioration continue de la sécurité au sein de notre plateforme et garantir la sécurité de vos données, la redirection automatique des flux HTTP vers le protocole HTTPS ne sera plus disponible à compter du 1er Septembre 2022.
Sans action de votre part, des coupures de services auront lieu sans que nos équipes Support ne puissent agir sur la résolution du problème.
Comment préserver la disponibilité à nos services ?
Pour garantir la disponibilité à nos services depuis de vos outils, nous vous recommandons de vérifier et mettre à jour vos paramètres.
En fonction de l’organisation de votre structure et de votre périmètre d’action, l’intervention d’une personne d’un service technique ou avec des privilèges élevés peut-être nécessaire pour l’application des modifications.
Où dois-je vérifier cette information ?
Tout dépend des usages que vous avez de la plateforme Lengow.
- Si vous avez des outils pour monitorer vos commandes, importer des catalogues ou toute autre information vers un ERP :
Vérifiez le paramétrage de ces outils. Si le paramétrage de votre outil indique une URL http://api.lengow.io/…, vous devez seulement remplacer le “http” par “https” (https://api.lengow.io/…) et enregistrer la modification.
- Si vous avez paramétré des URLs courtes Lengow sur un ou plusieurs canaux :
Pour continuer d’exporter vos catalogues sur les canaux, vérifiez le paramétrage enregistré sur chacun d’eux. Si le paramétrage indiqué utilise le protocole HTTP (http://feeds.lengow.io/3/…), modifiez l’URL pour utiliser le protocole HTTPS (https://feeds.lengow.io/3/…)
Après avoir validé vos modifications, vous pouvez vérifier le bon fonctionnement du service mis à jour.
