Principe
Les API (souvent REST, au format JSON) permettent à deux applications d'échanger en temps réel : suivi d'expédition, tarification instantanée, création d'étiquettes chez un transporteur, synchronisation de stocks avec un site e-commerce. Les webhooks notifient les événements. Les plateformes d'intégration (iPaaS) orchestrent les flux.
Comprendre pas à pas
1. La situation
Un e-commerçant veut afficher en temps réel sur son site le stock disponible chez son prestataire logistique et le suivi des colis de 4 transporteurs. Les fichiers échangés une fois par nuit ne suffisent plus. Question : qu'apporte une API ?
2. Fichier de nuit ou API
| Critère | Fichier échangé la nuit | API |
|---|---|---|
| Fraîcheur | la veille | temps réel |
| Déclenchement | planifié | à la demande ou par événement (webhook) |
| Volume par échange | gros | petit |
| Gestion d'erreurs | fichier rejeté en entier | réponse immédiate par requête |
| Usage typique | stocks de fin de journée, factures | disponibilité en ligne, suivi colis, étiquettes transport |
3. L'idée
Une API (interface de programmation) permet à un système d'interroger ou de mettre à jour un autre système à la demande, par des requêtes (souvent REST, au format JSON). Les webhooks font l'inverse : le système prévient automatiquement quand un événement survient (colis livré). Les API complètent l'EDI pour les besoins en temps réel.
Requête
« Quel est le stock de l'article X ? » → réponse immédiate.
Webhook
« Le colis 123 vient d'être livré » → notification automatique.
Sécurité
Authentification (clés, jetons), limites de débit, journalisation.
4. La mise en place
Stock. Le site interroge l'API du WMS du prestataire à chaque affichage produit (avec cache de 5 minutes).
Transport. API de création d'étiquettes chez les 4 transporteurs ; webhooks de suivi.
Suivi client. Statuts envoyés automatiquement au client final.
Résultat. Plus de ventes de produits en rupture ; appels « où est mon colis ? » −60 %.
5. À vous de jouer : vos intégrations
6. Ce qu'il faut retenir
- API : interroger ou mettre à jour un système à la demande.
- Webhook : être prévenu d'un événement.
- Complète l'EDI pour le temps réel ; sécurité et supervision indispensables.
Mise en œuvre
- Acteurs
- Informatique, métiers
- Durée
- —
- Livrables
- Intégrations en temps réel supervisées
- Identifier les échangesDonnées, fréquence, volume.
- Étudier la documentationDes API disponibles.
- SécuriserAuthentification, gestion des erreurs.
- SuperviserDisponibilité et erreurs.
Exemple d'application
Connexion par API du site e-commerce au WMS : le stock disponible est mis à jour en temps réel, les ventes de produits en rupture disparaissent.
Points de vigilance
- Dépendre d'une API sans surveiller sa disponibilité