--- title: ZEPETO.Module.Shop slug: world-sdk-guide-kr/zepetomoduleshop docTags: createdAt: 2026-09-04T06:23:34.226Z --- | 형식 | 설명 | | ----------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | [ShopService](./#shopservice) | `ShopService`는 World 내 ZEPETO 상점과 연결된 작업을 수행할 수 있게 합니다. 이 서비스를 통해 플레이어는 보유 아이템이나 위시리스트 아이템의 썸네일 이미지 같은 상점 정보에 접근하고, 다른 플레이어에게 선물을 보낼 수 있습니다. | | [CategoryResponse](./#categoryresponse) | `CategoryResponse` 클래스는 API 호출 결과와 ZEPETO 상점 아이템 카테고리 정보를 제공합니다. | | [ContentItemListResponse](./#contentitemlistresponse) | `ContentItemListResponse` 클래스는 API 호출 결과와 가져온 아이템 목록을 제공합니다. | | [ItemKeyword](./#itemkeyword) | 아이템 카테고리입니다. | | [ContentItemResponse](./#contentitemresponse) | `ContentItemResponse` 클래스는 API 호출 결과와 아이템 정보를 제공합니다. | | [GiftBackgroundType](./#giftbackgroundtype) | 선물 알림 팝업에 사용할 배경 유형입니다. | | [ItemGiftResponse](./#itemgiftresponse) | `ItemGiftResponse` 클래스는 아이템 선물의 결과를 제공합니다. | | [CategoryInfo](./#categoryinfo) | ZEPETO 상점 아이템 카테고리 정보입니다. | | [Category](./#category) | 아이템 카테고리입니다. | | [ItemRequestType](./#itemrequesttype) | *enum* | ## ShopService `class` `ShopService`는 World 내 ZEPETO 상점과 연결된 작업을 수행할 수 있게 합니다. 이 서비스를 통해 플레이어는 보유 아이템이나 위시리스트 아이템의 썸네일 이미지 같은 상점 정보에 접근하고, 다른 플레이어에게 선물을 보낼 수 있습니다. ### 메서드 ### DownloadItemThumbnail `static DownloadItemThumbnail(itemCode: string) → BaseRequest` 아이템의 썸네일을 가져오는 비동기 메서드입니다. | 매개변수 | 형식 | 설명 | | -------- | -------- | ------ | | itemCode | `string` | 아이템 코드 | **반환값:** `BaseRequest` — `BaseRequest` 객체입니다. 비동기 처리가 완료되면 `responseData` 속성을 통해 `TextureResponse` 객체에 접근할 수 있습니다. ### GetMyCategoryAsync `static GetMyCategoryAsync() → BaseRequest` 이 메서드는 로컬 플레이어 사용자 계정의 ZEPETO 상점 인벤토리에서 아이템 카테고리 정보를 가져옵니다. **반환값:** `BaseRequest` — `BaseRequest` 객체입니다. 비동기 처리가 완료되면 `responseData` 속성을 통해 `CategoryResponse` 객체에 접근할 수 있습니다. ### GetMyContentItemListAsync `static GetMyContentItemListAsync(itemKeyword: ItemKeyword, pageToken?: string) → BaseRequest` 아이템 카테고리별 아이템 목록을 가져오는 비동기 메서드입니다. | 매개변수 | 형식 | 설명 | | ----------------- | ----------------------------- | -------------------------------------------------- | | itemKeyword | [ItemKeyword](./#itemkeyword) | 아이템 카테고리입니다. | | pageToken (선택 사항) | `string` | 페이지 토큰입니다. 이 메서드를 처음 호출할 때는 이 매개변수를 `null`로 설정합니다. | **반환값:** `BaseRequest` — `BaseRequest` 객체입니다. 비동기 처리가 완료되면 `responseData` 속성을 통해 `ContentItemListResponse` 객체에 접근할 수 있습니다. ### GetContentItemAsync `static GetContentItemAsync(itemId: string) → BaseRequest` 아이템 정보를 가져오는 비동기 메서드입니다. | 매개변수 | 형식 | 설명 | | ------ | -------- | ---------- | | itemId | `string` | 아이템 코드입니다. | **반환값:** `BaseRequest` — `BaseRequest` 객체입니다. 비동기 처리가 완료되면 `responseData` 속성을 통해 `ContentItemResponse` 객체에 접근할 수 있습니다. ### GetMyWishContentItemListAsync `static GetMyWishContentItemListAsync() → BaseRequest` 로컬 플레이어 사용자 계정의 ZEPETO 상점 위시리스트에서 아이템 목록을 가져오는 비동기 메서드입니다. **반환값:** `BaseRequest` — `BaseRequest` 객체입니다. 비동기 처리가 완료되면 `responseData` 속성을 통해 `ContentItemListResponse` 객체에 접근할 수 있습니다. ## CategoryResponse `class` · extends `BaseResponse` `CategoryResponse` 클래스는 API 호출 결과와 ZEPETO 상점 아이템 카테고리 정보를 제공합니다. ### 속성 | 이름 | 형식 | 설명 | | -------- | ------------------------------- | ------------------------- | | category | [CategoryInfo](./#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\[\]](./#category) | 인벤토리 탭 하위의 아이템 카테고리 목록입니다. | ## Category `class` 아이템 카테고리입니다. ### 속성 | 이름 | 형식 | 설명 | | ----------- | ----------------------------- | ------------------------ | | displayName | `string` | 아이템 카테고리의 현지화된 표시 이름입니다. | | keyword | [ItemKeyword](./#itemkeyword) | 아이템 카테고리를 나타내는 열거형입니다. | ## ItemRequestType `enum` | 이름 | 값 | | -------- | - | | Purchase | 0 | | Gift | 1 |