Códigos de Status HTTP
Em poucas palavras, existem apenas 3 resultados na integração entre seu aplicativo e nossa API:
- Tudo funcionou
- O aplicativo fez algo errado
- A API fez algo errado
- A API Legacy Bank tenta retornar códigos de status de resposta HTTP apropriados para cada solicitação.
Em geral, os códigos no intervalo 2xx indicam sucesso, os códigos no intervalo 4xx indicam um erro resultante das informações fornecidas (por exemplo, um parâmetro necessário faltou, uma transação falhou, etc.) e os códigos no intervalo 5xx indicam um erro com os servidores da Legacy Bank.
A tabela a seguir contém os valores mais comuns para os códigos de status HTTP retornados pela API:
| HTTP STATUS CODE | STATUS | DESCRIÇÃO |
|---|---|---|
| 200 | OK | Tudo funcionou conforme esperado. |
| 201 | Created | A requisição foi bem-sucedida e um novo recurso foi criado. |
| 202 | Accepted | A requisição foi bem-sucedida e o recurso foi aceito. |
| 204 | No Content | A requisição foi bem-sucedida e o retorno sem conteúdo. |
| 400 | Bad Request | A requisição foi inválida ou não atingiu o servidor. |
| 401 | Unauthorized | As credenciais de autenticação estavam faltando ou foram incorretas |
| 402 | Request Failed | Os parâmetros foram válidos, mas a requisição falhou. |
| 403 | Forbidden | A requisição foi ok, mas foi recusado ou o acesso não foi permitido. |
| 404 | Not Found | A URI solicitada é inválida ou o recurso solicitado, como por exemplo, um comprador não existe ou foi excluído. |
| 405 | Method Not Allowed | A URI solicitada é válida, mas o método da requisição não é permitido. |
| 408 | Request Timeout | A URI solicitada é válida, mas o tempo de requisição ultrapassou o limite permitido. |
| 412 | Precondition Failed | A URI solicitada é válida, mas alguma condição não foi satisfatória. |
| 422 | Unprocessable Content | A URI solicitada é válida, mas um ou mais parâmetros estão inválidos, por exemplo: customer_id não informado ou não segue os requisitos da requisição. |
| 428 | Precondition Required | A URI solicitada é válida, mas algum parâmetro obrigatório está faltando ou alguma condição não foi satisfatória. |
| 429 | Too Many Requests | A URI solicitada é válida, mas foram realizadas muitas requisições ao mesmo tempo ou com um curto intervalo. |
| 500 | Internal Server Error | Algo está quebrado. Por favor, assegure-se de que a equipe Legacy Bank esteja investigando. |
| 502 | Bad Gateway | A Legacy Bank caiu ou está sendo atualizada. |
| 503 | Service Unavailable | A Legacy Bank caiu ou está sendo atualizada. |