Erros e solução de problemas
Use o status HTTP e o código de erro para entender o que aconteceu e decidir o próximo passo.
Leia uma resposta de erro#
Os erros da Connect API incluem um code estável, uma message legível e um request_id para investigação.
{
"code": "token_expired",
"message": "Token has expired.",
"request_id": "example-request-id"
}Códigos de status comuns#
| Status | O que verificar |
|---|---|
400 Requisição inválida | Verifique parâmetros obrigatórios, formato de data e hora, período, IDs de sensores e paginação. Use o código de erro para identificar a entrada inválida. |
401 Não autorizado | missing_token: adicione o cabeçalho Bearer. invalid_token: verifique o token e o ambiente. token_expired ou token_revoked: crie um novo token no IRIS Cloud. |
404 Não encontrado | Verifique o ID do recurso e se ele pertence à organização do token. Algumas requisições também exigem uma configuração de máquina disponível. |
501 Não implementado | A integração de registros de ações ainda não está disponível. |
502 / 503 / 504 | Um serviço necessário falhou, está indisponível ou excedeu o tempo limite. Para falhas temporárias, tente novamente com espera progressiva e um limite de tentativas. Guarde o ID da requisição se o problema persistir. |
A referência de cada endpoint lista suas respostas exatas e exemplos de erros.
Quando o Swagger não consegue acessar a API#
Se o Swagger mostrar Failed to fetch sem uma resposta HTTP, verifique o endereço da API, sua conexão de rede e eventuais requisitos de VPN. Requisições do navegador também exigem que a API permita a origem do site de documentação via CORS.
Tente a requisição equivalente com cURL. Se funcionar no cURL, mas não no navegador, informe essa diferença ao administrador. Um erro de conexão do navegador não significa necessariamente que o token é inválido.
Inclua as informações certas ao pedir ajuda#
Entre em contato com seu suporte habitual do IRIS Cloud ou com o administrador da organização. Informe ambiente, endpoint, status HTTP, código de erro, ID da requisição e horário da chamada. Remova tokens e dados confidenciais das respostas antes de compartilhar.