아이템 조회
우편함에 있는 아이템 목록을 조회합니다.
URL 확인
이 API는 service-api.playnanoo.com 도메인을 사용합니다.
API 정보
- URL:
https://service-api.playnanoo.com/inbox/v20220901/items - Method:
PUT - 인증 필요: 예
요청 파라미터
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
| table_code | string | 필수 | 테이블 코드 |
응답 데이터
Res 클래스
| 필드 | 타입 | 설명 |
|---|---|---|
| items | FSerializeInbox[] | 우편함 아이템 목록 |
FSerializeInbox 구조
| 필드 | 타입 | 설명 |
|---|---|---|
| type | FString | 아이템 타입 |
| item_key | FString | 아이템 고유 키 |
| items | FSerializeItems[] | 아이템 상세 목록 |
| messages | FSerializeItemMessages[] | 아이템 메시지 목록 |
| expire_sec | int32 | 만료 시간 (초) |
FSerializeItems 구조
| 필드 | 타입 | 설명 |
|---|---|---|
| item_code | FString | 아이템 코드 |
| item_count | int32 | 아이템 개수 |
FSerializeItemMessages 구조
| 필드 | 타입 | 설명 |
|---|---|---|
| language | FString | 언어 코드 |
| title | FString | 메시지 제목 |
| content | FString | 메시지 내용 |
코드 예제
void UMyGame::GetInboxItems(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/inbox/v20220901/items"));
Request->SetVerb(TEXT("PUT"));
FPlayNANOOHelper::SetCommonHeaders(Request, true); // 인증 토큰 포함
Request->SetContentAsString(JsonBody);
Request->OnProcessRequestComplete().BindLambda(
[](FHttpRequestPtr Req, FHttpResponsePtr Res, bool bSuccess)
{
if (bSuccess && Res.IsValid())
{
UE_LOG(LogTemp, Log, TEXT("우편함 아이템 조회 성공: %s"), *Res->GetContentAsString());
}
});
Request->ProcessRequest();
}
테이블 코드
table_code는 PlayNANOO 콘솔에서 생성한 우편함 테이블의 코드입니다.