aboutsummaryrefslogtreecommitdiff
path: root/files/pt-br/glossary/idempotent/index.html
diff options
context:
space:
mode:
authorFlorian Dieminger <me@fiji-flo.de>2021-02-11 18:27:17 +0100
committerGitHub <noreply@github.com>2021-02-11 18:27:17 +0100
commitad7f998115dd568832332484debf1f1b16b0c905 (patch)
tree2f3a9137e20731b7f6880fe5adb31fa439215d7d /files/pt-br/glossary/idempotent/index.html
parent7a94b4d8daf297eda6df8e5cf933f7ba159bbc76 (diff)
parent1d435be33d8b76cd7b06cd06996c19d74f83cfd4 (diff)
downloadtranslated-content-ad7f998115dd568832332484debf1f1b16b0c905.tar.gz
translated-content-ad7f998115dd568832332484debf1f1b16b0c905.tar.bz2
translated-content-ad7f998115dd568832332484debf1f1b16b0c905.zip
Merge pull request #41 from fiji-flo/unslugging-pt-br
Unslugging pt br
Diffstat (limited to 'files/pt-br/glossary/idempotent/index.html')
-rw-r--r--files/pt-br/glossary/idempotent/index.html52
1 files changed, 52 insertions, 0 deletions
diff --git a/files/pt-br/glossary/idempotent/index.html b/files/pt-br/glossary/idempotent/index.html
new file mode 100644
index 0000000000..8a23e78e11
--- /dev/null
+++ b/files/pt-br/glossary/idempotent/index.html
@@ -0,0 +1,52 @@
+---
+title: Idempotente
+slug: Glossary/Idempotent
+tags:
+ - Glossary
+ - Glossário
+ - Mecânicas da Web
+ - WebMechanics
+translation_of: Glossary/Idempotent
+original_slug: Glossario/Idempotente
+---
+<p>Um método HTTP é <strong>idempotente</strong> se uma requisição idêntica pode ser feita uma ou mais vezes em sequência com o mesmo efeito enquanto deixa o servidor no mesmo estado. Em outras palavras, um método idempotente não deveria possuir nenhum efeito colateral (exceto para manter estatísticas). Implementados corretamente, o {{HTTPMethod("GET")}}, {{HTTPMethod("HEAD")}}, {{HTTPMethod("PUT")}}, e {{HTTPMethod("DELETE")}} são métodos <strong>idempotentes</strong>, mas não o método {{HTTPMethod("POST")}}. Todos os métodos  {{glossary("seguro")}}s também são idempotentes.</p>
+
+<p>Para ser idempotente, somente o estado atual do <em>back-end</em> de um servidor deve ser considerado, o código de status retornado por cada requisição pode variar: a primeira chamada de um {{HTTPMethod("DELETE")}} vai provavelmente retornar um {{HTTPStatus("200")}}, enquanto as chamadas sucessivas vão provavelmente retornar {{HTTPStatus("404")}}. Outra implicação do {{HTTPMethod("DELETE")}} ser idempotente é de que os desenvolvedores não deveriam implementar APIs RESTful com a<em> </em>funcionalidade de deleção de última entrada usando o método <code>DELETE</code>.</p>
+
+<p>Note que a idempotência de um método não é garantida pelo servidor, algumas aplicações também podem quebrar a constante de idempotência.</p>
+
+<p><code>GET /pageX HTTP/1.1</code> é idempotente. Chamado diversas vezes em sequência, ele vai retornar o mesmo resultado:</p>
+
+<pre>GET /pageX HTTP/1.1
+GET /pageX HTTP/1.1
+GET /pageX HTTP/1.1
+GET /pageX HTTP/1.1
+</pre>
+
+<p><code>POST /add_row HTTP/1.1</code> não é idempotente. Se ele for chamado diversas vezes, ele adicionará novas entradas:</p>
+
+<pre>POST /add_row HTTP/1.1
+POST /add_row HTTP/1.1 -&gt; Adiciona a 2ª linha
+POST /add_row HTTP/1.1 -&gt; Adiciona a 3ª linha
+</pre>
+
+<p><code>DELETE /idX/delete HTTP/1.1</code> é idempotente, mesmo que o código de status mude entre requisições:</p>
+
+<pre>DELETE /idX/delete HTTP/1.1 -&gt; Retorna 200 se idX existe
+DELETE /idX/delete HTTP/1.1 -&gt; Returna 404 como ele acabou de ser deletado
+DELETE /idX/delete HTTP/1.1 -&gt; Returna 404</pre>
+
+<h2 id="Aprenda_mais">Aprenda mais</h2>
+
+<h3 id="Conhecimento_geral">Conhecimento geral</h3>
+
+<ul>
+ <li>Definição de <a href="https://tools.ietf.org/html/rfc7231#section-4.2.2">idempotente</a> na especificação HTTP.</li>
+</ul>
+
+<h3 id="Conhecimento_técnico">Conhecimento técnico</h3>
+
+<ul>
+ <li>Descrição de métodos idempotentes comuns: {{HTTPMethod("GET")}}, {{HTTPMethod("HEAD")}}, {{HTTPMethod("PUT")}}, {{HTTPMethod("DELETE")}}, {{HTTPMethod("OPTIONS")}}, {{HTTPMethod("TRACE")}}</li>
+ <li>Descrição de métodos não-idempotentes comuns: {{HTTPMethod("POST")}},{{HTTPMethod("PATCH")}}, {{HTTPMethod("CONNECT")}}</li>
+</ul>