1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
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 -> Adiciona a 2ª linha
POST /add_row HTTP/1.1 -> 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 -> Retorna 200 se idX existe
DELETE /idX/delete HTTP/1.1 -> Retorna 404 como ele acabou de ser deletado
DELETE /idX/delete HTTP/1.1 -> Retorna 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>
|
