친구 목록 조회
등록된 친구 목록을 조회합니다.
URL 확인
이 API는 service-api.playnanoo.com 도메인을 사용합니다.
API 정보
- URL:
https://service-api.playnanoo.com/friend/v20231201/search - Method:
PUT - 인증 필요: 예
요청 파라미터
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
| table_code | string | 필수 | 친구 테이블 코드 |
응답 데이터
| 필드 | 타입 | 설명 |
|---|---|---|
| Items | array | 친구 목록 |
Items 배열 요소
| 필드 | 타입 | 설명 |
|---|---|---|
| RelationshipCode | string | 관계 코드 |
| UserId | string | 사용자 ID |
| Nickname | string | 닉네임 |
| Timezone | string | 타임존 |
| AccessSeconds | number | 마지막 접속 시간 (초 단위) |
코드 예제
void UMyGame::GetFriendList(const FString& TableCode)
{
// 플레이어 정보가 포함된 요청 바디 생성
TSharedPtr<FJsonObject> Body = FPlayNANOOHelper::CreateRequestBody();
Body->SetStringField(TEXT("table_code"), TableCode);
// JSON 문자열 변환
FString JsonBody = FPlayNANOOHelper::ToJsonString(Body);
// HTTP 요청
TSharedRef<IHttpRequest> Request = FHttpModule::Get().CreateRequest();
Request->SetURL(TEXT("https://service-api.playnanoo.com/friend/v20231201/search"));
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> Friend = Item->AsObject();
FString Nickname = Friend->GetStringField(TEXT("Nickname"));
FString RelationshipCode = Friend->GetStringField(TEXT("RelationshipCode"));
UE_LOG(LogTemp, Log, TEXT("친구: %s, 관계코드: %s"), *Nickname, *RelationshipCode);
}
}
}
}
});
Request->ProcessRequest();
}
테이블 코드
친구 기능을 사용하기 전에 PlayNANOO 관리자 콘솔에서 친구 테이블 코드를 생성해야 합니다.