Resumen

La página de logs de API te muestra lo que está sucediendo con tu actividad de API en tiempo real, en toda tu cuenta. Está diseñada para darte tranquilidad y que puedas ver rápidamente qué está funcionando, detectar problemas a tiempo y entender cómo se están comunicando tus sistemas.

Los logs se guardan durante 7 días e incluyen:

Solicitudes exitosas
Solicitudes fallidas
Logs detallados para cada solicitud
Cargas útiles completas de la solicitud y la respuesta

Puedes usar esta página para comprobar si las solicitudes se entregaron con éxito, investigar cualquier error y seguir la actividad en todos tus servicios conectados, todo desde una vista sencilla.

Cómo acceder a la página de logs de API

En el menú de la izquierda, busca Desarrolladores.
Haz clic en Herramientas para desarrolladores > Logs de API

Componentes

1. Índice: 'Tu actividad reciente'

Estas métricas te dan visibilidad instantánea del uso de tu API.
Muestra los números generales para el intervalo de fechas seleccionado:

Total de solicitudes: Todas las solicitudes de API realizadas.
Exitosas: Solicitudes que devuelven los estados 200 y 201
Fallidas: Solicitudes que devuelven los estados 400, 401, 403, 404 y 50

2. Búsqueda, filtros y aplicar

La función de búsqueda y filtros te ayuda a encontrar rápidamente los logs que estás buscando. Puedes buscar por palabras clave, filtrar por estado o delimitar por fecha para centrarte en las solicitudes que más importan.

Esta funcionalidad se aplica a las cuatro páginas de logs que se cargan inicialmente. Para buscar o filtrar entre más registros, simplemente carga páginas adicionales haciendo clic en las páginas siguientes; tu búsqueda y filtros se aplicarán entonces también a los logs recién cargados.

Buscar
Escribe palabras completas o parciales, y la búsqueda examinará todos los siguientes campos para ser de ayuda y que encuentres rápidamente lo que necesitas.
Aquí están las posibles opciones de búsqueda:
- Punto de conexión de API: La ruta específica de la API que se está llamando.
- ID de solicitud: Un identificador único que se asigna automáticamente a cada solicitud de API.
- Origen: De dónde se originó la solicitud (p. ej., API, panel de control, subcuenta).
- Cuerpo: El contenido de la solicitud, incluyendo el texto del mensaje y los parámetros.
- País: El país de destino del mensaje basado en el número del destinatario.
- ID del remitente: El valor "de" utilizado al enviar el mensaje (alfanumérico o numérico).
- Código de respuesta: El código numérico del sistema devuelto después del procesamiento de la solicitud.
- Mensaje de respuesta: Un breve mensaje explicando el código de respuesta.
- Código de error: el estado HTTP de la llamada
- Mensaje de error: Una breve explicación de lo que causó el error.
- ID de mensaje: El identificador único para el mensaje individual una vez puesto en cola o enviado.
Filtros
- Estado: Filtrar por éxito, errores de cliente o errores de servidor.
- Punto de conexión: Filtrar por p. ej., /v3/sms/send, /v3/mms/send, /v3/sms/history, etc.
- Subcuenta: Por defecto, será tu subcuenta.
- Intervalo de fechas: Solo guardamos los logs durante 7 días Puedes seleccionar entre estas opciones:
  - Hoy
  - Últimas 12 horas
  - Últimas 24 horas
  - Hace 2 días
  - Hace 3 días
  - Hace 4 días
  - Hace 5 días
  - Hace 6 días
“Nota: Cuando usas el filtro 'hace 2 días', este mostrará todos los logs de los últimos dos días, incluyendo hoy.
Botones
- Borrar filtros: Al restablecer se borran todos los filtros, incluida la Búsqueda.
- Aplicar: Usa esto para aplicar tus filtros y búsqueda actuales. Puedes hacer clic en 'Aplicar' o simplemente presionar Enter para ejecutar la búsqueda.

3. Tabla de logs

Muestra todas las solicitudes de API basadas en tus filtros. Las columnas incluyen:

Usa esta tabla para examinar rápidamente la actividad o identificar llamadas fallidas.

Ordenación:

Puedes ordenar por cualquier columna, como Marca de tiempo o Estado.
Hacer clic en un encabezado de columna alterna entre el pedido ascendente y descendente.
Esto te es de ayuda para agrupar errores, actividad reciente o puntos de conexión específicos de manera más eficiente.

Interacciones:

Hacer clic en una fila produce aperturas de los detalles completos de la solicitud en el panel derecho.
La paginación te permite navegar por todos los logs y carga los siguientes datos.
Actualizar tabla recarga los logs más recientes.
Ordenación sort

Paneles de logs detallados (paneles de metadatos, solicitud y respuesta)
Al seleccionar una fila, aparecen los detalles completos.

El panel de metadatos incluye:
- Método
- Estado
- Estado del mensaje (p. ej., 200 Éxito)
- ID de la solicitud
- Subcuenta
- Marca de tiempo
- Dirección IP del cliente
- Agente de usuario
Esta sección es una ayuda para identificar de dónde provino la solicitud (Postman, servidor, navegador, etc.).

Cuerpo de la solicitud
Muestra la carga útil exacta que se decidió enviar. Útil para:
- Depurar JSON mal formado
- Verificar parámetros
- Comprobar métodos de autenticación
Cuerpo de la respuesta
Muestra la respuesta exacta devuelta. Incluye:
- Códigos HTTP
- Mensajes de error
- Códigos de respuesta internos
- Datos de entrega y tarifas (si corresponde)
Esta es tu herramienta principal para solucionar problemas como fallos, errores de mensaje o cargas útiles incorrectas.

Casos de uso comunes

1. Depurar una llamada de API fallida

Abre el menú desplegable del filtro de Estado
Hacer clic en una fila con 400 o 500.
Revisión:
- Cuerpo de la respuesta (mensaje de error)
- Cuerpo de la solicitud (¿campos incorrectos?)
- Punto de conexión utilizado
- Subcuenta que fue su disparador

2. Confirmar que el SMS/servicio de mensajería multimedia se acaba de enviar con éxito

Filtro para el punto de conexión /v3/sms/send.
Verifica el estado 200.
Inspecciona el cuerpo de la respuesta → Message queued for delivery.

3. Reproducir o derivar problemas

Copia los cuerpos de la solicitud/respuesta directamente al realizar un informe de los problemas.

Consejos

Usa la búsqueda para encontrar rápidamente logs para un número de teléfono o palabra clave en específico.
Para un problema recurrente, compara información múltiple de logs en paralelo.
Los logs se pueden actualizar automáticamente al hacer clic en Actualizar tabla.
Usa el payload de la respuesta para comprender problemas de tarifas o de entrega.

Preguntas frecuentes

¿Qué es la página de logs de la API?

La página de logs de la API permite al desarrollador ver y supervisar todas las solicitudes de API realizadas a través de su cuenta. Es una ayuda para el seguimiento de la actividad de la solicitud, identificar errores y depurar integraciones en tiempo real.

¿Qué información puedo ver en los logs de la API?

Cada entrada de logs incluye detalles clave como:

Marca de tiempo: cuándo se realizó la solicitud
Punto de conexión: qué punto de conexión de API se llamó
Estado: si la solicitud tuvo éxito o falló
Código de respuesta: código de estado HTTP (p. ej., 200, 400, 500)
ID de la solicitud: un identificador único para cada solicitud

¿Qué son los contadores "Todos", "Exitoso" y "Fallido"?

Estos contadores resumen la actividad de tu solicitud de API:

Todos: muestra el número total de cada llamada de API realizada
Exitoso: muestra el recuento de solicitudes que se pudieron completar correctamente
Fallido: muestra el recuento de las solicitudes que resultaron en un error

¿Cómo funciona la paginación en la página de logs?

Los logs se pueden mostrar en páginas para que navegar sea más rápido y fácil.

Usa las opciones para controlar la paginación (p. ej., Siguiente, Anterior o páginas numeradas) para navegar por tu historial de logs.

¿Qué hace el botón "Actualizar"?

El botón de Actualizar recarga la tabla de logs para mostrar la actividad más reciente de la API sin tener que recargar todo el panel de control.

Esto es útil al realizar un seguimiento en vivo de la solicitud de API.

¿Con qué frecuencia se puede actualizar la información de los logs?

Los logs se suelen actualizar casi en tiempo real. Puedes hacer clic manualmente en Actualizar para obtener los últimos datos al instante.

¿Hasta cuándo puedo ver los logs de la API?

Puedes ver los logs de los últimos 7 días.

Los logs más antiguos se pueden archivar o eliminar automáticamente.

¿Puedo exportar mis logs de la API?

Actualmente, la funcionalidad de exportación podría no estar disponible directamente en la página.

¿Puedo buscar o aplicar un filtro a mis logs de la API?

Sí. Puedes usar el filtro en los logs por:

Estado (Exitoso, Fallido)
Rango de fechas
Punto de conexión
Búsqueda - escribe cualquier palabra clave

¿Qué debo hacer si falla una solicitud?

Te permitirá:

Hacer clic en la entrada de logs fallida para ver los detalles y mensajes de error
Verifica el código de respuesta y el cuerpo del error
Usa estos datos para solucionar problemas en tu integración de API

¿Quién puede acceder a la página de logs de la API?

La cuenta y la subcuenta pueden acceder y ver sus logs de la API. En esta versión, se ha desarrollado que las subcuentas solo pueden ver los suyos.

Guías de logs de la API