Creer une API RESTful
Une API RESTful permet a differentes applications de communiquer entre elles via le protocole HTTP.
Les principes REST
- Stateless : Chaque requete contient toutes les infos necessaires
- Client-Server : Separation des responsabilites
- Cacheable : Les reponses peuvent etre mises en cache
- Uniform Interface : Interface standardisee
Les methodes HTTP
- GET : Recuperer des ressources
- POST : Creer une ressource
- PUT : Mettre a jour completement
- PATCH : Mettre a jour partiellement
- DELETE : Supprimer une ressource
Exemple avec Express
const express = require('express');
const app = express();
app.use(express.json());
let users = [];
// GET - Liste des utilisateurs
app.get('/api/users', (req, res) => {
res.json(users);
});
// POST - Creer un utilisateur
app.post('/api/users', (req, res) => {
const user = { id: Date.now(), ...req.body };
users.push(user);
res.status(201).json(user);
});
// DELETE - Supprimer
app.delete('/api/users/:id', (req, res) => {
users = users.filter(u => u.id !== parseInt(req.params.id));
res.status(204).send();
});
Codes de reponse HTTP
- 200 : Succes
- 201 : Cree
- 400 : Mauvaise requete
- 401 : Non authentifie
- 404 : Non trouve
- 500 : Erreur serveur