Méthodes HTTP
Les méthodes HTTP sont comme des "commandes d'action" pour vos données.
Dans les API RESTful, nous utilisons principalement quatre méthodes, correspondant à quatre opérations de base sur les données :
| Méthode HTTP | Objectif | Opération correspondante | Analogie avec la vie |
|---|---|---|---|
| GET | Récupérer les données | Read | Consulter le menu |
| POST | Créer des données | Créez | Commander des plats |
| PUT | Mettre à jour les données | Update | Modifier la commande |
| DELETE | Supprimer les données | Delete | Annuler la commande |
Méthode GET
GET est utilisé pour récupérer des données, comme demander au serveur : « Quels plats avez-vous aujourd'hui ? »
// 获取所有用户 GET /api/users // 获取特定用户 GET /api/users/123 // 获取用户的订单 GET /api/users/123/orders
Fonctionnalités:
- Opération sûre, ne modifie pas les données
- Peut être mis en cache
- Les paramètres sont placés dans l'URL
Méthode POST
POST est utilisé pour créer de nouvelles données, comme dire au serveur : « Je voudrais commander un poulet Kung Pao »
// 创建新用户
POST /api/users
{
"name": "张三",
"email": "zhangsan@example.com"
}
// 创建新订单
POST /api/orders
{
"userId": 123,
"items": ["商品A", "商品B"]
}
Fonctionnalités:
- Modifie l'état du serveur
- Non idempotent (plusieurs appels créeront plusieurs ressources)
- Les données sont placées dans le corps de la requête
Méthode PUT
PUT est utilisé pour mettre à jour l'intégralité de la ressource, comme dire : « Remplacez ma commande par ceci »
// 更新用户信息
PUT /api/users/123
{
"name": "李四",
"email": "lisi@example.com",
"phone": "13800138000"
}
Fonctionnalités:
- Est idempotent (plusieurs appels produisent le même résultat)
- Remplace généralement toute la ressource
- Si la ressource n'existe pas, une nouvelle ressource peut être créée
Méthode DELETE
DELETE est utilisé pour supprimer une ressource, comme si l'on disait : « Annulez ma commande »
// 删除用户 DELETE /api/users/123 // 删除订单 DELETE /api/orders/456
- Est idempotent
- Supprime la ressource spécifiée
- Après un succès, la ressource n'existe plus
Codes de statut HTTP
Une fois que le serveur a traité la requête, il renvoie un code d'état pour vous indiquer le résultat :
| Code d'état | Signification | Description |
|---|---|---|
| 200 | OK | Requête réussie |
| 201 | Created | Ressource créée avec succès |
| 400 | Requête incorrecte | Requête incorrecte |
| 401 | Non autorisé | Non autorisé |
| 404 | Non trouvé | Ressource introuvable |
| 500 | Erreur interne du serveur | Erreur interne du serveur |