aboutsummaryrefslogtreecommitdiff
path: root/files/pt-br/web/http/methods/options
diff options
context:
space:
mode:
authorPeter Bengtsson <mail@peterbe.com>2020-12-08 14:42:52 -0500
committerPeter Bengtsson <mail@peterbe.com>2020-12-08 14:42:52 -0500
commit074785cea106179cb3305637055ab0a009ca74f2 (patch)
treee6ae371cccd642aa2b67f39752a2cdf1fd4eb040 /files/pt-br/web/http/methods/options
parentda78a9e329e272dedb2400b79a3bdeebff387d47 (diff)
downloadtranslated-content-074785cea106179cb3305637055ab0a009ca74f2.tar.gz
translated-content-074785cea106179cb3305637055ab0a009ca74f2.tar.bz2
translated-content-074785cea106179cb3305637055ab0a009ca74f2.zip
initial commit
Diffstat (limited to 'files/pt-br/web/http/methods/options')
-rw-r--r--files/pt-br/web/http/methods/options/index.html122
1 files changed, 122 insertions, 0 deletions
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>