Query Previous Season Range

Queries a specific rank range from a previous season's leaderboard.

URL Confirmation

This API uses the service-api.playnanoo.com domain.

API Information

• URL: https://service-api.playnanoo.com/leaderboard/v20240301/range/prev
• Method: PUT
• Authentication Required: Yes

Request Parameters

Parameter	Type	Required	Description
uid	string	Required	Table code
rotation_count	int	Required	Season number (previous season to query)
range_start	int	Required	Starting rank (starts from 1)
range_end	int	Required	Ending rank

Response Data

Field	Type	Description
Items	array	Rank list

Items Array Elements

Field	Type	Description
Rank	int	Rank
RotationCount	int	Season number
RecordId	string	Record ID
Score	int	Score
ExtraData	string	Extra data (JSON string)

Code Example

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();
}

Previous Season Range Query

You can specify a particular previous season using rotation_count, and specify the rank range using range_start and range_end.

Seasonal Rankings

Previous season rank data is read-only and stored separately by season. You can use this to query top rankers from each season for purposes such as distributing season rewards.