Dinaup DocsErrores API
Los errores que devuelve la API de la empresa: los últimos con su detalle, los errores únicos y su distribución por función, clave e IP.
Desarrollo → Monitorización → Errores API muestra las llamadas a la API que terminaron en error. Los datos salen de la sección Registro de Errores API: un registro por error, con la función, la aplicación, la IP, la clave API y el detalle.
Antes de empezar
- La aplicación Desarrollo en la licencia y el interruptor Desarrollador en tu usuario. Ver Desarrollo.
El rango de tiempo
En la cabecera, un desplegable fija el periodo: Último minuto, Últimos 5 minutos, Últimos 15 minutos, Última hora (el valor inicial), Últimas 6 horas, Últimas 24 horas, Últimos 7 días y Últimos 30 días (máx). El botón de refrescar recarga el contador, la lista y las gráficas.
El rango se aplica al contador Total errores y a las gráficas. La lista Últimos errores no lo usa: trae 100 errores, ordenados del más nuevo al más antiguo, sea cual sea el rango.
Total errores
El número de errores en el rango.
Últimos errores
Una tabla de 20 filas por página, con orden por columna:
| Columna | Qué contiene |
|---|---|
| Fecha | Cuándo ocurrió. |
| Función | La función de la API que falló. |
| Aplicación | La aplicación que hizo la llamada. |
| IP | La dirección de origen. |
| Clave API | La clave con la que se autenticó la llamada. |
| Detalles | El mensaje de error completo. |
Sin errores, la tarjeta dice Sin errores en este rango: "No se han registrado errores API en el periodo seleccionado."
Errores únicos
Lista de diferentes errores agrupa los errores por su detalle y cuenta las Ocurrencias de cada uno, hasta 50 mensajes distintos, en barras. La gráfica muestra si se repite el mismo error o si son errores distintos.
Distribución de errores
| Gráfica | Qué muestra |
|---|---|
| Errores por función | Las 15 funciones con más errores. |
| Errores por aplicación | Las 10 aplicaciones con más errores, en anillo. |
| Errores por clave API | Las 10 claves con más errores, en barras. |
| Errores por IP origen | Las 10 direcciones IP con más errores, en barras. |
Qué hacer con un error
- Lee Detalles: es el mensaje que devolvió la API.
- Revisa Clave API y Función: dicen qué integración falló y en qué llamada.
- Reproduce la llamada en Webhooks Entrantes con la misma clave: el playground muestra la respuesta completa.
- Si el error es de autenticación o de permisos, revisa la clave en Claves API: que exista, que tenga Compatible WebHook si la usan los webhooks y que tenga permiso sobre la sección. Un cambio tarda hasta dos minutos en aplicarse.
- Si el error es de formato, comprueba los valores con la tabla de formatos de Webhooks Entrantes y los códigos de respuesta de la Referencia de endpoints.