Skip to main content
GET
Python (SDK)

Autorizações

Authorization
string
header
obrigatório

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>.

Cabeçalhos

X-On-Behalf-Of
string

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

Parâmetros de caminho

suite_id
string
obrigatório

Parâmetros de consulta

suite_version
integer

Restrinja o ranking a execuções registradas em uma versão da suíte. As pontuações só são comparáveis dentro de uma versão, então os consumidores do leaderboard devem informar a versão que estão pontuando. Uma versão que a suíte não possui retorna uma lista vazia, não 404, então isso é lido da mesma forma que uma versão sem execuções concluídas ainda.

Intervalo obrigatório: 1 <= x <= 2147483647
per_group
integer
padrão:5

Quantas execuções concluídas mais recentes manter por grupo de classificação. Um grupo é (modelo, tarefa alvo) para execuções restritas por task_ids — importações históricas registram uma execução por modelo e tarefa, então seus painéis são montados com per_group=1 — e (modelo) para execuções irrestritas, que cobrem todas as tarefas da sua versão. Mais de 1 permite que um consumidor recorra a uma execução anterior para uma tarefa cuja execução mais recente não tenha estatísticas utilizáveis.

Intervalo obrigatório: 1 <= x <= 20
model
string

Restrinja o ranking aos grupos de um único modelo. Útil quando o consumidor já conhece os eixos da sua placa; para descobrir e paginar além de uma resposta truncada, use cursor/next_cursor. Um valor vazio é rejeitado em vez de ser tratado como omitido.

Required string length: 1 - 255
cursor
string

Cursor opaco de retomada de uma resposta truncada anterior, proveniente do next_cursor. Continua a ordenação exatamente de onde a página anterior parou — dentro de um modelo ou de um nível de classificação, quando foi ali que o corte ocorreu. Passe-o de volta literalmente; um valor malformado gera um 400. Página com um conjunto fixo de filtros, como o cursor da lista de execuções.

Required string length: 1 - 2048

Resposta

200 - application/json

OK

object
any
obrigatório
data
object[]
obrigatório

The deduplicated runs behind groups, newest first.

groups
object[]
obrigatório

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
obrigatório

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
obrigatório

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.