Skip to content

GET /sonolus/{type}/{itemName}/leaderboards/{leaderboardName}/records/list

/sonolus/{type}/{itemName}/leaderboards/{leaderboardName}/records/list fornece informações detalhadas da tabela de classificação do nome {leaderboardName} no item do nome {itemName} e é usado pelo aplicativo Sonolus para preencher a lista de registros da seção de tabela de classificação da visualização de detalhes do item do servidor.

Parâmetros de URL

Parâmetro de URLValorDescrição
typestringposts , playlists , levels , skins , backgrounds , effects , particles , engines ou replays .
itemNamestringNome do item.
leaderboardNamestringNome da tabela de classificação.

Parâmetros de consulta

Parâmetro de consultaValorDescrição
localizationstringVeja localization .
Opções de configuraçãoanyConsulte Parâmetros de consulta de opções .
pagenumberVeja page .
cursorstringVeja cursor .

Cabeçalhos de solicitação

CabeçalhoValorDescrição
Sonolus-SessionstringOpcional, veja Sonolus-Session .

Corpo da solicitação

Nenhum.

Código de resposta

CódigoDescrição
200 OK
401 UnauthorizedAutenticação necessária ou expirada.
404 Not Found

Cabeçalhos de resposta

CabeçalhoValorDescrição
Sonolus-VersionstringOpcional, veja Sonolus-Version .

Corpo de Resposta

ts
type ServerItemLeaderboardRecordList = {
    pageCount: number
    cursor?: string
    records: ServerItemLeaderboardRecord[]
}

pageCount

Se um valor negativo for usado, a lista usará paginação de cursor.

cursor

Só tem efeito sob paginação com cursor. Se presente, a próxima página estará disponível e será solicitada com o valor do cursor.

comments

É recomendável manter cada página curta, mostrando apenas 10 registros.

Exemplos

json
{
    "pageCount": 5,
    "records": [
        // ...
    ]
}