ZEPETO.Module.Shop

18 분

형식	설명
ShopService	ShopService는 World 내 ZEPETO 상점과 연결된 작업을 수행할 수 있게 합니다. 이 서비스를 통해 플레이어는 보유 아이템이나 위시리스트 아이템의 썸네일 이미지 같은 상점 정보에 접근하고, 다른 플레이어에게 선물을 보낼 수 있습니다.
CategoryResponse	CategoryResponse 클래스는 API 호출 결과와 ZEPETO 상점 아이템 카테고리 정보를 제공합니다.
ContentItemListResponse	ContentItemListResponse 클래스는 API 호출 결과와 가져온 아이템 목록을 제공합니다.
ItemKeyword	아이템 카테고리입니다.
ContentItemResponse	ContentItemResponse 클래스는 API 호출 결과와 아이템 정보를 제공합니다.
GiftBackgroundType	선물 알림 팝업에 사용할 배경 유형입니다.
ItemGiftResponse	ItemGiftResponse 클래스는 아이템 선물의 결과를 제공합니다.
CategoryInfo	ZEPETO 상점 아이템 카테고리 정보입니다.
Category	아이템 카테고리입니다.
ItemRequestType	enum

ShopService

class

ShopService는 World 내 ZEPETO 상점과 연결된 작업을 수행할 수 있게 합니다. 이 서비스를 통해 플레이어는 보유 아이템이나 위시리스트 아이템의 썸네일 이미지 같은 상점 정보에 접근하고, 다른 플레이어에게 선물을 보낼 수 있습니다.

메서드

DownloadItemThumbnail

static DownloadItemThumbnail(itemCode: string) → BaseRequest<TextureResponse>

아이템의 썸네일을 가져오는 비동기 메서드입니다.

매개변수	형식	설명
itemCode	string	아이템 코드

반환값: BaseRequest<TextureResponse> — BaseRequest 객체입니다. 비동기 처리가 완료되면 responseData 속성을 통해 TextureResponse 객체에 접근할 수 있습니다.

GetMyCategoryAsync

static GetMyCategoryAsync() → BaseRequest<CategoryResponse>

이 메서드는 로컬 플레이어 사용자 계정의 ZEPETO 상점 인벤토리에서 아이템 카테고리 정보를 가져옵니다.

반환값: BaseRequest<CategoryResponse> — BaseRequest 객체입니다. 비동기 처리가 완료되면 responseData 속성을 통해 CategoryResponse 객체에 접근할 수 있습니다.

GetMyContentItemListAsync

static GetMyContentItemListAsync(itemKeyword: ItemKeyword, pageToken?: string) → BaseRequest<ContentItemListResponse>

아이템 카테고리별 아이템 목록을 가져오는 비동기 메서드입니다.

매개변수	형식	설명
itemKeyword	ItemKeyword	아이템 카테고리입니다.
pageToken (선택 사항)	string	페이지 토큰입니다. 이 메서드를 처음 호출할 때는 이 매개변수를 null로 설정합니다.

반환값: BaseRequest<ContentItemListResponse> — BaseRequest 객체입니다. 비동기 처리가 완료되면 responseData 속성을 통해 ContentItemListResponse 객체에 접근할 수 있습니다.

GetContentItemAsync

static GetContentItemAsync(itemId: string) → BaseRequest<ContentItemResponse>

아이템 정보를 가져오는 비동기 메서드입니다.

매개변수	형식	설명
itemId	string	아이템 코드입니다.

반환값: BaseRequest<ContentItemResponse> — BaseRequest 객체입니다. 비동기 처리가 완료되면 responseData 속성을 통해 ContentItemResponse 객체에 접근할 수 있습니다.

GetMyWishContentItemListAsync

static GetMyWishContentItemListAsync() → BaseRequest<ContentItemListResponse>

로컬 플레이어 사용자 계정의 ZEPETO 상점 위시리스트에서 아이템 목록을 가져오는 비동기 메서드입니다.

CategoryResponse

class · extends BaseResponse

CategoryResponse 클래스는 API 호출 결과와 ZEPETO 상점 아이템 카테고리 정보를 제공합니다.

속성

이름	형식	설명
category	CategoryInfo	ZEPETO 상점 아이템 카테고리 정보입니다.

ContentItemListResponse

class · extends PlayBaasResponse

ContentItemListResponse 클래스는 API 호출 결과와 가져온 아이템 목록을 제공합니다.

속성

이름	형식	설명
items	Item[]	아이템 목록입니다.
nextPageToken	string	항목이 많은 경우 응답에 nextPageToken이 포함되어 이후의 아이템 목록을 가져올 수 있습니다. 남은 항목이 없으면 nextPageToken은 null이 됩니다.

ItemKeyword

enum

아이템 카테고리입니다.

이름	값
all	0
hair	1
onepiece	2
top	3
outwear	4
pants	5
skirt	6
socks	7
footwear	8
headwear	9
eyewear	10
jewelry	11
makeup	12
accessory	13
bodyfigure	14
animal	15
none	16

ContentItemResponse

class · extends PlayBaasResponse

ContentItemResponse 클래스는 API 호출 결과와 아이템 정보를 제공합니다.

속성

이름	형식	설명
item	Item	아이템입니다.

GiftBackgroundType

enum

선물 알림 팝업에 사용할 배경 유형입니다.

이름	값
Type01	1
Type02	2
Type03	3
Type04	4

ItemGiftResponse

class · extends PurchaseBaseResponse

ItemGiftResponse 클래스는 아이템 선물의 결과를 제공합니다.

속성

이름	형식	설명
zem	number	선물하기 완료 후 로컬 플레이어 사용자 계정에 남은 ZEM 잔액입니다.
coin	number	선물하기 완료 후 로컬 플레이어 사용자 계정에 남은 코인 잔액입니다.

CategoryInfo

class

ZEPETO 상점 아이템 카테고리 정보입니다.

속성

이름	형식	설명
displayName	string	상점 인벤토리 탭의 현지화된 표시 이름입니다.
categories	Category[]	인벤토리 탭 하위의 아이템 카테고리 목록입니다.

이름	형식	설명
displayName	string	아이템 카테고리의 현지화된 표시 이름입니다.
keyword	ItemKeyword	아이템 카테고리를 나타내는 열거형입니다.

ItemRequestType

enum

이름	값
Purchase	0
Gift	1