Saltar al contenido principal
GET
Python (SDK)

Autorizaciones

Authorization
string
header
requerido

Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.

Encabezados

X-On-Behalf-Of
string

Optional external end-user identifier forwarded by the API gateway.

Parámetros de consulta

start_time
integer
requerido

Hora de inicio (segundos Unix), inclusivo

Rango requerido: -9007199254740991 <= x <= 9007199254740991
Ejemplo:

1704067200

end_time
integer

Tiempo de finalización (segundos Unix), exclusivo

Rango requerido: -9007199254740991 <= x <= 9007199254740991
Ejemplo:

1704153600

bucket_width
enum<string>
predeterminado:1d

Ancho de cada intervalo de tiempo (1m, 1h, 1d)

Opciones disponibles:
1m,
1h,
1d
Ejemplo:

"1d"

limit
integer

Número de cubos a devolver

Rango requerido: 1 <= x <= 1440
Ejemplo:

30

page
string

Cursor de paginación

Ejemplo:

"cursor_abc123"

user_ids

Filtrar por IDs de usuario de plataforma (el mismo grupo de dimensión group_by=user_id informes)

Ejemplo:
external_user_ids

Filtrar por IDs de usuario final delegados (externalUserId, es decir, X-On-Behalf-Of subs)

Ejemplo:
all_orgs
string

Uso agregado en todas las organizaciones (solo administradores de clúster)

org_ids

Filtrar por IDs de organizaciones (solo administradores de clúster, implica alcance de clúster)

Ejemplo:
group_by

Agrupar por campos especificados

Opciones disponibles:
user_id,
api_key_id

Respuesta

200 - application/json

Está bien

object
any
requerido
data
object[]
requerido
has_more
boolean
requerido

Whether there are more pages

next_page
string | null
requerido

Cursor for next page, null if no more pages