본문으로 건너뛰기
버전: 5.14.1

GetLeaderboardReward

BackendLeaderboardReturnObject GetLeaderboardReward(string leaderboardUuid);

파라미터

ValueTypeDescription
leaderboardUuidstring조회할 랭킹의 uuid

leaderboardUuid 값은 아래 방법을 통해 확인할 수 있습니다.

설명

uuid 값을 이용하여 해당 랭킹의 보상 정보를 조회합니다.

  • 해당 함수는 SendQueue로 호출할 수 없습니다.

랭킹 보상을 수령하는 것이 아닌 콘솔에서 등록한 랭킹의 보상 정보를 조회하는 함수입니다.

랭킹 보상을 수령하는 방법에 대해서는 우편 조회우편 수령 문서를 확인해 주세요.

BackendLeaderboardReturnObject

namespace BackEnd.Leaderboard
{
public class LeaderboardRewardItem
{
public int startRank;
public int endRank;
public int rewardItemCount;
public string rewardChartName;
public Dictionary<string, string> rewardItems = new Dictionary<string, string>();
}

public class BackendLeaderboardRewardReturnObject : BackendReturnObject
{
public List<LeaderboardRewardItem> GetLeaderboardRewardList();
}
}

Example

동기

BackEnd.Leaderboard.BackendLeaderboardRewardReturnObject bro = Backend.Leaderboard.Guild.GetLeaderboardReward("uuid");

foreach(BackEnd.Leaderboard.LeaderboardRewardItem item in bro.GetLeaderboardRewardList())
{
Debug.Log(item);
if(item.rewardItems.ContainsKey("level"))
{
int level = int.Parse(item.rewardItems["level"]);
}
}

비동기

Backend.Leaderboard.Guild.GetLeaderboardReward("leaderboardUuid", bro => {
foreach(BackEnd.Leaderboard.LeaderboardRewardItem item in bro.GetLeaderboardRewardList())
{
Debug.Log(item);
if(item.rewardItems.ContainsKey("level"))
{
int level = int.Parse(item.rewardItems["level"]);
}
}
});

ReturnCase

Success cases

조회에 성공한 경우
statusCode : 200
message : Success
returnValue : GetReturnValuetoJSON 참조

Error cases

uuid가 null 혹은 string.Empty인 경우
statusCode : 400
errorCode : ValidationException
message : leaderboardUuid is null or empty

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

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

GetReturnValuetoJSON

{
"rows": [
{
"rewardItems": {
"chartFileName": "LevelChart.csv",
"maxExperience": "100",
"level": "1",
"rewardGold": "1111"
},
"startRank": 0,
"endRank": 0,
"rewardItemCount": 123,
"rewardChartName": "LevelChart"
}
]
}