PUT

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

O método de requisição HTTP PUT cria um novo recurso ou subsititui uma representação do recurso de destino com os novos dados.

A diferença entre PUT e POST é que PUT é idempotente: chamá-lo uma ou várias vezes sucessivamente terá o mesmo efeito (não é um efeito colateral), enquanto usar POST 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 em formulários HTML Não

Sintaxe

PUT /new.html HTTP/1.1

Exemplo

Solicitação

PUT /new.html HTTP/1.1
Host: example.com
Content-type: text/html
Content-length: 16

<p>New File</p>

Resposta

Se o recurso de destino não tem uma representação atual e a requisição PUT foi criada com sucesso, então o servidor original deve informar o agente de usuário enviando uma resposta 201 (Created).

HTTP/1.1 201 Created
Content-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 resposta 200 (OK) or a 204 (No Content) para indicar a conclusão da requisição.

HTTP/1.1 204 No Content
Content-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.

Compatibilidade com navegadores

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
PUT

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Veja também