diff options
Diffstat (limited to 'files/pt-br/web/http/methods')
-rw-r--r-- | files/pt-br/web/http/methods/connect/index.html | 86 | ||||
-rw-r--r-- | files/pt-br/web/http/methods/delete/index.html | 99 | ||||
-rw-r--r-- | files/pt-br/web/http/methods/get/index.html | 78 | ||||
-rw-r--r-- | files/pt-br/web/http/methods/head/index.html | 78 | ||||
-rw-r--r-- | files/pt-br/web/http/methods/index.html | 87 | ||||
-rw-r--r-- | files/pt-br/web/http/methods/options/index.html | 122 | ||||
-rw-r--r-- | files/pt-br/web/http/methods/patch/index.html | 99 | ||||
-rw-r--r-- | files/pt-br/web/http/methods/post/index.html | 122 | ||||
-rw-r--r-- | files/pt-br/web/http/methods/put/index.html | 100 | ||||
-rw-r--r-- | files/pt-br/web/http/methods/trace/index.html | 75 |
10 files changed, 946 insertions, 0 deletions
diff --git a/files/pt-br/web/http/methods/connect/index.html b/files/pt-br/web/http/methods/connect/index.html new file mode 100644 index 0000000000..6403e419c8 --- /dev/null +++ b/files/pt-br/web/http/methods/connect/index.html @@ -0,0 +1,86 @@ +--- +title: CONNECT +slug: Web/HTTP/Methods/CONNECT +tags: + - HTTP + - Método de requisição + - Referencia +translation_of: Web/HTTP/Methods/CONNECT +--- +<div>{{HTTPSidebar}}</div> + +<p>O <strong>médoto HTTP <code>CONNECT</code> </strong>começa a comunicação bidirecional com o recurso solicitado. Ele pode ser usado para abrir um túnel.</p> + +<p>Por exemplo, o método <code>CONNECT</code> pode ser utilizado para acessar websites que usam {{Glossary("SSL")}} ({{Glossary("HTTPS")}}). O cliente solicita a um servidor proxy HTTP que tunelize a conexão TCP para o destino desejado. O servidor então procede para fazer a conexão em nome do cliente. Uma vez que a conexão foi estabelecida pelo servidor, o servidor Proxy continua a proxy do fluxo TCP para e do cliente.</p> + +<p><code>CONNECT</code> é um método hop-by-hop.</p> + +<table class="properties"> + <tbody> + <tr> + <th scope="row">Requisição tem corpo</th> + <td>Sim</td> + </tr> + <tr> + <th scope="row">Resposta bem sucedida tem corpo</th> + <td>Sim</td> + </tr> + <tr> + <th scope="row">{{Glossary("Seguro")}}</th> + <td>Não</td> + </tr> + <tr> + <th scope="row">{{Glossary("Idempotente")}}</th> + <td>Não</td> + </tr> + <tr> + <th scope="row">{{Glossary("Cacheável")}}</th> + <td>Não</td> + </tr> + <tr> + <th scope="row">Permitido em formulários HTML</th> + <td>Não</td> + </tr> + </tbody> +</table> + +<h2 id="Sintaxe">Sintaxe</h2> + +<pre class="syntaxbox">CONNECT www.exemplo.com:443 HTTP/1.1 +</pre> + +<h2 id="Exemplo">Exemplo</h2> + +<p>Alguns servidores de proxy podem precisar de autoridade para criar um túnel. Veja mais no header {{HTTPHeader("Proxy-Authorization")}}</p> + +<pre class="line-numbers language-html">CONNECT server.exemplo.com:80 HTTP/1.1 +Host: server.exemplo.com:80 +Proxy-Authorization: basic aGVsbG86d29ybGQ=</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("7231", "CONNECT", "4.3.6")}}</td> + <td>Hypertext Transfer Protocol (HTTP/1.1): Semântica e conteúdo</td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilidade_de_browsers.">Compatibilidade de browsers.</h2> + +<p class="hidden">The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> and send us a pull request.</p> + +<p>{{Compat("http.methods.CONNECT")}}</p> + +<h2 id="Veja_também">Veja também</h2> + +<ul> + <li>{{Glossary("Servidor proxy")}}</li> + <li>{{HTTPHeader("Proxy-Authorization")}}</li> +</ul> diff --git a/files/pt-br/web/http/methods/delete/index.html b/files/pt-br/web/http/methods/delete/index.html new file mode 100644 index 0000000000..6ec5b67c44 --- /dev/null +++ b/files/pt-br/web/http/methods/delete/index.html @@ -0,0 +1,99 @@ +--- +title: DELETE +slug: Web/HTTP/Methods/DELETE +tags: + - HTTP + - Método HTTP + - Método de requisição + - Referencia +translation_of: Web/HTTP/Methods/DELETE +--- +<div>{{HTTPSidebar}}</div> + +<div>O <strong>método de requisição HTTP DELETE</strong> remove o recurso especificado.</div> + +<table class="properties"> + <tbody> + <tr> + <th scope="row">Requisição tem corpo</th> + <td>Talvez</td> + </tr> + <tr> + <th scope="row">A resposta bem sucedida tem corpo</th> + <td>Talvez</td> + </tr> + <tr> + <th scope="row">{{Glossary("Seguro")}}</th> + <td>Não</td> + </tr> + <tr> + <th scope="row">{{Glossary("Idempotente")}}</th> + <td>Sim</td> + </tr> + <tr> + <th scope="row">{{Glossary("Cacheável")}}</th> + <td>Não</td> + </tr> + <tr> + <th scope="row">Aceito nos <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 notranslate">DELETE /arquivo.html HTTP/1.1 +</pre> + +<h2 id="Exemplo">Exemplo</h2> + +<h3 id="Requisição">Requisição</h3> + +<pre class="notranslate">DELETE /arquivo.html HTTP/1.1</pre> + +<h3 id="Respostas">Respostas</h3> + +<p>Se um método <code>DELETE</code> for aplicado com sucesso, há muitos códigos de status de resposta possíveis:</p> + +<ul> + <li> Um código de status {{HTTPStatus("202")}} (<code>Accepted</code>) se a ação provavelmente teve sucesso, porém ainda não foi realizada.</li> + <li>Um código de status {{HTTPStatus("204")}} (<code>No Content</code>) se a ação foi realizada e nenhuma outra informação deve ser fornecida.</li> + <li>Um código de status {{HTTPStatus("200")}} (<code>OK</code>) se a ação foi realizada e a mensagem de resposta inclui uma representação descrevendo o status.</li> +</ul> + +<pre class="notranslate">HTTP/1.1 200 OK +Date: Wed, 21 Oct 2015 07:28:00 GMT + +<html> + <body> + <h1>Arquivo removido.</h1> + </body> +</html></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("7231", "DELETE", "4.3.5")}}</td> + <td>Protocolo de Transferência de Hipertexto (HTTP/1.1): Semântica e conteúdo</td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilidade_de_browsers">Compatibilidade de browsers</h2> + +<p class="hidden">A tabela de compatibilidade nesta página foi gerada de dados estruturados. Se você gostaria de contribuir com os dados, por favor, confira <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> e nos envie um pull request.</p> + +<p>{{Compat("http.methods.DELETE")}}</p> + +<h2 id="Veja_também">Veja também</h2> + +<ul> + <li>HTTP status: {{HTTPStatus("200")}}, {{HTTPStatus("202")}}, {{HTTPStatus("204")}}</li> +</ul> diff --git a/files/pt-br/web/http/methods/get/index.html b/files/pt-br/web/http/methods/get/index.html new file mode 100644 index 0000000000..e3e6e63796 --- /dev/null +++ b/files/pt-br/web/http/methods/get/index.html @@ -0,0 +1,78 @@ +--- +title: GET +slug: Web/HTTP/Methods/GET +tags: + - HTTP + - Método GET + - Método Request + - Referencia +translation_of: Web/HTTP/Methods/GET +--- +<div>{{HTTPSidebar}}</div> + +<div>O <strong>método HTTP GET</strong> solicita uma representação do recurso especificado. Solicitações usando GET só devem recuperar dados.</div> + +<div> </div> + +<table class="properties"> + <tbody> + <tr> + <th scope="row">Requisição tem corpo</th> + <td>Não</td> + </tr> + <tr> + <th scope="row">Resposta bem-sucedida tem corpo</th> + <td>Sim</td> + </tr> + <tr> + <th scope="row"><a href="https://developer.mozilla.org/pt-BR/docs/Glossary/Safe">Seguro</a></th> + <td>Sim</td> + </tr> + <tr> + <th scope="row"><a href="https://developer.mozilla.org/pt-BR/docs/Glossary/Idempotent">Idempotente</a></th> + <td>Sim</td> + </tr> + <tr> + <th scope="row"><a href="https://developer.mozilla.org/pt-BR/docs/Glossary/Cacheable">Cacheável</a></th> + <td>Sim</td> + </tr> + <tr> + <th scope="row">Permitido em formulários HTML</th> + <td>SIm</td> + </tr> + </tbody> +</table> + +<h2 id="Sintaxe">Sintaxe</h2> + +<pre class="syntaxbox">GET /index.html +</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("7231", "GET", "4.3.1")}}</td> + <td>Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content</td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilidade_com_navegadores">Compatibilidade com navegadores</h2> + +<p class="hidden">A tabela de compatibilidade nesta página é gerada a partir de dados estruturados. Se você quiser contribuir com os dados, consulte https://github.com/mdn/browser-compat-data e envie-nos um <em>pull request</em>.</p> + +<p>{{Compat("http.methods.GET")}}</p> + +<p> </p> + +<h2 id="Veja_também">Veja também</h2> + +<ul> + <li>{{HTTPHeader("Range")}}</li> +</ul> diff --git a/files/pt-br/web/http/methods/head/index.html b/files/pt-br/web/http/methods/head/index.html new file mode 100644 index 0000000000..8d3535e0b1 --- /dev/null +++ b/files/pt-br/web/http/methods/head/index.html @@ -0,0 +1,78 @@ +--- +title: HEAD +slug: Web/HTTP/Methods/HEAD +tags: + - Método de solicitação + - Referencia + - requisição + - solicitação +translation_of: Web/HTTP/Methods/HEAD +--- +<div>{{HTTPSidebar}}</div> + +<p>O <strong>método HTTP <code>HEAD</code></strong> solicita os cabeçalhos retornados de um recurso específico que foi requisitado por um método HTTP {{HTTPMethod("GET")}}. Tal solicitação pode ser feita antes de baixar um grande recurso para economizar largura de banda, por exemplo.</p> + +<p>Uma resposta para um método <code>HEAD</code> não deve ter um corpo. Se tiver, deve ser ignorado. Mesmo assim, {{glossary("Entity header", "entity headers")}} (cabeçalhos de entidade) descrevendo o conteúdo do corpo (como {{HTTPHeader("Content-Length")}}) podem ser incluidos na resposta. Eles não se relacionam com o corpo da resposta <code>HEAD</code>, que deve estar vazio, e sim com o corpo de solicitação relacionado, usando o método {{HTTPMethod("GET")}} que teria retornado como resposta.</p> + +<p>Se a resposta de uma solicitação <code>HEAD</code> mostrar que um recurso armazenado em cache após uma requisição {{HTTPMethod("GET")}} está desatualizado, o cache é invalidado, mesmo se nenhuma solicitação <code>GET</code> tiver sido feita.</p> + +<table class="properties"> + <tbody> + <tr> + <th scope="row">Solicitação tem um corpo</th> + <td>Não</td> + </tr> + <tr> + <th scope="row">A resposta bem sucedida tem um corpo</th> + <td>Não</td> + </tr> + <tr> + <th scope="row">{{Glossary("Safe")}}</th> + <td>Sim</td> + </tr> + <tr> + <th scope="row">{{Glossary("Idempotent")}}</th> + <td>Sim</td> + </tr> + <tr> + <th scope="row">{{Glossary("Cacheable")}}</th> + <td>Sim</td> + </tr> + <tr> + <th scope="row">Permitido em <a href="/pt-BR/docs/Web/Guide/HTML/Forms">formulário HTML</a></th> + <td>Não</td> + </tr> + </tbody> +</table> + +<h2 id="Sintaxe">Sintaxe</h2> + +<pre class="syntaxbox">HEAD /index.html +</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("7231", "HEAD", "4.3.2")}}</td> + <td>Hypertext Transfer Protocol (HTTP/1.1): Semântica e Conteúdo</td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilidade_entre_navegadores">Compatibilidade entre navegadores</h2> + +<p class="hidden">A tabela de compatibilidade nesta página é gerada através de dados estruturados. Se você quiser contribuir com dados, pedimos que acesse <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> e envie-nos um pull request.</p> + +<p>{{Compat("http.methods.HEAD")}}</p> + +<h2 id="Veja_também">Veja também</h2> + +<ul> + <li>{{HTTPMethod("GET")}}</li> +</ul> diff --git a/files/pt-br/web/http/methods/index.html b/files/pt-br/web/http/methods/index.html new file mode 100644 index 0000000000..d97854af3f --- /dev/null +++ b/files/pt-br/web/http/methods/index.html @@ -0,0 +1,87 @@ +--- +title: Métodos de requisição HTTP +slug: Web/HTTP/Methods +tags: + - HTTP + - Métodos + - Verbos +translation_of: Web/HTTP/Methods +--- +<div> +<div> +<dl> +</dl> +</div> + +<blockquote> +<p><em>Nota: O conteúdo original publicado em inglês no Mozilla Developer Network utiliza o termo "resource", mantido na tradução, que refere-se a qualquer destino válido ao executar uma conexão usando o protocolo HTTP. Na língua portuguesa, ao falar sobre requisições, o termo é pouco usado com essa finalidade ou contexto.</em></p> +</blockquote> + +<dl> +</dl> + +<p>{{HTTPSidebar}}</p> + +<p>O protocolo HTTP define um conjunto de <strong>métodos de requisição</strong> responsáveis por indicar a ação a ser executada para um dado recurso. Embora esses métodos possam ser descritos como substantivos, eles também são comumente referenciados como <strong><em>HTTP Verbs (Verbos HTTP)</em></strong>.<strong><em> </em></strong>Cada um deles implementa uma semântica diferente, mas alguns recursos são compartilhados por um grupo deles, como por exemplo, qualquer método de requisição pode ser do tipo <span style="line-height: 1.5;">{{glossary("safe")}}, {{glossary("idempotent")}} ou {{glossary("cacheable")}}.</span></p> +</div> + +<dl> + <dt><code><a href="/pt-BR/docs/Web/HTTP/Methods/GET">GET</a></code></dt> + <dd>O método <code>GET</code> solicita a representação de um recurso específico. Requisições utilizando o método <code>GET</code> devem retornar apenas dados.</dd> + <dt><code><a href="/en-US/docs/Web/HTTP/Methods/HEAD">HEAD</a></code></dt> + <dd> O método <code>HEAD</code> solicita uma resposta de forma idêntica ao método <code>GET</code>, porém sem conter o corpo da resposta.</dd> + <dt><code><a href="/en-US/docs/Web/HTTP/Methods/POST">POST</a></code></dt> + <dd>O método <code>POST</code> é utilizado para submeter uma entidade a um recurso específico, frequentemente causando uma mudança no estado do recurso ou efeitos colaterais no servidor.</dd> + <dt><code><a href="/en-US/docs/Web/HTTP/Methods/PUT">PUT</a></code></dt> + <dd> + <p>O método <code>PUT</code> substitui todas as atuais representações do recurso de destino pela carga de dados da requisição.</p> + </dd> + <dt><code><a href="/en-US/docs/Web/HTTP/Methods/DELETE">DELETE</a></code></dt> + <dd>O método <code>DELETE</code> remove um recurso específico.</dd> + <dt><code><a href="/en-US/docs/Web/HTTP/Methods/CONNECT">CONNECT</a></code></dt> + <dd> + <p>O método <code>CONNECT</code> estabelece um túnel para o servidor identificado pelo recurso de destino.</p> + </dd> + <dt><code><a href="/en-US/docs/Web/HTTP/Methods/OPTIONS">OPTIONS</a></code></dt> + <dd>O método <code>OPTIONS</code> é usado para descrever as opções de comunicação com o recurso de destino.</dd> + <dt><code><a href="/en-US/docs/Web/HTTP/Methods/TRACE">TRACE</a></code></dt> + <dd> + <p>O método <code>TRACE</code> executa um teste de chamada <em>loop-back</em> junto com o caminho para o recurso de destino.</p> + </dd> + <dt><code><a href="/en-US/docs/Web/HTTP/Methods/PATCH">PATCH</a></code></dt> + <dd>O método <code>PATCH</code> é utilizado para aplicar modificações parciais em um recurso.</dd> +</dl> + +<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> + <th scope="col">Comentário</th> + </tr> + <tr> + <td>{{RFC("7231", "Request methods", "4")}}</td> + <td>Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content</td> + <td>Especifica os métodos GET, HEAD, POST, PUT, DELETE, CONNECT, OPTIONS, TRACE.</td> + </tr> + <tr> + <td>{{RFC("5789", "Patch method", "2")}}</td> + <td>PATCH Method for HTTP</td> + <td>Especifica o método PATCH.</td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilidade_com_navegadores">Compatibilidade com navegadores</h2> + +<p class="hidden">Para contribuir com estes dados de compatibilidade, envie uma requisição <em>pull</em> para este arquivo: <a href="https://github.com/mdn/browser-compat-data/blob/master/http/methods.json">https://github.com/mdn/browser-compat-data/blob/master/http/methods.json</a>.</p> + +<p>{{Compat("http/methods")}}</p> + +<h2 id="Veja_também">Veja também</h2> + +<ul> + <li><a href="/en-US/docs/Web/HTTP/Headers">Cabeçalhos HTTP</a></li> +</ul> diff --git a/files/pt-br/web/http/methods/options/index.html b/files/pt-br/web/http/methods/options/index.html new file mode 100644 index 0000000000..6ad1b2231b --- /dev/null +++ b/files/pt-br/web/http/methods/options/index.html @@ -0,0 +1,122 @@ +--- +title: OPTIONS +slug: Web/HTTP/Methods/OPTIONS +translation_of: Web/HTTP/Methods/OPTIONS +--- +<div>{{HTTPSidebar}}</div> + +<p>O <strong>método HTTP <code>OPTIONS</code> </strong>é utilizado para que um cliente possa descobrir quais as opções de requisição permitidas para um determinado recurso em um servidor. O cliente pode especificar uma URL específica no método <code>OPTIONS</code> ou um asterisco(*) indicando que se refere ao servidor como um todo para sanar suas dúvidas em relação as opções de requisição permitidas.</p> + +<table class="properties"> + <tbody> + <tr> + <th scope="row">Request possui corpo</th> + <td>Não</td> + </tr> + <tr> + <th scope="row">Resposta bem sucedida possui corpo</th> + <td>Não</td> + </tr> + <tr> + <th scope="row">{{Glossary("Seguro")}}</th> + <td>Sim</td> + </tr> + <tr> + <th scope="row">{{Glossary("Idempotente")}}</th> + <td>Sim</td> + </tr> + <tr> + <th scope="row">{{Glossary("Cacheável")}}</th> + <td>Não</td> + </tr> + <tr> + <th scope="row">Permitido em formulários HTML</th> + <td>Não</td> + </tr> + </tbody> +</table> + +<h2 id="Sintaxe">Sintaxe</h2> + +<pre class="syntaxbox notranslate">OPTIONS /index.html HTTP/1.1 +OPTIONS * HTTP/1.1 +</pre> + +<h2 id="Exemplos">Exemplos</h2> + +<h3 id="Descobrindo_quais_tipos_de_requisição_são_permitidas">Descobrindo quais tipos de requisição são permitidas</h3> + +<p>Para descobrir quais tipos de requisição um servidor suporta, é possível utilizar o curl e enviar uma requisição OPTIONS:</p> + +<pre class="notranslate">curl -X OPTIONS http://example.org -i</pre> + +<p>A resposta terá um cabeçalho {{HTTPHeader("Allow")}} com os métodos permitidos:</p> + +<pre class="notranslate">HTTP/1.1 200 OK +Allow: OPTIONS, GET, HEAD, POST +Cache-Control: max-age=604800 +Date: Thu, 13 Oct 2016 11:45:00 GMT +Expires: Thu, 20 Oct 2016 11:45:00 GMT +Server: EOS (lax004/2813) +x-ec-custom-error: 1 +Content-Length: 0 +</pre> + +<h3 id="Requisições_Preflighted_no_CORS">Requisições Preflighted no CORS</h3> + +<p>No <a href="/en-US/docs/Web/HTTP/Access_control_CORS">CORS</a>, uma requisição preflight com o método OPTIONS é enviada para que o servidor possa indicar se é possível enviar uma requisição específica com os parâmetros informados. No exemplo abaixo, o cabeçalho {{HTTPHeader("Access-Control-Request-Method")}} indica para o servidor que quando a requisição específica for enviada, ela será enviada como uma requisição POST. O cabeçalho {{HTTPHeader("Access-Control-Request-Headers")}} indica para o servidor que quando a requisição específica for enviada, ela será enviada com os cabeçalhos customizados <code>X-PINGOTHER</code> e <code>Content-Type</code>. A partir desta requisição com o método OPTIONS, o servidor possui a oportunidade de indicar se a requisição específica será aceita da forma como foi indicada pelos parâmetros supracitados (o método POST e os dois cabeçalhos customizados).</p> + +<pre class="notranslate">OPTIONS /resources/post-here/ HTTP/1.1 +Host: bar.other +Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8 +Accept-Language: en-us,en;q=0.5 +Accept-Encoding: gzip,deflate +Accept-Charset: ISO-8859-1,utf-8;q=0.7,*;q=0.7 +Connection: keep-alive +Origin: http://foo.example +Access-Control-Request-Method: POST +Access-Control-Request-Headers: X-PINGOTHER, Content-Type</pre> + +<p>Em nosso exemplo, o servidor responde com {{HTTPHeader("Access-Control-Allow-Methods")}} indicando que os métodos <code>POST</code>, <code>GET</code>, e <code>OPTIONS</code> são permitidos para utilização em relação ao recurso em questão. Este cabeçalho é similar ao cabeçalho de resposta {{HTTPHeader("Allow")}} , no entanto ele somente é utilizado no contexto do CORS.</p> + +<pre class="notranslate">HTTP/1.1 200 OK +Date: Mon, 01 Dec 2008 01:15:39 GMT +Server: Apache/2.0.61 (Unix) +Access-Control-Allow-Origin: http://foo.example +Access-Control-Allow-Methods: POST, GET, OPTIONS +Access-Control-Allow-Headers: X-PINGOTHER, Content-Type +Access-Control-Max-Age: 86400 +Vary: Accept-Encoding, Origin +Content-Encoding: gzip +Content-Length: 0 +Keep-Alive: timeout=2, max=100 +Connection: Keep-Alive +Content-Type: text/plain</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("7231", "OPTIONS", "4.3.7")}}</td> + <td>Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content</td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilidade_entre_navegadores">Compatibilidade entre navegadores</h2> + +<p class="hidden">A tabela de compatibilidade é gerada a partir de dados estruturados. Se você gostaria de contribuir, por favor verifique o repositório <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> e nos envie um pull request.</p> + +<p>{{Compat("http.methods.OPTIONS")}}</p> + +<h2 id="Veja_também">Veja também</h2> + +<ul> + <li>{{HTTPHeader("Allow")}} header</li> + <li><a href="/en-US/docs/Web/HTTP/Access_control_CORS">CORS</a></li> +</ul> diff --git a/files/pt-br/web/http/methods/patch/index.html b/files/pt-br/web/http/methods/patch/index.html new file mode 100644 index 0000000000..3f97a7c329 --- /dev/null +++ b/files/pt-br/web/http/methods/patch/index.html @@ -0,0 +1,99 @@ +--- +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> diff --git a/files/pt-br/web/http/methods/post/index.html b/files/pt-br/web/http/methods/post/index.html new file mode 100644 index 0000000000..d5d1f07a1e --- /dev/null +++ b/files/pt-br/web/http/methods/post/index.html @@ -0,0 +1,122 @@ +--- +title: POST +slug: Web/HTTP/Methods/POST +tags: + - HTTP + - Método de requisição + - Referencia +translation_of: Web/HTTP/Methods/POST +--- +<div>{{HTTPSidebar}}</div> + +<p>O <strong>método HTTP <code>POST</code></strong> envia dados ao servidor. O tipo do corpo da solicitação é indicado pelo cabeçalho {{HTTPHeader("Content-Type")}}.</p> + +<p>A diferença entre <code>PUT</code> e {{HTTPMethod("POST")}} é que <code>PUT</code> é idempotente: chamá-lo uma vez ou várias vezes sucessivamente tem o mesmo efeito (ou seja, nenhum efeito colateral), onde sucessivos POST idênticos podem ter efeitos adicionais, assim como passando uma ordem várias vezes.</p> + +<p>Uma solicitação <code>POST</code> geralmente é enviada por meio de um <a href="/pt-BR/docs/Web/Guide/HTML/Forms">formulário HTML</a> e resulta em uma alteração no servidor. Nesse caso, o tipo de conteúdo é selecionado colocando a string adequada no atributo {{htmlattrxref("enctype", "form")}} do elemento {{HTMLElement("form")}} ou o atributo {{htmlattrxref("formenctype", "input")}} dos elementos {{HTMLElement("input")}} ou {{HTMLElement("button")}}:</p> + +<ul> + <li><code>application/x-www-form-urlencoded</code>: as chaves e valores são codificados em tuplas de valor-chave separadas por <code>'&'</code>, com um <code>'='</code> entre a chave e o valor. Caracteres não alfanuméricos em chaves e valores são {{glossary ("percent-encoding", "percent encoded")}}: este é o motivo pelo qual esse tipo não é adequado para uso com dados binários (ao invés disso, use <code>multipart/form-data</code>)</li> + <li><code>multipart/form-data</code></li> + <li><code>text/plain</code></li> +</ul> + +<p>Quando a requisição <code>POST</code> é enviada através de um método diferente de um formulário HTML - como por meio de um {{domxref("XMLHttpRequest")}} - o corpo pode assumir qualquer tipo. Conforme descrito na especificação HTTP 1.1, o <code>POST</code> é projetado para permitir que um método uniforme cubra as seguintes funções:</p> + +<ul> + <li>Anotação de recursos existentes</li> + <li>Postar uma mensagem em um quadro de avisos, newsgroup, lista de emails ou grupo similar de artigos;</li> + <li>Adicionando um novo usuário através de um modal de inscrição;</li> + <li>Fornecendo um bloco de dados, como o resultado do envio de um formulário, para um processo de manipulação de dados;</li> + <li>Estendendo um banco de dados por meio de uma operação de <em>append</em>.</li> +</ul> + +<table class="properties"> + <tbody> + <tr> + <th scope="row">Requisição tem corpo</th> + <td>Sim</td> + </tr> + <tr> + <th scope="row">Resposta bem-sucedida tem corpo</th> + <td>Sim</td> + </tr> + <tr> + <th scope="row"><a href="https://developer.mozilla.org/pt-BR/docs/Glossary/Safe">Seguro</a></th> + <td>Não</td> + </tr> + <tr> + <th scope="row"><a href="https://developer.mozilla.org/pt-BR/docs/Glossary/Idempotent">Idempotente</a></th> + <td>Não</td> + </tr> + <tr> + <th scope="row"><a href="https://developer.mozilla.org/pt-BR/docs/Glossary/Cacheable">Cacheável</a></th> + <td>Somente se as informações de atualização estiverem incluídas</td> + </tr> + <tr> + <th scope="row">Permitido em <a href="/pt-BR/docs/Web/Guide/HTML/Forms">formulários HTML</a></th> + <td>Sim</td> + </tr> + </tbody> +</table> + +<h2 id="Sintaxe">Sintaxe</h2> + +<pre class="syntaxbox">POST /index.html +</pre> + +<h2 id="Exemplo">Exemplo</h2> + +<p>Um simples formulário utilizando o padrão <em>content type</em> <code>application/x-www-form-urlencoded</code>:</p> + +<pre class="line-numbers language-html">POST / HTTP/1.1 +Host: foo.com +Content-Type: application/x-www-form-urlencoded +Content-Length: 13 + +say=Hi&to=Mom</pre> + +<p>Um formulário utilizando o <em>content type</em> <code>multipart/form-data</code>:</p> + +<pre>POST /test.html HTTP/1.1 +Host: example.org +Content-Type: multipart/form-data;boundary="boundary" + +--boundary +Content-Disposition: form-data; name="field1" + +value1 +--boundary +Content-Disposition: form-data; name="field2"; filename="example.txt" + +value2</pre> + +<h2 id="Especificações">Especificações</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Especificação</th> + <th scope="col">Título</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{RFC("7231", "POST", "4.3.3")}}</td> + <td>Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content</td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilidade_com_navegadores">Compatibilidade com navegadores</h2> + +<p class="hidden">A tabela de compatibilidade nesta página é gerada a partir de dados estruturados. Se você quiser contribuir com os dados, consulte <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> e envie-nos um <em>pull request</em>.</p> + +<p>{{Compat("http.methods.POST")}}</p> + +<h2 id="Veja_também">Veja também</h2> + +<ul> + <li>{{HTTPHeader("Content-Type")}}</li> + <li>{{HTTPHeader("Content-Disposition")}}</li> +</ul> diff --git a/files/pt-br/web/http/methods/put/index.html b/files/pt-br/web/http/methods/put/index.html new file mode 100644 index 0000000000..5e7ca00f57 --- /dev/null +++ b/files/pt-br/web/http/methods/put/index.html @@ -0,0 +1,100 @@ +--- +title: PUT +slug: Web/HTTP/Methods/PUT +tags: + - Método HTTP + - Método de requisição + - Referencia +translation_of: Web/HTTP/Methods/PUT +--- +<div>{{HTTPSidebar}}</div> + +<p>O <strong>método de requisição </strong><strong>HTTP PUT</strong> cria um novo recurso ou subsititui uma representação do recurso de destino com os novos dados.</p> + +<p>A diferença entre <code>PUT</code> e {{HTTPMethod("POST")}} é que <code>PUT</code> é idempotente: chamá-lo uma ou várias vezes sucessivamente terá o mesmo efeito (não é um efeito colateral), enquanto usar <code>POST</code> repetidamente pode ter efeitos adicionais, como passar uma ordem várias vezes.</p> + +<table class="properties"> + <tbody> + <tr> + <th scope="row">A requisição tem corpo</th> + <td>Sim</td> + </tr> + <tr> + <th scope="row">Resposta bem sucedida tem corpo</th> + <td>Não</td> + </tr> + <tr> + <th scope="row">{{Glossary("Safe")}}</th> + <td>Não</td> + </tr> + <tr> + <th scope="row">{{Glossary("Idempotent")}}</th> + <td>Sim</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">PUT /new.html HTTP/1.1 +</pre> + +<h2 id="Exemplo">Exemplo</h2> + +<h3 id="Solicitação">Solicitação</h3> + +<pre>PUT /new.html HTTP/1.1 +Host: example.com +Content-type: text/html +Content-length: 16 + +<p>New File</p></pre> + +<h3 id="Resposta">Resposta</h3> + +<p>Se o recurso de destino não tem uma representação atual e a requisição <code>PUT</code> foi criada com sucesso, então o servidor original deve informar o agente de usuário enviando uma resposta {{HTTPStatus("201")}} (<code>Created</code>).</p> + +<pre class="newpage">HTTP/1.1 201 Created +Content-Location: /new.html</pre> + +<p>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 {{HTTPStatus("200")}} (<code>OK</code>) or a {{HTTPStatus("204")}} (<code>No Content</code>) para indicar a conclusão da requisição.</p> + +<pre>HTTP/1.1 204 No Content +Content-Location: /existing.html +</pre> + +<h2 id="Especificações">Especificações</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Specification</th> + <th scope="col">Title</th> + </tr> + <tr> + <td>{{RFC("7231", "PUT", "4.3.4")}}</td> + <td>Hypertext Transfer Protocol (HTTP/1.1): Semântica e conteúdo.</td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilidade_entre_navegadores">Compatibilidade entre navegadores</h2> + +<p class="hidden">A tabela de compatibilidade nesta página é gerada através de dados estruturados. Se você quiser contribuir com os dados, acesse <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> e nos solicite um pull request.</p> + +<p>{{Compat("http.methods.PUT")}}</p> + +<h2 id="Veja_também">Veja também</h2> + +<ul> + <li>{{HTTPStatus("201")}}</li> + <li>{{HTTPStatus("204")}}</li> +</ul> diff --git a/files/pt-br/web/http/methods/trace/index.html b/files/pt-br/web/http/methods/trace/index.html new file mode 100644 index 0000000000..0c36c59cfa --- /dev/null +++ b/files/pt-br/web/http/methods/trace/index.html @@ -0,0 +1,75 @@ +--- +title: TRACE +slug: Web/HTTP/Methods/TRACE +translation_of: Web/HTTP/Methods/TRACE +--- +<div>{{HTTPSidebar}}</div> + +<p>O <strong>método</strong> <strong>HTTP <code>TRACE</code> </strong>realiza um teste de loopback enviando uma mensagem por todo o caminho até o recurso alvo no qual foi destinado, provendo um mecanismo útil para debug.</p> + +<p>O destinatário final deve responder a mensagem recebida, excluindo alguns campos descritos abaixo, de volta para o client com um status code 200 (OK) e um cabeçalho {{httpheader("Content-Type")}}. O destinatário final pode ser o servidor de origem ou o primeiro servidor a receber a requisição com o cabeçalho {{httpheader("Max-Forwards")}} com valor 0.</p> + +<table class="properties"> + <tbody> + <tr> + <th scope="row">Requisição possui body</th> + <td>No</td> + </tr> + <tr> + <th scope="row">Resposta com sucesso possui body</th> + <td>No</td> + </tr> + <tr> + <th scope="row">{{Glossary("Seguro")}}</th> + <td>No</td> + </tr> + <tr> + <th scope="row">{{Glossary("Idempotent")}}</th> + <td>Yes</td> + </tr> + <tr> + <th scope="row">{{Glossary("Cacheavel")}}</th> + <td>No</td> + </tr> + <tr> + <th scope="row">Permitido nos formatos HTML</th> + <td>No</td> + </tr> + </tbody> +</table> + +<h2 id="Sintaxe">Sintaxe</h2> + +<pre class="syntaxbox">TRACE /index.html +</pre> + +<h2 id="Especificações">Especificações</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Specification</th> + <th scope="col">Title</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{RFC("7231", "TRACE", "4.3.8")}}</td> + <td>Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content</td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilidade_do_Navegador">Compatibilidade do Navegador</h2> + +<p class="hidden">The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> and send us a pull request.</p> + +<p>{{Compat("http.methods.TRACE")}}</p> + +<h2 id="Veja_também">Veja também</h2> + +<ul> + <li><a href="/en-US/docs/Web/HTTP/Methods">HTTP methods</a></li> +</ul> + +<p> </p> |