Saltar al contenido principal
Descargue directamente los detalles de llamadas API de la cuenta actual como CSV, adecuado para conciliación financiera, análisis sin conexión o para guardar grandes volúmenes de registros. Si solo necesita consultar una pequeña cantidad de detalles en la página, utilice primero la lista de registros de llamadas. El rango de consulta para registros de llamadas y resúmenes de facturación es de los últimos 60 días; los cuerpos de solicitud y respuesta se conservan por separado durante los últimos 30 días. La expiración de los cuerpos no cambia el cargo real, el uso ni las estadísticas agregadas de ese registro.

Preparativos

  1. Inicie sesión en la plataforma AceDataCloud.
  2. Cree un token de cuenta en la consola de Account Token y guárdelo inmediatamente en un gestor de contraseñas o Secret Manager.
  3. Según sea necesario, obtenga los ID de filtro desde la lista de solicitudes de servicio, la lista de credenciales API o la lista de API.
Para una descripción completa de los tokens, consulte Administrar tokens de cuenta. El token de cuenta y la Credential para llamar a las API de negocio no pueden usarse indistintamente.

Resumen de la interfaz

Esta interfaz devuelve el CSV de forma síncrona y en streaming, no crea una tarea de exportación ni devuelve JSON o un enlace de descarga. Solo cuando no se proporcionan ambas horas de inicio y fin, se exportan por defecto los registros desde el inicio del mes natural actual hasta el momento actual; si se proporciona solo un límite, el otro no se completa automáticamente con el límite de este mes.

Parámetros de consulta

El alcance de exportación siempre está limitado a los registros visibles para la cuenta actual como entidad pagadora y/o llamante real, y no admite exportaciones entre cuentas.

Ejemplos de solicitud

Guardar directamente el CSV del mes actual:
Exportar por Application, hora y código de estado:
Guardar en streaming con Python y comprobar la integridad:

Columnas CSV

El orden de la cabecera CSV es fijo:
La unidad de cuota está determinada por service.unit de la Application correspondiente.

Determinar si la exportación está completa

Una sola vez puede generar como máximo 1.000.000 de registros. Después de que el servidor haya comenzado a devolver el CSV, no puede cambiar un error intermedio a otro estado HTTP, por lo que el cliente debe comprobar la última línea:
  • # truncated:: se alcanzó el límite de filas; exporte por segmentos utilizando ventanas de tiempo más pequeñas.
  • # error:: se interrumpió la lectura en streaming; reduzca el rango y vuelva a exportar.
Cuando el programa de conciliación encuentre cualquiera de los marcadores, debe considerar el archivo como incompleto y no puede contabilizarlo silenciosamente.

Errores y reintentos

Siguientes pasos