Registros

Resumen

Registros es la página donde puede ver todos los registros de llamadas API de un endpoint en un solo lugar. Puede verificar el éxito o fallo de las solicitudes, los payloads enviados, el estado de entrega de los webhooks y los mensajes de error.

Los entornos Sandbox y Producción están separados en pestañas, por lo que puede dar seguimiento a las llamadas de prueba y a las llamadas en operación real de forma independiente.

Cómo llegar aquí

• Menú superior Registros → Seleccione un endpoint de la lista
• Enlace Ver registros en la barra lateral derecha de los detalles del endpoint

---

Lista de endpoints

Al abrir por primera vez la página de Registros, verá la lista de endpoints. Resume el estado de los registros por endpoint.

Columna	Descripción
Endpoint	Nombre del endpoint
Total de registros	Número total de llamadas de este endpoint
Tasa de éxito	Porcentaje de llamadas exitosas
Última actividad	Hora de la llamada más reciente (relativa)

Haga clic en un endpoint para ir a su página de registros detallados.

Encabezado de la página de detalle

Cuando selecciona un endpoint, los siguientes elementos aparecen en la parte superior.

• Nombre del endpoint y descripción
• Botón Ver detalles de la API — Va a la página de Detalles del endpoint
• Botón Limpiar datos de Sandbox — Elimina permanentemente los registros de llamadas y estadísticas de uso de Sandbox de este endpoint
  • Cuando un colaborador accede, aparece como Limpiar mis datos de Sandbox y solo elimina los registros generados por él
  • No afecta los datos de Producción
• Pestañas de entorno Sandbox | Producción — Visualice los registros de cada entorno de forma independiente (Más información sobre las pestañas de entorno)

---

Filtros de búsqueda

El área de búsqueda tiene dos pestañas: Búsqueda por período y Búsqueda por campo.

Búsqueda por período

Filtre los registros por rango de tiempo y estado.

• Campo de fecha — Elija Procesado el o Creado el. El valor predeterminado es Procesado el
• Fecha de inicio / Fecha de fin — Especifique el rango de tiempo
• Estado — Elija Todos / Éxito / Fallido
• Clave de colaboración — Todas o una clave de colaboración específica (muestra solo las llamadas realizadas con esa clave)

Búsqueda por campo

Utilice esta opción cuando desee encontrar registros por un valor específico.

• Selección de Campo:
  • ID de solicitud — Coincidencia exacta por ID de registro
  • Búsqueda de contenido — Busca valores en los campos buscables del endpoint (por ejemplo, order_id, customer_email, mínimo 3 caracteres)
• Ingrese el Valor de búsqueda y ejecute
• Cuando se selecciona Búsqueda de contenido, aparecen los campos Fecha de inicio / Fecha de fin. Si no se especifican fechas, la búsqueda se realiza por defecto en el último mes

---

Lista de registros

Debajo de los filtros de búsqueda, el historial de llamadas del endpoint se muestra en una tabla.

Columna	Descripción
ID de solicitud	Identificador del registro
Estado	Insignia de Éxito · Fallido · Pendiente
Clave de colaboración	Clave de colaboración usada para esta llamada (o la predeterminada si no hay ninguna)
Creado	Hora de recepción de la llamada API
Procesado	Hora de finalización del almacenamiento y procesamiento del webhook

Haga clic en cualquier fila para ir a la página de detalles del registro.

---

Página de detalles del registro

Resumen

Muestra información detallada de una llamada individual.

• ID de solicitud: Identificador único del registro
• Endpoint: El endpoint que recibió la llamada
• Versión: Versión de la configuración al momento de la llamada
• Procesado: Hora de finalización del almacenamiento y procesamiento del webhook
• Tiempo de respuesta: Tiempo de procesamiento del gateway (ms)
• Clave de colaboración: El nombre y la descripción de la clave de colaboración utilizada (si corresponde)
• Mensaje de error / Detalles del error: Para llamadas fallidas, tipo de error, código de estado, errores de campo y hora de ocurrencia
• Botón Ver endpoint — Va a la página de detalles de este endpoint

Payload

Muestra los datos JSON originales enviados con la llamada API.

En Producción, los payloads con más de 30 días se archivan automáticamente y no se muestran directamente en la lista. En este caso, haga clic en el botón Cargar payload original para recuperar el payload archivado.

Danger Zone

• Eliminar registro — Elimina permanentemente este registro
• Se eliminan el registro en sí y su payload asociado. Esta acción no se puede deshacer
• Las estadísticas de uso no se ven afectadas

---

Enlace rápido Ver endpoint

El lado derecho de la página de detalle muestra una tarjeta de enlace rápido para saltar a la página de detalles del endpoint del registro actual. Puede verificar rápidamente la configuración del endpoint, los webhooks, las claves de colaboración y más.

---

Solución de problemas

• Los registros están vacíos: La pestaña de Producción no muestra registros hasta el despliegue a producción. Verifique primero que las llamadas de prueba se estén registrando en la pestaña de Sandbox
• La búsqueda no devuelve resultados: Búsqueda de contenido requiere que el endpoint tenga campos buscables (Searchable) definidos. Verifique si Searchable está configurado en Detalles del endpoint > Campos obligatorios
• El payload no es visible: En Producción, las llamadas con más de 30 días tienen sus payloads archivados. Use el botón Cargar payload original para recuperarlos
• Desea ver solo las llamadas de un colaborador específico: Seleccione la clave de colaboración en el menú desplegable Clave de colaboración de la pestaña Búsqueda por período
• ¿Se puede deshacer la limpieza de Sandbox?: No. Los registros de llamadas y estadísticas de Sandbox limpiados se eliminan permanentemente. Úselo con precaución