aboutsummaryrefslogtreecommitdiff
path: root/files/pt-pt/glossary/idempotent
diff options
context:
space:
mode:
authorFlorian Merz <me@fiji-flo.de>2021-02-11 14:50:24 +0100
committerFlorian Merz <me@fiji-flo.de>2021-02-11 14:50:24 +0100
commit2c2df5ea01eb5cd8b9ea226b2869337e59c5fe3e (patch)
tree86ab4534d10092b293d4b7ab169fe1a8a2421bfa /files/pt-pt/glossary/idempotent
parent8260a606c143e6b55a467edf017a56bdcd6cba7e (diff)
downloadtranslated-content-2c2df5ea01eb5cd8b9ea226b2869337e59c5fe3e.tar.gz
translated-content-2c2df5ea01eb5cd8b9ea226b2869337e59c5fe3e.tar.bz2
translated-content-2c2df5ea01eb5cd8b9ea226b2869337e59c5fe3e.zip
unslug pt-pt: move
Diffstat (limited to 'files/pt-pt/glossary/idempotent')
-rw-r--r--files/pt-pt/glossary/idempotent/index.html46
1 files changed, 46 insertions, 0 deletions
diff --git a/files/pt-pt/glossary/idempotent/index.html b/files/pt-pt/glossary/idempotent/index.html
new file mode 100644
index 0000000000..a84b97ecbd
--- /dev/null
+++ b/files/pt-pt/glossary/idempotent/index.html
@@ -0,0 +1,46 @@
+---
+title: Idempotent
+slug: Glossário/Idempotent
+translation_of: Glossary/Idempotent
+---
+<p>Um método HTTP é <strong>idempotente</strong> se, e só se, o mesmo pedido puder ser feito mais do que uma vez, tendo sempre o mesmo resultado e deixando o servidor no mesmo estado. Por outras palavras, um método idempotente não deve ter efeitos secundários. Implementados corretamente, os métodos {{HTTPMethod("GET")}}, {{HTTPMethod("HEAD")}}, {{HTTPMethod("PUT")}}, and {{HTTPMethod("DELETE")}} são <strong>idempotentes</strong>, mas não o método {{HTTPMethod("POST")}}. Todos os métodos {{glossary("safe")}} também são idempotentes.</p>
+
+<p>Para ser idempotente, apenas o "back-end" do servidor é considerado, sendo que o estado retornado por cada pedido pode diferir: a primeira chamada de {{HTTPMethod("DELETE")}} deve retornar {{HTTPStatus("200")}}, enquanto as sucessivas devem retornar {{HTTPStatus("404")}}. Outra implicação de o {{HTTPMethod("DELETE")}} ser idempotente é que os programadores não devem implementar APIs RESTful com a funcionalidade de <em>apagar última entrada</em> usando o método de <code>DELETE</code>.</p>
+
+<p>É de notar que a idempotência de um método não é garantida pelo servidor e algumas aplicações podem incorretamente violar a constrição de idempotência.</p>
+
+<p><code>GET /pageX HTTP/1.1</code> é idempotente. Com várias chamadas ao servidor, o cliente obtém os mesmos resultados:</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; com várias chamadas ao servidor, adiciona novas linhas:</p>
+
+<pre>POST /add_row HTTP/1.1
+POST /add_row HTTP/1.1 -&gt; Adiciona uma 2ª linha
+POST /add_row HTTP/1.1 -&gt; Adiciona uma 3ª linha
+</pre>
+
+<p><code>DELETE /idX/delete HTTP/1.1</code> é idempotente, mesmo que o estado de retorno seja diferente entre cada chamada:</p>
+
+<pre>DELETE /idX/delete HTTP/1.1 -&gt; Returns 200 se idX existir
+DELETE /idX/delete HTTP/1.1 -&gt; Returns 404 visto que idX acabou de ser apagado
+DELETE /idX/delete HTTP/1.1 -&gt; Returns 404</pre>
+
+<h2 id="Saber_mais">Saber mais</h2>
+
+<h3 id="Conhecimento_comum">Conhecimento comum</h3>
+
+<ul>
+ <li>Definição de "<a href="https://tools.ietf.org/html/rfc7231#section-4.2.2">idempotent</a>" na especificação de HTTP.</li>
+</ul>
+
+<h3 id="Conhecimento_técnico">Conhecimento técnico</h3>
+
+<ul>
+ <li>Alguns métodos idempotentes comuns: {{HTTPMethod("GET")}}, {{HTTPMethod("HEAD")}}, {{HTTPMethod("PUT")}}, {{HTTPMethod("DELETE")}}, {{HTTPMethod("OPTIONS")}}, {{HTTPMethod("TRACE")}}</li>
+ <li>Alguns métodos não-idempotentes comuns: {{HTTPMethod("POST")}},{{HTTPMethod("PATCH")}}, {{HTTPMethod("CONNECT")}}</li>
+</ul>