Modifie l’état
Méthode HTTP POST
Les requêtes POST envoient des données à traiter par le serveur.
Signification
Le client envoie du contenu de requête que la ressource cible doit traiter.
Usages courants
Utilisez POST pour les envois de formulaire, les créations, les commandes, les téléversements et les traitements qui ne sont pas répétables en toute sécurité.
Ce qu’il faut vérifier
Vérifiez le corps de la requête, le Content-Type, les erreurs de validation et si répéter la requête créerait un autre effet.
Exemple de requête
POST /articles HTTP/1.1
Host: example.com
Content-Type: application/json
{"title":"New article"}Propriétés
- Sûre
- Non. Cette méthode peut modifier l’état du serveur.
- Idempotente
- Non. Répéter la requête peut créer un autre effet.
- Cacheable
- Uniquement lorsque la réponse l’autorise explicitement.
- Corps de requête
- Généralement oui
Références
- Registre
- IANA HTTP Method Registry
- Spécification
- RFC 9110 Section 9.3.3
- Guide
- MDN POST