GetPastLeaderboard

public BackendGuildPastLeaderboardReturnObject GetPastLeaderboard(string leaderboardUuid, int limit = 10, int offset = 0)

Parameters

Value	Type	Description	Default
leaderboardUuid	string	uuid of the leaderboard to look up	-
limit	int	Number of leaderboard guilds to load (1 - 100)	10
offset	int	조회할 리더보드의 uuid(0이상)	0

Description

Loads the last ranking list before the renewal of the ranking that has been measured for ranking rewards.

• This is only possible for rankings with rewards.
• Only the past rankings for guilds who have received ranking rewards are displayed.
  • 랭킹 보상이 10등까지에게만 주어질 경우, 11등부터의 과거 랭킹은 불러올 수 없습니다.
  • 순위권 밖이지만 전체 보상의 범위에 포함된 길드도 과거 랭킹에는 표시되지 않습니다.
• You cannot load the past rankings for a certain guild or for yourself.
• Among the past rankings, the latest past ranking will be loaded.
  • 일간 랭킹일 경우, 1일 전 과거 랭킹 데이터를 불러오게 되며 2일 전 랭킹은 불러오지 못합니다.
• limit을 0이하로 입력할 경우 1로 적용됩니다. 100이상일 경우에는 100으로 적용됩니다.
• offset을 0이하로 입력할 경우 0으로 적용됩니다.
• This method cannot be called using SendQueue.

For withdrawn guilds

If there are withdrawn guilds in the past ranking list, the guild's guildInDate and guildName columns will not exist.\ jsonData.ContainsKey("guildName")으로 컬럼을 확인한 뒤에 데이터를 가공해주세요.

Withdrawn guild

{"score":"7835","rank":1}

General guild

{"score":"7834","rank":2,"guildInDate":"2024-03-06T05:59:54.716Z","guildName":"Knights"}

BackendGuildPastLeaderboardReturnObject

namespace BackEnd.Leaderboard
{
    public class GuildPastLeaderboardItem
    {
        public string guildName;
        public string guildInDate;
        public string score;
        public string rank;
    }

    public class BackendGuildPastLeaderboardReturnObject : BackendReturnObject
    {    
        public List<GuildPastLeaderboardItem> GetGuildPastLeaderboardList();
    }
}

Example

Synchronous

// 리더보드 1위 부터 10위까지
BackEnd.Leaderboard.BackendGuildPastLeaderboardReturnObject bro = Backend.Leaderboard.Guild.GetPastLeaderboard("01920445-a435-759e-bc3b-048a1e7a87aa");

foreach(BackEnd.Leaderboard.GuildPastLeaderboardItem item in bro.GetGuildPastLeaderboardList())
{
    string name = $"[{item.rank}] {item.guildName} : {item.score}";
    Debug.Log(item);
}

// 리더보드 11위(offset + 1) 부터 111위까지((offset + 1 + limit)
Backend.Leaderboard.Guild.GetPastLeaderboard("a61c6980-db5f-11ee-95a9-73cbb1225013", 100, 10);

Asynchronous

Backend.Leaderboard.Guild.GetPastLeaderboard("a61c6980-db5f-11ee-95a9-73cbb1225013", 10, 0, callback => {
    foreach(BackEnd.Leaderboard.GuildPastLeaderboardItem item in callback.GetGuildPastLeaderboardList())
    {
        string name = $"[{item.rank}] {item.guildName} : {item.score}";
        Debug.Log(item);
    }
});

ReturnCase

Success cases

When the lookup is successful\ statusCode : 200\ message : Success\ returnValue : Refer to GetReturnValuetoJSON

Error cases

If reward calculation has not been conducted for the past leaderboard\ statusCode : 200\ message : Success\ returnValue : {"rows":[]}

When uuid is null or string.Empty\ statusCode : 400\ errorCode : ValidationException\ message : leaderboardUuid is null or empty

존재하지 않는 uuid로 조회를 시도한 경우\ statusCode : 404\ errorCode : NotFoundException\ message : leaderboard not found, leaderboard을(를) 찾을 수 없습니다

When attempting to look up the past leaderboards for the cumulative leaderboard\ statusCode : 428\ errorCode : Precondition Required\ message : Precondition Required rank initial type

GetReturnValuetoJSON

{
    "rows": [
        {
            "score": "7835", // The nickname and inDate will not be printed for withdrawn guilds.
            "rank": 1
        }
        {
            "score": "5834",
            "rank": 2,
            "guildName": "Guild2",
            "guildInDate": "2024-03-06T05:59:53.523Z"
        },
        {
            "score": "5121",
            "rank": 3,
            "guildName": "Guild3",
            "guildInDate": "2024-03-06T05:59:51.568Z"
        }
    ]
}