Skip to main content
GET
Agregación de facturación
GET https://api-datahub.octoparse.com/v1/billing Autenticación: se requiere API key (Authorization: Bearer <API Key>). Cuánto gastó en un periodo y en qué. Es independiente del endpoint de identidad de la cuenta. El intervalo de tiempo usa el mismo vocabulario que List runs: created_from / created_to son horas absolutas ISO-8601, inclusiva/exclusiva, referidas a la hora de inicio de la ejecución. Pase los mismos límites a List runs para ver en detalle las ejecuciones que hay detrás del total de cualquier grupo. tz_offset solo determina en qué día local cae una ejecución en los grupos por día; no cambia los importes ni el propio intervalo absoluto. Solo se agregan las tarifas de datos. Los grupos por día se ordenan de forma ascendente para la conciliación; los grupos por app y por credencial se ordenan de forma descendente por importe, para que el mayor gasto aparezca primero. El desglose por credential responde a “¿cuánto gastó cada una de mis claves?”. La clave es un id de credencial estable y no sensible, el mismo valor que usa el filtro credential de List runs. El alcance es siempre su cuenta; nunca verá las credenciales de otra persona.

Solicitud

Parámetros de consulta

string
predeterminado:"day"
Dimensión del desglose: day (predeterminado), data_app o credential.
string
Inicio inclusivo. Omítalo para empezar desde la ejecución más antigua.
string
Fin exclusivo. Omítalo para incluir hasta el momento actual.
integer
predeterminado:"0"
Desfase de zona horaria de los grupos por día, en minutos respecto a UTC. Use 480 para la hora estándar de China; el valor predeterminado 0 usa días UTC. Solo desfase fijo (sin horario de verano). Los created_from / created_to de las consultas de detalle deben usar el mismo desfase. Rango de -720 a 840.

Ejemplo de solicitud

Respuesta

200 correcto

La carga útil va envuelta en data. Campos:
number
Total del periodo; equivale a la suma de los valores amount de los grupos.
string
Divisa.
string
Dimensión realmente utilizada.
object[]
Filas de grupo. Todos los campos de dimensión están presentes; los que no se usan valen null.

Errores

Las respuestas de error usan {"error": {code, category, message, retryable}}. Véase Errores.

Bibliotecas cliente