Códigos de Status HTTP
Em poucas palavras, existem apenas 3 resultados na interação entre seu aplicativo e nossa API:
• Tudo funcionou
• O aplicativo fez algo errado
• A API fez algo errado
• A API Infradesk 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 Infradesk.
A tabela a seguir contém os valores mais comuns para os códigos de status HTTP retornados pela API:
| HTTP STATUS CODE | Texto | Descrição |
|---|---|---|
| 200 | OK | Tudo funcionou conforme o esperado. |
| 201 | Created | A requisição foi bem sucedida e um novo recurso foi criado. |
| 304 | Not Modified | Não havia dados novos para retornar. |
| 400 | Bad Request | A requisição foi invalida ou não atingiu o servidor. Muitas vezes, falta um parâmetro obrigatório. |
| 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. Uma mensagem de erro que acompanha a mensagem explica o porquê. |
| 404 | Not Found | A URI solicitada é inválida ou o recurso solicitado, como por exemplo, um vendedor não existe ou foi excluído. |
| 500 | Internal Server Error | Algo está quebrado. Por favor, assegure-se de que a equipe da Infradesk esteja investigando. |
| 502 | Bad Gateway | A Infradesk caiu ou está sendo atualizada |