Solução de problemas
Como diagnosticar
Verifique o serviço
Confirme que o serviço stcpgemini-api está em execução (systemctl status stcpgemini-api) e que o host e a porta usados são os do config.json da API.
Anote o status HTTP
O status indica a classe do problema. Veja Códigos de resposta.
Procure o sintoma
Consulte os problemas comuns.
Problemas comuns
A conexão com a API falha ou dá erro de certificado
Sintoma: o cliente não conecta ou rejeita o certificado.
Causa provável: porta incorreta, TLS desabilitado (ssl: false ou -ns) ou certificado não confiável para o cliente.
Solução: confira host, port, ssl, cert e key na seção general do config.json da API e use o esquema (http ou https) correspondente.
O endpoint de token retorna 400 ou 401
Sintoma: POST /oauth/token não devolve o access_token.
Causa provável: corpo fora do formato application/x-www-form-urlencoded, grant_type diferente de password ou credenciais do operador inválidas.
Solução: envie grant_type=password, username e password como formulário e confirme o operador no Portal.
As chamadas retornam 401 depois de algum tempo
Sintoma: chamadas que funcionavam passam a retornar 401.
Causa provável: o token expirou ou foi invalidado por um logout.
Solução: obtenha um novo token e repita a chamada.
O relatório retorna data nulo
Sintoma: a resposta é {"data": null, "next": ""}.
Causa provável: não há registros no período ou os filtros não correspondem aos dados. É comum enviar start e end em segundos em vez de milissegundos.
Solução: envie as datas em milissegundos e confira instance, user e os demais filtros.
O operador não consegue acessar um recurso
Sintoma: o token é emitido, mas a chamada é recusada.
Causa provável: o operador não tem permissão sobre o grupo de recursos (veja o campo scope do token).
Solução: ajuste as permissões do operador no Riversoft® Console Portal.