--- title: PATCH slug: Web/HTTP/Methods/PATCH tags: - HTTP - Método HTTP - Referencia - Rest - patch translation_of: Web/HTTP/Methods/PATCH --- <div>{{HTTPSidebar}}</div> <p>O <strong>método de requisição HTTP PATCH</strong> aplica modificações parciais a um recurso.</p> <p>O método HTTP {{HTTPMethod("PUT")}} permite apenas substituições completas de um documento. Em contraste ao <code>PUT</code>, o método <code>PATCH</code> não é <span class="short_text" id="result_box" lang="pt"><span>idempotente</span></span>, ou seja, requisições sucessivas idênticas <em>podem</em> obter efeitos distintos. Todavia, é possível realizar requisições <code>PATCH</code> de modo a serem <span class="short_text" id="result_box" lang="pt"><span>idempotentes</span></span>.</p> <p><code>PATCH</code> (assim como <code>PUT</code>) podem ter efeitos colaterais em outros recursos.</p> <p>Para descobrir se um servidor dá suporte a <code>PATCH</code>, um servidor pode divulgar seu suporte adicionando tal suporte à lista no cabeçalho de resposta HTTP {{HTTPHeader("Allow")}} ou {{HTTPHeader("Access-Control-Allow-Methods")}} (para CORS).</p> <p>Outra indicação (implícita) da permissão de PATCH é a presença do cabeçalho {{HTTPHeader("Accept-Patch")}}, que especifica o formato do documento patch aceito pelo servidor.</p> <table class="properties"> <tbody> <tr> <th scope="row">Requisição possui corpo</th> <td>Sim</td> </tr> <tr> <th scope="row">Resposta sucedida possui corpo</th> <td>Sim</td> </tr> <tr> <th scope="row">{{Glossary("Safe")}}</th> <td>Não</td> </tr> <tr> <th scope="row">{{Glossary("Idempotent")}}</th> <td>Não</td> </tr> <tr> <th scope="row">{{Glossary("Cacheable")}}</th> <td>Não</td> </tr> <tr> <th scope="row">Permitido em <a href="/en-US/docs/Web/Guide/HTML/Forms">formulários HTML</a></th> <td>Não</td> </tr> </tbody> </table> <h2 id="Sintaxe">Sintaxe</h2> <pre class="syntaxbox">PATCH /file.txt HTTP/1.1 </pre> <h2 id="Exemplo">Exemplo</h2> <h3 id="Requisição">Requisição</h3> <pre class="line-numbers language-html">PATCH /file.txt HTTP/1.1 Host: www.example.com Content-Type: application/example If-Match: "e0023aa4e" Content-Length: 100 [descrição das mudanças]</pre> <h3 id="Resposta">Resposta</h3> <p>Uma resposta sucedida é indicada pelo <em>status </em>de resposta {{HTTPStatus("204")}}, visto que a resposta não carrega um corpo de mensagem.</p> <pre class="newpage">HTTP/1.1 204 No Content Content-Location: /arquivo.txt ETag: "e0023aa4f"</pre> <h2 id="Especificações">Especificações</h2> <table class="standard-table"> <tbody> <tr> <th scope="col">Especificação</th> <th scope="col">Título</th> </tr> <tr> <td>{{RFC("5789", "PATCH")}}</td> <td>PATCH Method for HTTP</td> </tr> </tbody> </table> <h2 id="Veja_também">Veja também</h2> <ul> <li>{{HTTPStatus("204")}}</li> <li>{{HTTPHeader("Allow")}}, {{HTTPHeader("Access-Control-Allow-Methods")}}</li> <li>{{HTTPHeader("Accept-Patch")}} – Especifica o documento patch aceito pelo servidor.</li> </ul>