上一赛季范围查询

上一 赛季 排行榜的特定 范围 排名查询。

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指定排名范围。

各赛季排名

之前赛季的排名数据为只读，按赛季分别保存。可用于查询各赛季的顶级排名玩家并发放赛季奖励等用途。