Endpoint API
Un endpoint est une URL précise exposée par une API, associée à une action donnée (récupérer une liste de clients, créer une commande, mettre à jour un statut). Il attend un format de requête particulier et renvoie une réponse structurée, généralement en JSON.
C'est le point de contact concret entre deux systèmes : le back-office d'un site e-commerce qui appelle l'endpoint de son service de paiement pour valider une transaction, ou une application mobile qui interroge un endpoint de son serveur pour afficher la liste des produits. Sur un projet d'intégration ou d'IA, c'est souvent au niveau des endpoints existants qu'on branche un nouveau service tiers ou un modèle externe, sans toucher au reste du système.
Un endpoint mal nommé, non versionné ou avec une gestion d'erreurs approximative devient un point de friction dès qu'il faut le faire évoluer : changer sa structure casse tous les clients qui l'appellent déjà. La bonne pratique est de versionner ses endpoints dès le départ (par exemple /v1/, /v2/) et de documenter précisément les formats attendus, pour pouvoir faire évoluer l'API sans casser les intégrations existantes.
