Solución de problemas
Cómo diagnosticar
Verifique el servicio
Confirme que el servicio stcpgemini-api está en ejecución (systemctl status stcpgemini-api) y que el host y el puerto usados son los del config.json de la API.
Anote el estado HTTP
El estado indica la clase del problema. Vea Códigos de respuesta.
Busque el síntoma
Consulte los problemas comunes.
Problemas comunes
La conexión con la API falla o da error de certificado
Síntoma: el cliente no se conecta o rechaza el certificado.
Causa probable: puerto incorrecto, TLS deshabilitado (ssl: false o -ns) o certificado no confiable para el cliente.
Solución: verifique host, port, ssl, cert y key en la sección general del config.json de la API y use el esquema correspondiente (http o https).
El endpoint de token devuelve 400 o 401
Síntoma: POST /oauth/token no devuelve el access_token.
Causa probable: cuerpo fuera del formato application/x-www-form-urlencoded, grant_type distinto de password o credenciales del operador no válidas.
Solución: envíe grant_type=password, username y password como formulario y verifique el operador en el Portal.
Las llamadas devuelven 401 después de un tiempo
Síntoma: las llamadas que funcionaban pasan a devolver 401.
Causa probable: el token caducó o fue invalidado por un cierre de sesión.
Solución: obtenga un nuevo token y repita la llamada.
El informe devuelve data nulo
Síntoma: la respuesta es {"data": null, "next": ""}.
Causa probable: no hay registros en el período o los filtros no corresponden a los datos. Es común enviar start y end en segundos en lugar de milisegundos.
Solución: envíe las fechas en milisegundos y verifique instance, user y los demás filtros.
El operador no puede acceder a un recurso
Síntoma: el token se emite, pero la llamada se rechaza.
Causa probable: el operador no tiene permiso sobre el grupo de recursos (vea el campo scope del token).
Solución: ajuste los permisos del operador en el Riversoft® Console Portal.