Sobre o 200 OK
Visão Geral do 200 OK
| Requisição Bem-SucedidaCódigo de Status HTTP | ||
|
200 OK Visão Geral O código de status 200 OK indica que a requisição do cliente foi processada com sucesso e que o servidor retornou uma resposta confirmando este sucesso. Este código é amplamente utilizado em diferentes cenários, como ao recuperar recursos com requisições GET ou confirmar o processamento bem-sucedido de requisições POST. |
||
|
Significado A requisição do cliente foi processada com sucesso, e o servidor retornou o recurso ou informação solicitada. |
Quando o 200 OK é Retornado?
- Quando uma requisição GET é processada com sucesso e o recurso solicitado é retornado
- Quando uma requisição POST é bem-sucedida e o servidor retorna o resultado
- Quando uma requisição a uma API é bem-sucedida e os dados esperados estão incluídos na resposta
Exemplos do 200 OK
Sucesso em uma Requisição GET
GET /index.html HTTP/1.1 Host: example.com
Exemplo de resposta:
HTTP/1.1 200 OK Content-Type: text/html; charset=UTF-8 <html> <head><title>Example</title></head> <body><p>Hello, world!</p></body> </html>
Explicação: Isso ocorre quando um cliente realiza uma requisição GET para um recurso específico (por exemplo, index.html), e o servidor processa a requisição com sucesso, retornando o conteúdo do recurso.
Sucesso em uma Requisição a uma API
GET /api/user/123 HTTP/1.1 Host: example.com
Exemplo de resposta:
HTTP/1.1 200 OK
Content-Type: application/json
{
"id": 123,
"name": "John Doe",
"email": "john.doe@example.com"
}
Explicação: Isso ocorre quando um cliente envia uma requisição a um endpoint de API, e o servidor processa corretamente a requisição, retornando os dados em formato JSON.
Pontos Importantes
Considerações ao usar o código de status 200 OK:
- Retorne respostas significativas
Embora o 200 OK indique uma requisição bem-sucedida, o conteúdo da resposta deve ser significativo para evitar confundir o cliente. - Esclareça a disponibilidade do recurso
Retorne 200 OK apenas quando o recurso for processado com sucesso. Se o processamento não estiver completo, use um código de erro apropriado.
Comparação com Outros Códigos de Status HTTP
Explicação de códigos relacionados ao 200 OK:
- 201 Created: Usado quando uma requisição é bem-sucedida e um novo recurso é criado.
- 204 No Content: Usado quando uma requisição é bem-sucedida, mas o corpo da resposta está vazio.
Compreender essas diferenças ajuda a usar corretamente o código de status 200.