플레이어 조회

특정 플레이어의 리더보드 기록을 조회하는 API입니다.

URL 확인

이 API는 service-api.playnanoo.com 도메인을 사용합니다.

API 정보

• URL: https://service-api.playnanoo.com/leaderboard/v20240301/show
• Method: PUT
• 인증 필요: 예

DeviceInfo 상속

이 API의 Req 클래스는 DeviceInfo를 상속받습니다. DeviceInfo의 모든 속성이 자동으로 포함됩니다.

요청 파라미터

파라미터	타입	필수	설명
uid	string	필수	테이블 코드
record_id	string	필수	기록 ID (플레이어 식별자)

응답 데이터

Res 클래스

필드	타입	설명
Rank	int	플레이어의 순위
RotationCount	int	현재 시즌 번호
RecordId	string	기록 ID
Score	int	점수
ExtraData	string	추가 데이터 (JSON 문자열)

Unity C# 구현

BaseResponse 클래스

모든 API 응답의 기본 클래스입니다.

public class BaseResponse
{
    public string ErrorCode;
    public string Message;
    public string WithdrawalKey;
    public string BlockKey;
}

필드 설명:

• ErrorCode: 에러 코드
• Message: 에러 메시지
• WithdrawalKey: 탈퇴 유예 상태인 경우 복구에 필요한 키 (탈퇴 유예 중인 계정만 제공)
• BlockKey: 차단된 계정인 경우 제공되는 키 (차단된 계정만 제공)

플레이어 조회 클래스

using System;
using System.Collections;
using UnityEngine.Networking;

public class PlayerShow
{
    static string path = "https://service-api.playnanoo.com/leaderboard/v20240301/show";

    [Serializable]
    public class Req : DeviceInfo
    {
        public string uid;
        public string record_id;

        public IEnumerator Send(string table_code, string recordId, Action<Res> onSuccess, Action<BaseResponse> onError)
        {
            if (!string.IsNullOrEmpty(table_code)) this.uid = table_code;
            if (!string.IsNullOrEmpty(recordId)) this.record_id = recordId;

            yield return HttpClient.Send<Req, Res>(
                UnityWebRequest.kHttpVerbPUT,
                path,
                requireToken: true,
                body: this,
                onSuccess: onSuccess,
                onError: onError
            );
        }
    }

    [Serializable]
    public class Res : BaseResponse
    {
        public int Rank;
        public int RotationCount;
        public string RecordId;
        public int Score;
        public string ExtraData;
    }
}

사용 예제

public void ShowPlayerRecord()
{
    PlayerShow.Req req = new PlayerShow.Req();

    StartCoroutine(req.Send(
        table_code: "my_leaderboard_table",
        recordId: "player_001",
        onSuccess: res =>
        {
            Debug.Log("플레이어 기록 조회 성공");
            Debug.Log($"순위: {res.Rank}");
            Debug.Log($"점수: {res.Score}");
            Debug.Log($"시즌: {res.RotationCount}");

            // ExtraData가 있는 경우 파싱
            if (!string.IsNullOrEmpty(res.ExtraData))
            {
                Debug.Log($"추가 데이터: {res.ExtraData}");
            }
        },
        onError: error =>
        {
            Debug.LogError($"플레이어 기록 조회 실패: [{error.ErrorCode}] {error.Message}");
        }
    ));
}

기록 조회

이 API는 현재 시즌의 특정 플레이어 기록을 조회합니다. 이전 시즌의 기록을 조회하려면 이전 시즌 조회 API를 사용하세요.

추가 데이터 파싱

ExtraData는 JSON 문자열 형식으로 반환됩니다. Unity의 JsonUtility를 사용하여 객체로 변환할 수 있습니다.