Query Rank Range

Queries a specific rank range from the leaderboard.

URL Confirmation

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

API Information

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

Request Parameters

Parameter	Type	Required	Description
uid	string	Required	Table code
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::GetLeaderboardRange(const FString& TableCode, int32 RangeStart, int32 RangeEnd)
{
    // 요청 데이터 생성
    // 플레이어 정보가 포함된 요청 바디 생성
    TSharedPtr<FJsonObject> Body = FPlayNANOOHelper::CreateRequestBody();
    Body->SetStringField(TEXT("uid"), TableCode);
    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"));
    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"));
                        UE_LOG(LogTemp, Log, TEXT("순위: %d, 플레이어: %s, 점수: %d"), Rank, *RecordId, Score);
                    }
                }
            }
        }
    });

    Request->ProcessRequest();
}

Rank Range

You can specify the desired rank range using range_start and range_end. For example, to query the top 10 players, set range_start=1 and range_end=10.

Efficient Querying

Querying too many ranks at once can affect performance. It's best to query only the range you need.