플레이어 데이터 멀티 조회

다른 플레이어의 여러 공개 데이터를 한 번에 불러옵니다.

URL 확인

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

API 정보

• URL: https://service-storage-api.playnanoo.com/storage/v20221001/playerDataLoad/multi
• Method: PUT
• 인증 필요: 예

요청 파라미터

파라미터	타입	필수	설명
storage_keys	string	필수	조회할 데이터 목록 (JSON 문자열)

storage_keys JSON 구조 (MultiLoadParam)

필드	타입	필수	설명
Items	MultiLoadParamValue[]	필수	조회할 데이터 목록

MultiLoadParamValue 구조

필드	타입	필수	설명
PlayerId	string	필수	조회할 플레이어 ID
StorageKey	string	필수	불러올 데이터의 키

응답 데이터

필드	타입	설명
Items	array	불러온 데이터 목록

Items 배열 요소

필드	타입	설명
PlayerId	string	플레이어 ID
StorageKey	string	데이터의 키
StorageValue	string	데이터의 값

코드 예제

// MultiLoadParamValue 구조체
struct FMultiLoadParamValue
{
    FString PlayerId;
    FString StorageKey;

    TSharedPtr<FJsonObject> ToJsonObject() const
    {
        TSharedPtr<FJsonObject> JsonObject = MakeShareable(new FJsonObject());
        JsonObject->SetStringField(TEXT("PlayerId"), PlayerId);
        JsonObject->SetStringField(TEXT("StorageKey"), StorageKey);
        return JsonObject;
    }
};

void UMyGame::LoadMultiPlayerData(const TArray<FMultiLoadParamValue>& Items)
{
    // Items 배열을 JSON으로 변환
    TArray<TSharedPtr<FJsonValue>> ItemsArray;
    for (const FMultiLoadParamValue& Item : Items)
    {
        ItemsArray.Add(MakeShareable(new FJsonValueObject(Item.ToJsonObject())));
    }

    // storage_keys용 JSON 객체 생성 (MultiLoadParam)
    TSharedPtr<FJsonObject> StorageKeysObj = MakeShareable(new FJsonObject());
    StorageKeysObj->SetArrayField(TEXT("Items"), ItemsArray);

    // storage_keys를 JSON 문자열로 변환
    FString StorageKeysJson;
    TSharedRef<TJsonWriter<>> Writer = TJsonWriterFactory<>::Create(&StorageKeysJson);
    FJsonSerializer::Serialize(StorageKeysObj.ToSharedRef(), Writer);

    // 플레이어 정보가 포함된 요청 바디 생성
    TSharedPtr<FJsonObject> Body = FPlayNANOOHelper::CreateRequestBody();
    Body->SetStringField(TEXT("storage_keys"), StorageKeysJson);

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

    // HTTP 요청
    TSharedRef<IHttpRequest> Request = FHttpModule::Get().CreateRequest();
    Request->SetURL(TEXT("https://service-storage-api.playnanoo.com/storage/v20221001/playerDataLoad/multi"));
    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();
                        FString PlayerId = ItemObj->GetStringField(TEXT("PlayerId"));
                        FString Key = ItemObj->GetStringField(TEXT("StorageKey"));
                        FString Value = ItemObj->GetStringField(TEXT("StorageValue"));
                        UE_LOG(LogTemp, Log, TEXT("플레이어 %s: %s = %s"), *PlayerId, *Key, *Value);
                    }
                }
            }
        }
    });

    Request->ProcessRequest();
}

사용 예제

void UMyGame::Example()
{
    // 조회할 플레이어와 데이터 목록 생성
    TArray<FMultiLoadParamValue> Items;
    Items.Add({TEXT("PLAYER_ID_1"), TEXT("public_profile")});
    Items.Add({TEXT("PLAYER_ID_2"), TEXT("ranking_info")});
    Items.Add({TEXT("PLAYER_ID_1"), TEXT("achievement_list")});

    // API 호출
    LoadMultiPlayerData(Items);
}

효율적인 조회

다른 플레이어의 여러 공개 데이터를 조회할 때 이 API를 사용하면 네트워크 요청 횟수를 줄일 수 있습니다.

보안 주의

이 API는 다른 플레이어의 데이터를 조회하므로, 공개되어도 무방한 데이터만 저장해야 합니다.