Esta página foi traduzida do inglês pela comunidade.Saiba mais e junte-se à comunidade MDN Web Docs.
PUT
Ométodo de requisiçãoHTTP PUT cria um novo recurso ou subsititui uma representação do recurso de destino com os novos dados.
A diferença entrePUT ePOST é quePUT é idempotente: chamá-lo uma ou várias vezes sucessivamente terá o mesmo efeito (não é um efeito colateral), enquanto usarPOST repetidamente pode ter efeitos adicionais, como passar uma ordem várias vezes.
| A requisição tem corpo | Sim |
|---|---|
| Resposta bem sucedida tem corpo | Não |
| Safe | Não |
| Idempotent | Sim |
| Cacheable | Não |
| Permitido emformulários HTML | Não |
In this article
Sintaxe
PUT /new.html HTTP/1.1
Exemplo
>Solicitação
PUT /new.html HTTP/1.1Host: example.comContent-type: text/htmlContent-length: 16<p>New File</p>
Resposta
Se o recurso de destino não tem uma representação atual e a requisiçãoPUT foi criada com sucesso, então o servidor original deve informar o agente de usuário enviando uma resposta201 (Created).
HTTP/1.1 201 CreatedContent-Location: /new.html
Se o recurso de destino tem uma representação atual e essa representação é modificada com sucesso de acordo com o estado de representação em anexo, então o servidor original deve enviar também uma resposta200 (OK) or a204 (No Content) para indicar a conclusão da requisição.
HTTP/1.1 204 No ContentContent-Location: /existing.html
Especificações
| Specification | Title |
|---|---|
| RFC 7231, sessão 4.3.4: PUT | Hypertext Transfer Protocol (HTTP/1.1): Semântica e conteúdo. |