/ EN CLAIR
Un endpoint est l'adresse précise qu'on appelle dans une API pour lire ou écrire une donnée : le chemin complet, le verbe attendu, et ce qu'il faut envoyer avec.
C'est l'unité de travail quand on branche deux outils. Une intégration ne se décrit pas par « on utilise l'API », mais par la liste des endpoints appelés, ce qu'ils prennent en entrée et ce qu'ils renvoient.
Ils changent : un service qui fait évoluer son API version ses endpoints. Épingler la version dans les appels évite de découvrir la rupture le jour où elle arrive.
/ EN BREF
- CE QUE C'EST
- L'adresse précise appelée dans une API : le chemin, le verbe attendu, et ce qu'il faut envoyer avec.
- POURQUOI ÇA COMPTE
- Une intégration ne se décrit pas par « on utilise l'API » mais par la liste des endpoints appelés.
- CE QUI CHANGE
- Ils sont versionnés : un service qui fait évoluer son API crée de nouvelles adresses.
- LE RÉFLEXE
- Épingler la version dans les appels, pour ne pas découvrir la rupture le jour où elle arrive.