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
Autres extensions