Errores y solución de problemas
Usa el estado HTTP y el código de error para entender qué ha ocurrido y decidir el siguiente paso.
Lee una respuesta de error#
Los errores de la Connect API incluyen un code estable, una message legible y un request_id para investigar el problema.
{
"code": "token_expired",
"message": "Token has expired.",
"request_id": "example-request-id"
}Códigos de estado habituales#
| Estado | Qué comprobar |
|---|---|
400 Solicitud no válida | Comprueba los parámetros obligatorios, el formato de fecha y hora, el período, los IDs de sensores y la paginación. Usa el código de error para identificar la entrada no válida. |
401 No autorizado | missing_token: añade la cabecera Bearer. invalid_token: comprueba el token y el entorno. token_expired o token_revoked: crea un nuevo token en IRIS Cloud. |
404 No encontrado | Comprueba el ID del recurso y que pertenezca a la organización del token. Algunas solicitudes también requieren una configuración de máquina disponible. |
501 No implementado | La integración de registros de acciones aún no está disponible. |
502 / 503 / 504 | Un servicio necesario falló, no está disponible o superó el tiempo de espera. Ante fallos temporales, vuelve a intentarlo con esperas progresivas y un límite de intentos. Guarda el ID de la solicitud si el problema persiste. |
La referencia de cada endpoint enumera sus respuestas exactas y ejemplos de errores.
Cuando Swagger no puede acceder a la API#
Si Swagger muestra Failed to fetch sin una respuesta HTTP, comprueba la dirección de la API, tu conexión de red y los posibles requisitos de VPN. Las solicitudes del navegador también requieren que la API permita el origen del sitio de documentación mediante CORS.
Prueba la solicitud equivalente con cURL. Si funciona con cURL pero falla en el navegador, informa de esta diferencia al administrador. Un error de conexión del navegador no significa necesariamente que el token no sea válido.
Incluye la información adecuada al pedir ayuda#
Contacta con tu soporte habitual de IRIS Cloud o con el administrador de la organización. Indica el entorno, el endpoint, el estado HTTP, el código de error, el ID de la solicitud y su hora. Elimina los tokens y los datos confidenciales de las respuestas antes de compartirlos.