¿Qué son los registros API?
Son el historial de cada llamada realizada a la API en su espacio de trabajo: método, punto final, cuerpo de la solicitud, respuesta y estado HTTP. Piense en el extracto de una tarjeta: no muestra si el mensaje llegó al cliente, pero muestra cada transacción entre su sistema y Notifique.¿Para qué sirven?
Con los registros puedes:- Depurar errores 401, 403 o 400 en tu integración
- Auditar qué clave API realizó cada llamada
- Ver solicitud y respuesta exactas (con datos confidenciales enmascarados)
- Filtrar por estado, método, fecha o clave
- Compruebe con [Respuestas de error](/es/guides/conceitos/resposta-de-erros para entender el
codedevuelto
Registros frente a webhooks
Se complementan entre sí; uno no reemplaza al otro:Los webhooks notifican lo que sucedió con un mensaje (entregado, fallido, leído). Registros de API registran quién llamó a la API y qué devolvió la API en el momento de la solicitud.
Cómo consultar
En el tablero
- Abra Registros en la barra lateral (o desde Centro de desarrolladores)
- Seleccione el espacio de trabajo (si tiene más de uno)
- Filtrar por estado, método o fecha
- Haga clic en un elemento para ver la solicitud y la respuesta completas.
A través de API
1. Permiso
La clave necesita alcancelogs:read. Los registros se limitan al espacio de trabajo de la clave.
2. Listar registros
Devuelve el historial paginado del espacio de trabajo. Paginated response (pagination.total, pagination.page, pagination.limit, pagination.totalPages). Each item includes:
3. Filter results
Example filtering 403 errors on POST:
Próximos pasos
- Respuestas de error: códigos HTTP y
code - Claves API: alcances y
logs:read - Webhooks: estado de entrega en tiempo real
- Espacios de trabajo: donde se encuentran los registros del espacio de trabajo

