blob: 9c71c716db3f37d44262b128871b980a30c55f77 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
|
---
title: PUT
slug: Web/HTTP/Methods/PUT
tags:
- HTTP
- Reference
- Request method
translation_of: Web/HTTP/Methods/PUT
original_slug: Web/HTTP/Méthode/PUT
browser-compat: http.methods.PUT
---
{{HTTPSidebar}}
La **méthode HTTP PUT** crée une nouvelle ressource ou remplace une représentation de la ressource ciblée par le contenu de la requête.
La différence entre `PUT` et [`POST`](/fr/docs/Web/HTTP/Methods/POST) tient au fait que `PUT` est une méthode idempotente. Une requête PUT, envoyée une ou plusieurs fois avec succès, aura toujours le même effet (il n'y a pas d'effet _de bord_). À l'inverse, des requêtes POST successives et identiques peuvent avoir des effets additionnels, ce qui peut revenir par exemple à passer plusieurs fois une commande.
<table class="properties">
<tbody>
<tr>
<th scope="row">La requête a un corps</th>
<td>Oui</td>
</tr>
<tr>
<th scope="row">Une réponse de succès a un corps</th>
<td>Non</td>
</tr>
<tr>
<th scope="row"><a href="/fr/docs/Glossary/safe">Sûre</a></th>
<td>Non</td>
</tr>
<tr>
<th scope="row">
<a href="/fr/docs/Glossary/Idempotent">Idempotente</a>
</th>
<td>Oui</td>
</tr>
<tr>
<th scope="row">
<a href="/fr/docs/Glossary/cacheable">Peut être mise en cache</a>
</th>
<td>Non</td>
</tr>
<tr>
<th scope="row">
Autorisée dans les <a href="/fr/docs/Learn/Forms">formulaires HTML</a>
</th>
<td>Non</td>
</tr>
</tbody>
</table>
## Syntaxe
```html
PUT /new.html HTTP/1.1
```
## Exemple
### Requête
PUT /new.html HTTP/1.1
Host: example.com
Content-type: text/html
Content-length: 16
<p>Nouveau fichier</p>
### Réponses
Si la ressource ciblée ne possède pas de représentation courante et que la requête `PUT` en crée une avec succès, alors le serveur d'origine doit informer l'agent utilisateur en envoyant une réponse [`201`](/fr/docs/Web/HTTP/Status/201) (`Created`).
HTTP/1.1 201 Created
Content-Location: /new.html
Si la ressource ciblée a déjà une représentation et que cette représentation est modifiée avec succès, conformément à l'état de la représentation jointe, alors le serveur d'origine doit envoyer une réponse, que ce soit [`200`](/fr/docs/Web/HTTP/Status/200) (`OK`) ou [`204`](/fr/docs/Web/HTTP/Status/204) (`No Content`), pour indiquer la réussite de la requête.
HTTP/1.1 204 No Content
Content-Location: /existing.html
## Spécifications
{{Specifications}}
## Compatibilité des navigateurs
{{Compat}}
## Voir aussi
- [`201`](/fr/docs/Web/HTTP/Status/201)
- [`204`](/fr/docs/Web/HTTP/Status/204)
|
