Un endpoint est une URL spécifique d'une API qui expose une fonctionnalité précise.
Structure d'un endpoint :
MÉTHODE BASE_URL + ROUTE
GET https://api.example.com/users/123
Composants :
- Méthode HTTP : GET, POST, PUT, DELETE
- Base URL : https://api.example.com
- Route : /users/123
- Paramètres : ?page=1&limit=10
Exemples d'endpoints :
GET /api/products → Liste produits
GET /api/products/42 → Produit #42
POST /api/products → Créer produit
PUT /api/products/42 → Modifier #42
DELETE /api/products/42 → Supprimer #42
Bonnes pratiques :
- RESTful : Utiliser les verbes HTTP
- Noms clairs : Descriptifs et cohérents
- Versioning : /api/v1/users
- Documentation : OpenAPI/Swagger
Endpoint vs Route :
Termes souvent interchangeables, endpoint = route + méthode
Les endpoints sont les "portes d'entrée" de votre API