Ométodo de requisição HTTP PATCH aplica modificações parciais a um recurso.

O método HTTPPUT permite apenas substituições completas de um documento. Em contraste aoPUT, o métodoPATCH não é idempotente, ou seja, requisições sucessivas idênticaspodem obter efeitos distintos. Todavia, é possível realizar requisiçõesPATCH de modo a serem idempotentes.

PATCH (assim comoPUT) podem ter efeitos colaterais em outros recursos.

Para descobrir se um servidor dá suporte aPATCH, um servidor pode divulgar seu suporte adicionando tal suporte à lista no cabeçalho de resposta HTTPAllow ouAccess-Control-Allow-Methods (para CORS).

Outra indicação (implícita) da permissão de PATCH é a presença do cabeçalhoAccept-Patch, que especifica o formato do documento patch aceito pelo servidor.

Sintaxe

PATCH /file.txt HTTP/1.1

Exemplo

Requisição

PATCH /file.txt HTTP/1.1Host: www.example.comContent-Type: application/exampleIf-Match: "e0023aa4e"Content-Length: 100[descrição das mudanças]

Resposta

Uma resposta sucedida é indicada pelostatus de resposta204, visto que a resposta não carrega um corpo de mensagem.

HTTP/1.1 204 No ContentContent-Location: /arquivo.txtETag: "e0023aa4f"

Especificações

Veja também

• 204
• Allow,Access-Control-Allow-Methods
• Accept-Patch – Especifica o documento patch aceito pelo servidor.