Skip to main content
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 ruta

suite_id
string
requerido

Parámetros de consulta

suite_version
integer

Limita la clasificación a ejecuciones registradas contra una versión de la suite. Las puntuaciones solo son comparables dentro de una versión, así que los consumidores de la tabla de clasificación deben pasar la versión que puntúan. Una versión que la suite no tiene devuelve una lista vacía, no un 404, así que se interpreta igual que una versión sin ejecuciones completadas todavía.

Rango requerido: 1 <= x <= 2147483647
per_group
integer
predeterminado:5

Cuántas ejecuciones completadas más recientes conservar por grupo de clasificación. Un grupo es (modelo, tarea objetivo) para ejecuciones restringidas por task_ids — las importaciones históricas registran una ejecución por modelo y tarea, por lo que sus tableros se ensamblan con per_group=1 — y (modelo) para ejecuciones no restringidas, que cubren todas las tareas de su versión. Más de 1 permite a un consumidor recurrir a una ejecución anterior para una tarea cuya ejecución más reciente carece de estadísticas utilizables.

Rango requerido: 1 <= x <= 20
model
string

Limita el ranking a los grupos de un solo modelo. Útil cuando el consumidor ya conoce los ejes de su tablero; para descubrir y paginar más allá de una respuesta truncada, usa cursor/next_cursor. Un valor vacío se rechaza en lugar de tratarse como omitido.

Required string length: 1 - 255
cursor
string

Cursor opaco para reanudar a partir del next_cursor de una respuesta truncada anterior. Continúa la clasificación exactamente donde se detuvo la página anterior — dentro de un modelo o de un nivel de ranking cuando el corte cayó allí. Devuélvelo tal cual; un valor malformado provoca un 400. Paginado con un conjunto de filtros fijo, como el cursor de la lista de ejecuciones.

Required string length: 1 - 2048

Respuesta

200 - application/json

Está bien

object
any
requerido
data
object[]
requerido

The deduplicated runs behind groups, newest first.

groups
object[]
requerido

The server's group assignments — build boards from these, not from run.models/run.task_ids. Ordered by model, then task id with the covers-everything group first within each model, then rank; that ordering is contract.

truncated
boolean
requerido

True when a server ceiling trimmed the aggregate. Whole runs are kept in (rank, model, task) order — never dropped for being old; resume with cursor: next_cursor.

next_cursor
string | null
requerido

Set when truncated: pass as cursor on the next request and union the responses until truncated is false to assemble the complete aggregate. Null when this response is complete.