순위 조회

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

URL 확인

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

API 정보

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

요청 파라미터

파라미터	타입	필수	설명
uid	string	필수	테이블 코드
range_start	int	필수	시작 순위 (1부터 시작)
range_end	int	필수	종료 순위

응답 데이터

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

Items 배열 요소

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

코드 예제

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

순위 범위

range_start와 range_end를 사용하여 원하는 순위 범위를 지정할 수 있습니다. 예를 들어, 상위 10명을 조회하려면 range_start=1, range_end=10으로 설정합니다.

효율적인 조회

한 번에 너무 많은 순위를 조회하면 성능에 영향을 줄 수 있습니다. 필요한 범위만 조회하는 것이 좋습니다.