이전 시즌 범위 조회

이전 시즌 리더보드의 특정 범위 순위를 조회합니다.

URL 확인

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

API 정보

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

요청 파라미터

파라미터	타입	필수	설명
uid	string	필수	테이블 코드
rotation_count	int	필수	시즌 번호 (조회할 이전 시즌)
range_start	int	필수	시작 순위 (1부터 시작)
range_end	int	필수	종료 순위

응답 데이터

필드	타입	설명
Items	array	순위 목록

Items 배열 요소

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

코드 예제

void UMyGame::GetPreviousSeasonRange(const FString& TableCode, int32 RotationCount, int32 RangeStart, int32 RangeEnd)
{
    // 요청 데이터 생성
    // 플레이어 정보가 포함된 요청 바디 생성
    TSharedPtr<FJsonObject> Body = FPlayNANOOHelper::CreateRequestBody();
    Body->SetStringField(TEXT("uid"), TableCode);
    Body->SetNumberField(TEXT("rotation_count"), RotationCount);
    Body->SetNumberField(TEXT("range_start"), RangeStart);
    Body->SetNumberField(TEXT("range_end"), RangeEnd);

    // JSON 문자열 변환
    FString JsonBody = FPlayNANOOHelper::ToJsonString(Body);

    // HTTP 요청
    TSharedRef<IHttpRequest> Request = FHttpModule::Get().CreateRequest();
    Request->SetURL(TEXT("https://service-api.playnanoo.com/leaderboard/v20240301/range/prev"));
    Request->SetVerb(TEXT("PUT"));
    FPlayNANOOHelper::SetCommonHeaders(Request, true);  // 인증 토큰 포함
    Request->SetContentAsString(JsonBody);

    Request->OnProcessRequestComplete().BindLambda(
        [](FHttpRequestPtr Req, FHttpResponsePtr Res, bool bSuccess)
    {
        if (bSuccess && Res.IsValid())
        {
            TSharedPtr<FJsonObject> JsonObject;
            TSharedRef<TJsonReader<>> Reader = TJsonReaderFactory<>::Create(Res->GetContentAsString());

            if (FJsonSerializer::Deserialize(Reader, JsonObject))
            {
                const TArray<TSharedPtr<FJsonValue>>* Items;
                if (JsonObject->TryGetArrayField(TEXT("Items"), Items))
                {
                    for (const auto& Item : *Items)
                    {
                        TSharedPtr<FJsonObject> ItemObj = Item->AsObject();
                        int32 Rank = ItemObj->GetIntegerField(TEXT("Rank"));
                        FString RecordId = ItemObj->GetStringField(TEXT("RecordId"));
                        int32 Score = ItemObj->GetIntegerField(TEXT("Score"));
                        int32 Season = ItemObj->GetIntegerField(TEXT("RotationCount"));
                        UE_LOG(LogTemp, Log, TEXT("순위: %d, 플레이어: %s, 점수: %d, 시즌: %d"), Rank, *RecordId, Score, Season);
                    }
                }
            }
        }
    });

    Request->ProcessRequest();
}

이전 시즌 범위 조회

rotation_count로 특정 이전 시즌을 지정하고, range_start와 range_end로 순위 범위를 지정할 수 있습니다.

시즌별 순위

이전 시즌의 순위 데이터는 읽기 전용이며, 시즌별로 구분하여 저장됩니다. 각 시즌의 상위 랭커를 조회하여 시즌 보상을 지급하는 등의 용도로 활용할 수 있습니다.