Monitorea claves de API: logs y uso
Inspecciona los logs de solicitudes de la Developer API y las estadísticas de uso — conteo de solicitudes por clave y por ruta, tasas de error y latencia — para depurar integraciones y detectar abuso.
- 1
Qué puedes monitorear
Las solicitudes de cada clave de API para desarrolladores: conteos por clave y por ruta, tasa de error, latencia, y registros de solicitudes individuales con IDs de solicitud.
- 2
Abre Settings → API
La sección API tiene tres pestañas: API Keys, Logs y Usage. Esta sección es solo para admin/owner — los demás roles ven un aviso de que la gestión de claves está restringida.
- 3
Lee la pestaña Usage
Totales sobre una ventana móvil (por defecto 7 días): solicitudes totales y tasa de error general, luego un desglose por clave y por ruta para que veas qué clave o endpoint genera más tráfico y errores.
- 4
Profundiza en la pestaña Logs
Cada fila de solicitud muestra el método, el patrón de ruta, el status HTTP, la latencia (ms), el prefijo de clave que la hizo, un código de error (si lo hay) y un ID de solicitud para soporte.
- 5
Depura una integración que falla
Revisa Logs en busca de valores de
statusdistintos de 2xx, lee elerrorCode, y relaciona elkeyPrefixcon la clave que está causando el daño. Cita elrequestIdal contactar a soporte. - 6
Detecta abuso o un script descontrolado
Un pico en las solicitudes de una sola clave en el desglose by key, o una tasa de error en aumento en Usage, es tu señal para revocar esa clave en la pestaña API Keys y emitir una nueva con el alcance adecuado.
Consejos de experto
Atajos aprendidos a fuerza de experiencia para mantener el precalentamiento en curso.
Empieza en Usage, luego entra a Logs
Usa Usage para ver la forma del problema — qué clave, qué ruta, qué tan grave — y luego pasa a Logs para las solicitudes individuales que fallaron. De arriba hacia abajo es más rápido que desplazarse por registros en crudo.
El ID de solicitud es lo que necesita soporte
Copia el ID de solicitud de una fila de registro fallida en vez de describir "un 500 en algún momento de hoy" — es la forma más rápida de obtener ayuda.
Revisa los alcances antes de culpar a la API
Una tasa de error creciente en una clave suele significar una suposición vencida en esa integración (campo renombrado, alcance revocado) — revisa primero los alcances de esa clave.
Verifica el rol antes de depurar el acceso
Solo los admins/owners ven esta sección; si un compañero de equipo "no encuentra los registros de API", revisa su rol antes de asumir que algo está roto.
Preguntas frecuentes
¿FirstSales expone registros de solicitudes de API?
Sí — Settings → API → Logs muestra, por solicitud, el método, la ruta, el status, la latencia, el prefijo de clave, el código de error y un ID de solicitud.
¿Dónde veo cuánto se usan mis claves?
La pestaña Usage: solicitudes totales, tasa de error, y desgloses por clave y por ruta durante una ventana móvil (7 días por defecto).
¿Quién puede ver los registros y el uso de la API?
Solo los admins y owners de la organización. Los demás roles ven un aviso de que la gestión de claves es exclusiva de admin/owner.
¿Cómo depuro una llamada de API que falla?
En Logs, encuentra la solicitud por un status distinto de 2xx, lee su errorCode, anota el keyPrefix y el requestId, y comparte ese ID con soporte.
Una clave parece comprometida — ¿qué hago?
Revócala en la pestaña API Keys y emite una nueva con solo los alcances que necesita; observa los conteos por clave en Usage para confirmar que el tráfico se detiene.
¿Puedo cambiar la ventana de uso?
La vista de Usage usa por defecto los últimos 7 días. Usa la pestaña Logs (con sus filtros) para una inspección más acotada a nivel de solicitud.
¿Listo para ponerlo en práctica?
Comienza tu prueba de FirstSales y lanza un buzón precalentado y autenticado en minutos.
Empieza por $1