Modifie l’état
Méthode HTTP PATCH
Les requêtes PATCH appliquent des modifications partielles à une ressource.
Signification
Le client envoie un document de modification qui modifie partiellement la ressource cible.
Usages courants
Utilisez PATCH lorsque seule une partie d’une ressource doit changer et que le serveur prend en charge le format du document de patch.
Ce qu’il faut vérifier
Vérifiez le type de média du patch, la prise en charge d’Accept-Patch, les erreurs de validation et les réponses de conflit ou de précondition.
Exemple de requête
PATCH /articles/123 HTTP/1.1
Host: example.com
Content-Type: application/merge-patch+json
{"title":"Updated title"}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 5789 Section 2
- Guide
- MDN PATCH