# Catalog API

# Overview

* **Version:** 2.0.0
* **Servers**: `https://store.xsolla.com/api`
* **[Contact Us by Email](mailto:integration@xsolla.com)**
* **Contact URL:** https://xsolla.com/
* **Required TLS version:** 1.2

Catalog API는 인게임 스토어 카탈로그를 관리하고 구매를 처리하기 위한 엔드포인트를 제공합니다. 엔드포인트를 사용하여 가상 아이템, 인게임 재화, 게임 키, 번들, 장바구니 및 결제 플로우, 아이템 속성을 구성하고 외부 소스에서 아이템을 가져올 수 있습니다. 

Version: 2.0.0

## Servers

```
https://store.xsolla.com/api
```

## Security

### AuthForCart

게임이 포함된 장바구니를 판매할 때 [권한 없이 엔드포인트를 호출할 수 있습니다](/ko/doc/buy-button/how-to/set-up-authentication/#guides_buy_button_selling_items_not_authenticated_users).

이렇게 하려면 다음을 수행합니다.

* 게임 머리글의 `x-unauthorized-id` 매개 변수에 고유 식별자를 추가합니다.
* 게임 헤더의 `x-user` 매개 변수(Base64 인코딩)에 사용자 이메일 추가.

기본적으로 엑솔라 로그인 사용자 JWT(전달자 토큰)는 인증에 사용됩니다. 테스트 엑솔라 로그인 사용자 JWT 토큰인 `Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE5NjIyMzQwNDgsImlzcyI6Imh0dHBzOi8vbG9naW4ueHNvbGxhLmNvbSIsImlhdCI6MTU2MjE0NzY0OCwidXNlcm5hbWUiOiJ4c29sbGEiLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6IjA2SWF2ZHpDeEVHbm5aMTlpLUc5TmMxVWFfTWFZOXhTR3ZEVEY4OFE3RnMiLCJzdWIiOiJkMzQyZGFkMi05ZDU5LTExZTktYTM4NC00MjAxMGFhODAwM2YiLCJlbWFpbCI6InN1cHBvcnRAeHNvbGxhLmNvbSIsInR5cGUiOiJ4c29sbGFfbG9naW4iLCJ4c29sbGFfbG9naW5fcHJvamVjdF9pZCI6ImU2ZGZhYWM2LTc4YTgtMTFlOS05MjQ0LTQyMDEwYWE4MDAwNCIsInB1Ymxpc2hlcl9pZCI6MTU5MjR9.GCrW42OguZbLZTaoixCZgAeNLGH2xCeJHxl8u8Xn2aI`로 이 엔드포인트를 호출할 수 있습니다.

대안으로 [페이 스테이션 액세스 토큰](https://developers.xsolla.com/ko/api/pay-station/operation/create-token/)을 사용할 수 있습니다.

Type: http
Scheme: bearer

### XsollaLoginUserJWT

기본적으로 엑솔라 로그인 사용자 JWT(전달자 토큰)는 인증에 사용됩니다. 테스트 엑솔라 로그인 사용자 JWT 토큰인 `Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE5NjIyMzQwNDgsImlzcyI6Imh0dHBzOi8vbG9naW4ueHNvbGxhLmNvbSIsImlhdCI6MTU2MjE0NzY0OCwidXNlcm5hbWUiOiJ4c29sbGEiLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6IjA2SWF2ZHpDeEVHbm5aMTlpLUc5TmMxVWFfTWFZOXhTR3ZEVEY4OFE3RnMiLCJzdWIiOiJkMzQyZGFkMi05ZDU5LTExZTktYTM4NC00MjAxMGFhODAwM2YiLCJlbWFpbCI6InN1cHBvcnRAeHNvbGxhLmNvbSIsInR5cGUiOiJ4c29sbGFfbG9naW4iLCJ4c29sbGFfbG9naW5fcHJvamVjdF9pZCI6ImU2ZGZhYWM2LTc4YTgtMTFlOS05MjQ0LTQyMDEwYWE4MDAwNCIsInB1Ymxpc2hlcl9pZCI6MTU5MjR9.GCrW42OguZbLZTaoixCZgAeNLGH2xCeJHxl8u8Xn2aI`로 이 엔드포인트를 호출할 수 있습니다.

대안으로 [페이 스테이션 액세스 토큰](https://developers.xsolla.com/ko/api/pay-station/operation/create-token/)을 사용할 수 있습니다.

Type: http
Scheme: bearer
Bearer Format: JWT

### basicAuth

엑솔라 API는 기본 액세스 인증을 사용합니다. API에 대한 모든 요청에는 `Authorization: Basic <your_authorization_basic_key>` 헤더가 포함되어야 하며 여기서 `your_authorization_basic_key`는 Base64 표준에 따라 인코딩된 `project_id:api_key` 쌍입니다.

필요한 경우 `project_id` 대신 `merchant_id`를 사용할 수 있습니다. 기능에는 영향을 미치지 않습니다.

다음과 같이 매개 변수 값을 확인하려면 [관리자 페이지](https://publisher.xsolla.com/)로 이동합니다.

* `merchant_id` 다음과 같이 표시됩니다.
  * **회사 설정 > 회사** 섹션에서
  * 관리자 페이지의 브라우저 주소 표시줄에 있는 URL에 있습니다. URL의 형식은 
    `https://publisher.xsolla.com/<merchant_id>`입니다.
* `api_key`는 관리자 페이지가 생성될 때 한 번만 표시되며 사용자 측에 저장해야 합니다. 다음 섹션에서 새 키를 만들 수 있습니다.
  * **회사 설정 > API 키**
  * **프로젝트 설정 > API 키**
* `project_id`는 다음과 같이 표시됩니다.
  * 프로젝트 이름 옆의 관리자 페이지에 있습니다.
  * 브라우저 주소 표시줄의 URL에서 관리자 페이지의 프로젝트 작업 시 URL의 형식은 
    `https://publisher.xsolla.com/<merchant_id>/projects/<project_id>`입니다.

API 키 작업에 대한 자세한 정보는 [API 레퍼런스](https://developers.xsolla.com/ko/api/getting-started/#api_keys_overview)를 참조하세요.

Type: http
Scheme: basic

### basicMerchantAuth

엑솔라 API는 기본 액세스 인증을 사용합니다. API에 대한 모든 요청에는 `Authorization: Basic <your_authorization_basic_key>` 헤더가 포함되어야 하며 여기서 `your_authorization_basic_key`는 Base64 표준에 따라 인코딩된 `merchant_id:api_key` 쌍입니다.

다음과 같이 매개 변수 값을 확인하려면 [관리자 페이지](https://publisher.xsolla.com/)로 이동합니다.

* `merchant_id` 다음과 같이 표시됩니다.
  * **회사 설정 > 회사** 섹션에서
  * 관리자 페이지의 브라우저 주소 표시줄에 있는 URL에 있습니다. URL의 형식은 
    `https://publisher.xsolla.com/<merchant_id>`입니다.
* `api_key`는 관리자 페이지가 생성될 때 한 번만 표시되며 사용자 측에 저장해야 합니다. 다음 섹션에서 새 키를 만들 수 있습니다.
  * **회사 설정 > API 키**
  * **프로젝트 설정 > API 키**

API 키 작업에 대한 자세한 정보는 [API 레퍼런스](https://developers.xsolla.com/ko/api/getting-started/#api_keys_overview)를 참조하세요.

Type: http
Scheme: basic

## Download OpenAPI description

[Catalog API](https://developers.xsolla.com/_bundle/@l10n/ko/api/catalog/index.yaml)

## 관리자

### 인게임 재화 목록 가져오기

 - [GET /v2/project/{project_id}/admin/items/virtual_currency](https://developers.xsolla.com/ko/api/catalog/virtual-items-currency-admin/admin-get-virtual-currencies-list.md): 관리를 위해 프로젝트 내부의 인게임 재화 목록을 가져옵니다.

참고스토어 카탈로그를 빌드하기 위해 이 엔드포인트를 사용해선 안 됩니다.

### 인게임 재화 생성하기

 - [POST /v2/project/{project_id}/admin/items/virtual_currency](https://developers.xsolla.com/ko/api/catalog/virtual-items-currency-admin/admin-create-virtual-currency.md): 인게임 재화를 생성합니다.

### 인게임 재화 패키지 목록 가져오기(관리자)

 - [GET /v2/project/{project_id}/admin/items/virtual_currency/package](https://developers.xsolla.com/ko/api/catalog/virtual-items-currency-admin/admin-get-virtual-currency-packages-list.md): 관리를 위해 프로젝트 내부의 인게임 재화 목록을 가져옵니다.

참고스토어 카탈로그를 빌드하기 위해 이 엔드포인트를 사용해선 안 됩니다.

### 인게임 재화 패키지 생성하기

 - [POST /v2/project/{project_id}/admin/items/virtual_currency/package](https://developers.xsolla.com/ko/api/catalog/virtual-items-currency-admin/admin-create-virtual-currency-package.md): 인게임 재화 패키지를 생성합니다.

### 인게임 재화 패키지 삭제

 - [DELETE /v2/project/{project_id}/admin/items/virtual_currency/package/sku/{item_sku}](https://developers.xsolla.com/ko/api/catalog/virtual-items-currency-admin/admin-delete-virtual-currency-package.md): 인게임 재화 패키지를 삭제합니다.

### 인게임 재화 패키지 가져오기

 - [GET /v2/project/{project_id}/admin/items/virtual_currency/package/sku/{item_sku}](https://developers.xsolla.com/ko/api/catalog/virtual-items-currency-admin/admin-get-virtual-currency-package.md): 관리를 위해 프로젝트 내부의 인게임 재화 패키지를 가져옵니다.

참고스토어 카탈로그를 빌드하기 위해 이 엔드포인트를 사용해선 안 됩니다.

### 인게임 재화 패키지 업데이트

 - [PUT /v2/project/{project_id}/admin/items/virtual_currency/package/sku/{item_sku}](https://developers.xsolla.com/ko/api/catalog/virtual-items-currency-admin/admin-update-virtual-currency-package.md): 인게임 재화 패키지 업데이트

### 인게임 재화 삭제

 - [DELETE /v2/project/{project_id}/admin/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/ko/api/catalog/virtual-items-currency-admin/admin-delete-virtual-currency.md): 인게임 재화를 삭제합니다.

### 인게임 재화 가져오기

 - [GET /v2/project/{project_id}/admin/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/ko/api/catalog/virtual-items-currency-admin/admin-get-virtual-currency.md): 관리를 위해 프로젝트 내부의 인게임 재화를 가져옵니다.

참고스토어 카탈로그를 빌드하기 위해 이 엔드포인트를 사용해선 안 됩니다.

### 인게임 재화 업데이트

 - [PUT /v2/project/{project_id}/admin/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/ko/api/catalog/virtual-items-currency-admin/admin-update-virtual-currency.md): 인게임 재화를 업데이트합니다.

### 가상 아이템 목록 가져오기

 - [GET /v2/project/{project_id}/admin/items/virtual_items](https://developers.xsolla.com/ko/api/catalog/virtual-items-currency-admin/admin-get-virtual-items-list.md): 관리를 위해 프로젝트 내부의 가상 아이템 목록을 가져옵니다.

참고스토어 카탈로그를 빌드하기 위해 이 엔드포인트를 사용해선 안 됩니다.

### 가상 아이템 생성하기

 - [POST /v2/project/{project_id}/admin/items/virtual_items](https://developers.xsolla.com/ko/api/catalog/virtual-items-currency-admin/admin-create-virtual-item.md): 가상 아이템을 생성합니다.

### 지정한 그룹 외부 ID로 가상 아이템 목록 가져오기

 - [GET /v2/project/{project_id}/admin/items/virtual_items/group/external_id/{external_id}](https://developers.xsolla.com/ko/api/catalog/virtual-items-currency-admin/admin-get-virtual-items-list-by-group-external-id.md): 관리를 위해 그룹 내부의 가상 아이템 목록을 가져옵니다.

참고스토어 카탈로그를 빌드하기 위해 이 엔드포인트를 사용해선 안 됩니다.

### 지정한 그룹 ID로 가상 아이템 목록 가져오기

 - [GET /v2/project/{project_id}/admin/items/virtual_items/group/id/{group_id}](https://developers.xsolla.com/ko/api/catalog/virtual-items-currency-admin/admin-get-virtual-items-list-by-group-id.md): 관리를 위해 그룹 내부의 가상 아이템 목록을 가져옵니다.

참고스토어 카탈로그를 빌드하기 위해 이 엔드포인트를 사용해선 안 됩니다.

### 가상 아이템 삭제

 - [DELETE /v2/project/{project_id}/admin/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/ko/api/catalog/virtual-items-currency-admin/admin-delete-virtual-item.md): 가상 아이템을 삭제합니다.

### 가상 아이템 가져오기

 - [GET /v2/project/{project_id}/admin/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/ko/api/catalog/virtual-items-currency-admin/admin-get-virtual-item.md): 관리를 위해 프로젝트 내부의 가상 아이템을 가져옵니다.

참고스토어 카탈로그를 빌드하기 위해 이 엔드포인트를 사용해선 안 됩니다.

### 가상 아이템 업데이트

 - [PUT /v2/project/{project_id}/admin/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/ko/api/catalog/virtual-items-currency-admin/admin-update-virtual-item.md): 가상 아이템을 업데이트합니다.

## 카탈로그

### 아이템 그룹 목록 가져오기

 - [GET /v2/project/{project_id}/items/groups](https://developers.xsolla.com/ko/api/catalog/virtual-items-currency-catalog/get-item-groups.md): 카탈로그를 작성을 위해 아이템 그룹 목록을 가져옵니다.

### 인게임 재화 목록 가져오기

 - [GET /v2/project/{project_id}/items/virtual_currency](https://developers.xsolla.com/ko/api/catalog/virtual-items-currency-catalog/get-virtual-currency.md): 카탈로그 작성을 위해 인게임 재화 목록을 가져옵니다.

주의모든 프로젝트에는 응답에서 얻을 수 있는 아이템 수에 제한이 있습니다. 기본값과 최대값은 응답당 50개 아이템입니다. 페이지별로 더 많은 데이터 페이지를 가져오려면 제한 및 오프셋 필드를 사용합니다.  참고일반적으로 아이템 카탈로그 API 호출은 권한이 없어도 사용할 수 있지만 인증 헤더에서 사용자 JWT를 전달한 경우에만 사용자 맞춤형 카탈로그를 가져올 수 있습니다.

### 인게임 재화 패키지 목록 가져오기

 - [GET /v2/project/{project_id}/items/virtual_currency/package](https://developers.xsolla.com/ko/api/catalog/virtual-items-currency-catalog/get-virtual-currency-package.md): 카탈로그 작성을 위해 인게임 재화 패키지 목록을 가져옵니다.

주의모든 프로젝트에는 응답에서 얻을 수 있는 아이템 수에 제한이 있습니다. 기본값과 최대값은 응답당 50개 아이템입니다. 페이지별로 더 많은 데이터 페이지를 가져오려면 제한 및 오프셋 필드를 사용합니다.  참고일반적으로 아이템 카탈로그 API 호출은 권한이 없어도 사용할 수 있지만 인증 헤더에서 사용자 JWT를 전달한 경우에만 사용자 맞춤형 카탈로그를 가져올 수 있습니다.

### SKU별 인게임 재화 패키지 받기

 - [GET /v2/project/{project_id}/items/virtual_currency/package/sku/{virtual_currency_package_sku}](https://developers.xsolla.com/ko/api/catalog/virtual-items-currency-catalog/get-virtual-currency-package-sku.md): 카탈로그를 작성하기 위해 SKU별로 가상 재화 패키지를 가져옵니다.
참고권한 부여 없이 액세스할 수 있는 이 끝점은 일반 데이터를 반환합니다. 그러나 권한 부여는 사용 가능한 사용자 제한 및 프로모션과 같은 개인화된 결과에 대한 사용자별 세부 정보로 응답을 보강합니다.

### SKU별로 인게임 재화 가져오기

 - [GET /v2/project/{project_id}/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/ko/api/catalog/virtual-items-currency-catalog/get-virtual-currency-sku.md): 카탈로그 빌드를 위해 SKU별로 인게임 재화를 가져옵니다.
참고권한 부여 없이 액세스할 수 있는 이 끝점은 일반 데이터를 반환합니다. 그러나 권한 부여는 사용 가능한 사용자 제한 및 프로모션과 같은 개인화된 결과에 대한 사용자별 세부 정보로 응답을 보강합니다.

### 가상 아이템 목록 가져오기

 - [GET /v2/project/{project_id}/items/virtual_items](https://developers.xsolla.com/ko/api/catalog/virtual-items-currency-catalog/get-virtual-items.md): 카탈로그 작성을 위해 아이템 목록을 가져옵니다.

주의모든 프로젝트에는 응답에서 얻을 수 있는 아이템 수에 제한이 있습니다. 기본값과 최대값은 응답당 50개 아이템입니다. 페이지별로 더 많은 데이터 페이지를 가져오려면 제한 및 오프셋 필드를 사용합니다.  참고아이템 카탈로그 API 호출은 권한이 없어도 사용할 수 있지만 인증 헤더에서 사용자 JWT를 전달한 경우에만 사용자 맞춤형 카탈로그를 가져올 수 있습니다.

### 모든 가상 아이템 목록 가져오기

 - [GET /v2/project/{project_id}/items/virtual_items/all](https://developers.xsolla.com/ko/api/catalog/virtual-items-currency-catalog/get-all-virtual-items.md): 클라이언트 측에서 검색할 모든 가상 아이템 목록을 가져옵니다.

주의 사항아이템 SKU, 이름, 그룹 및 설명만 반환합니다  참고아이템 카탈로그 API 호출은 권한이 없어도 사용할 수 있지만 인증 헤더에서 사용자 JWT를 전달한 경우에만 사용자 맞춤형 카탈로그를 가져올 수 있습니다.

### 지정한 그룹으로 아이템 목록 가져오기

 - [GET /v2/project/{project_id}/items/virtual_items/group/{external_id}](https://developers.xsolla.com/ko/api/catalog/virtual-items-currency-catalog/get-virtual-items-group.md): 카탈로그 작성을 위해 지정된 그룹에서 아이템 목록을 가져옵니다.

주의모든 프로젝트에는 응답에서 얻을 수 있는 아이템 수에 제한이 있습니다. 기본값 및 최대값은 응답당 50개 아이템입니다. 페이지별로 더 많은 데이터를 가져오려면 제한 및 오프셋 필드를 사용하세요.  참고권한 없이 액세스할 수 있는 이 엔드포인트는 일반 데이터를 반환합니다. 그러나 권한이 제공되면 사용 가능한 사용자 제한 및 프로모션과 같은 개인화된 결과를 제공하기 위해 사용자별 세부 정보를 사용하여 응답이 보강됩니다.

### SKU별로 가상 아이템 가져오기

 - [GET /v2/project/{project_id}/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/ko/api/catalog/virtual-items-currency-catalog/get-virtual-items-sku.md): 카탈로그 빌드를 위해 SKU별로 가상 아이템을 가져옵니다.
참고권한 부여 없이 액세스할 수 있는 이 끝점은 일반 데이터를 반환합니다. 그러나 권한 부여는 사용 가능한 사용자 제한 및 프로모션과 같은 개인화된 결과에 대한 사용자별 세부 정보로 응답을 보강합니다.

## 가상 결제

### 특정 아이템을 인게임 재화로 구매하는 주문 생성

 - [POST /v2/project/{project_id}/payment/item/{item_sku}/virtual/{virtual_currency_sku}](https://developers.xsolla.com/ko/api/catalog/virtual-payment/create-order-with-item-for-virtual-currency.md): 인게임 재화를 사용하는 아이템 구매를 생성합니다.

## 카탈로그

### 게임 목록 가져오기

 - [GET /v2/project/{project_id}/items/game](https://developers.xsolla.com/ko/api/catalog/game-keys-catalog/get-games-list.md): 카탈로그 작성을 위해 게임 목록을 가져옵니다.

주의모든 프로젝트에는 응답에서 얻을 수 있는 아이템 수에 제한이 있습니다. 기본값과 최대값은 응답당 50개 아이템입니다. 페이지별로 더 많은 데이터 페이지를 가져오려면 제한 및 오프셋 필드를 사용합니다.  참고일반적으로 아이템 카탈로그 API 호출은 권한이 없어도 사용할 수 있지만 인증 헤더에서 사용자 JWT를 전달한 경우에만 사용자 맞춤형 카탈로그를 가져올 수 있습니다.

### DRM 목록 가져오기

 - [GET /v2/project/{project_id}/items/game/drm](https://developers.xsolla.com/ko/api/catalog/game-keys-catalog/get-drm-list.md): 사용 가능한 DRM 목록을 가져옵니다.

### 지정한 그룹으로 게임 목록 가져오기

 - [GET /v2/project/{project_id}/items/game/group/{external_id}](https://developers.xsolla.com/ko/api/catalog/game-keys-catalog/get-games-group.md): 카탈로그 작성을 위해 지정된 그룹에서 게임 목록을 가져옵니다.

주의모든 프로젝트에는 응답에서 얻을 수 있는 아이템 수에 제한이 있습니다. 기본값과 최대값은 응답당 50개 아이템입니다. 페이지별로 더 많은 데이터 페이지를 가져오려면 제한 및 오프셋 필드를 사용합니다.  참고일반적으로 아이템 카탈로그 API 호출은 권한이 없어도 사용할 수 있지만 인증 헤더에서 사용자 JWT를 전달한 경우에만 사용자 맞춤형 카탈로그를 가져올 수 있습니다.

### 지정한 그룹으로 게임 키 목록 가져오기

 - [GET /v2/project/{project_id}/items/game/key/group/{external_id}](https://developers.xsolla.com/ko/api/catalog/game-keys-catalog/get-game-keys-group.md): 카탈로그 작성을 위해 지정된 그룹에서 게임 키를 가져옵니다.

주의모든 프로젝트에는 응답에서 얻을 수 있는 아이템 수에 제한이 있습니다. 기본값과 최대값은 응답당 50개 아이템입니다. 페이지별로 더 많은 데이터 페이지를 가져오려면 제한 및 오프셋 필드를 사용합니다.  참고아이템 카탈로그 API 호출은 권한이 없어도 사용할 수 있지만 인증 헤더에서 사용자 JWT를 전달한 경우에만 사용자 맞춤형 카탈로그를 가져올 수 있습니다.

### 카탈로그에 게임 키 가져오기

 - [GET /v2/project/{project_id}/items/game/key/sku/{item_sku}](https://developers.xsolla.com/ko/api/catalog/game-keys-catalog/get-game-key-by-sku.md): 카탈로그에 대한 게임 키를 가져옵니다.

참고권한 없이 액세스할 수 있는 이 엔드포인트는 일반 데이터를 반환합니다. 그러나 권한이 제공되면 사용 가능한 사용자 제한 및 프로모션과 같은 개인화된 결과를 제공하기 위해 사용자별 세부 정보를 사용하여 응답이 보강됩니다.

### 카탈로그에 게임 가져오기

 - [GET /v2/project/{project_id}/items/game/sku/{item_sku}](https://developers.xsolla.com/ko/api/catalog/game-keys-catalog/get-game-by-sku.md): 카탈로그용 게임을 가져옵니다.

참고권한 부여 없이 액세스할 수 있는 이 끝점은 일반 데이터를 반환합니다. 그러나 권한 부여는 사용 가능한 사용자 제한 및 프로모션과 같은 개인화된 결과에 대한 사용자별 세부 정보로 응답을 보강합니다.

## 권한

### 권한 부여(관리자)

 - [POST /v2/project/{project_id}/admin/entitlement/grant](https://developers.xsolla.com/ko/api/catalog/game-keys-entitlement/grant-entitlement-admin.md): 사용자에게 권한을 부여합니다.

주의DRM Free 플랫폼용 게임 코드 또는 게임에만 권한을 부여할 수 있습니다.

### 권한 취소(관리자)

 - [POST /v2/project/{project_id}/admin/entitlement/revoke](https://developers.xsolla.com/ko/api/catalog/game-keys-entitlement/revoke-entitlement-admin.md): 사용자의 권한을 취소합니다.

주의DRM Free 플랫폼용 게임 코드 또는 게임만 취소할 수 있습니다.

### 사용자가 소유한 게임 목록 가져오기

 - [GET /v2/project/{project_id}/entitlement](https://developers.xsolla.com/ko/api/catalog/game-keys-entitlement/get-user-games.md): 사용자가 소유한 게임 목록을 가져옵니다. 응답에 특정 사용자가 소유한 게임 배열이 포함됩니다.

주의모든 프로젝트에는 응답에서 얻을 수 있는 아이템 수에 제한이 있습니다. 기본값과 최대값은 응답당 50개 아이템입니다. 페이지별로 더 많은 데이터 페이지를 가져오려면 제한 및 오프셋 필드를 사용합니다.

### 클라이언트로 게임 코드 사용하기

 - [POST /v2/project/{project_id}/entitlement/redeem](https://developers.xsolla.com/ko/api/catalog/game-keys-entitlement/redeem-game-pin-code.md): 제공된 게임 코드로 권한을 부여합니다.

주의DRM Free 플랫폼에만 코드를 사용할 수 있습니다.

## 관리자

### 게임 목록 가져오기(관리자)

 - [GET /v2/project/{project_id}/admin/items/game](https://developers.xsolla.com/ko/api/catalog/game-keys-admin/admin-get-game-list.md): 관리를 위해 프로젝트 내부의 게임 목록을 가져옵니다.
게임은 사용자가 구매할 수 있는 게임 키로 구성되어 있습니다.

참고스토어 카탈로그를 빌드하기 위해 이 엔드포인트를 사용해선 안 됩니다.

### 게임 생성하기

 - [POST /v2/project/{project_id}/admin/items/game](https://developers.xsolla.com/ko/api/catalog/game-keys-admin/admin-create-game.md): 프로젝트에서 게임을 생성합니다.

### ID로 게임 삭제

 - [DELETE /v2/project/{project_id}/admin/items/game/id/{item_id}](https://developers.xsolla.com/ko/api/catalog/game-keys-admin/admin-delete-game-by-id.md): ID로 프로젝트의 게임을 삭제합니다.

### ID로 게임 가져오기(관리자)

 - [GET /v2/project/{project_id}/admin/items/game/id/{item_id}](https://developers.xsolla.com/ko/api/catalog/game-keys-admin/admin-get-game-by-id.md): 관리를 위해 게임을 가져옵니다.
게임은 사용자가 구매할 수 있는 게임 키로 구성되어 있습니다.

참고스토어 카탈로그를 빌드하기 위해 이 엔드포인트를 사용해선 안 됩니다.

### ID로 게임 업데이트

 - [PUT /v2/project/{project_id}/admin/items/game/id/{item_id}](https://developers.xsolla.com/ko/api/catalog/game-keys-admin/admin-update-game-by-id.md): 프로젝트의 게임을 ID로 업데이트합니다.

### ID로 코드 삭제하기

 - [DELETE /v2/project/{project_id}/admin/items/game/key/delete/id/{item_id}](https://developers.xsolla.com/ko/api/catalog/game-keys-admin/admin-delete-codes-by-id.md): 게임 키 ID로 모든 코드를 삭제합니다.

### 코드 삭제하기

 - [DELETE /v2/project/{project_id}/admin/items/game/key/delete/sku/{item_sku}](https://developers.xsolla.com/ko/api/catalog/game-keys-admin/admin-delete-codes-by-sku.md): 게임 키 SKU로 모든 코드를 삭제합니다.

### ID로 코드 가져오기

 - [GET /v2/project/{project_id}/admin/items/game/key/request/id/{item_id}](https://developers.xsolla.com/ko/api/catalog/game-keys-admin/admin-get-codes-by-id.md): 게임 키 ID로 특정 수의 코드를 가져옵니다.

### 코드 가져오기

 - [GET /v2/project/{project_id}/admin/items/game/key/request/sku/{item_sku}](https://developers.xsolla.com/ko/api/catalog/game-keys-admin/admin-get-codes-by-sku.md): 게임 키 SKU로 특정 수의 코드를 가져옵니다.

### ID로 코드 업로드

 - [POST /v2/project/{project_id}/admin/items/game/key/upload/id/{item_id}](https://developers.xsolla.com/ko/api/catalog/game-keys-admin/admin-upload-codes-by-id.md): 게임 키 ID로 코드를 업로드합니다.

### 세션 정보를 로드하는 코드 가져오기

 - [GET /v2/project/{project_id}/admin/items/game/key/upload/session/{session_id}](https://developers.xsolla.com/ko/api/catalog/game-keys-admin/admin-get-codes-session.md): 세션 정보를 로드하는 코드를 가져옵니다.

### 코드 업로드

 - [POST /v2/project/{project_id}/admin/items/game/key/upload/sku/{item_sku}](https://developers.xsolla.com/ko/api/catalog/game-keys-admin/admin-upload-codes-by-sku.md): 게임 키 SKU로 코드를 업로드합니다.

### SKU로 게임 삭제

 - [DELETE /v2/project/{project_id}/admin/items/game/sku/{item_sku}](https://developers.xsolla.com/ko/api/catalog/game-keys-admin/admin-delete-game-by-sku.md): SKU로 프로젝트에 있는 게임을 삭제합니다.

### 게임 가져오기(관리자)

 - [GET /v2/project/{project_id}/admin/items/game/sku/{item_sku}](https://developers.xsolla.com/ko/api/catalog/game-keys-admin/admin-get-game-by-sku.md): 관리를 위해 게임을 가져옵니다.
게임은 사용자가 구매할 수 있는 게임 키로 구성되어 있습니다.

참고스토어 카탈로그를 빌드하기 위해 이 엔드포인트를 사용해선 안 됩니다.

### SKU로 게임 업데이트

 - [PUT /v2/project/{project_id}/admin/items/game/sku/{item_sku}](https://developers.xsolla.com/ko/api/catalog/game-keys-admin/admin-update-game-by-sku.md): SKU로 프로젝트에 있는 게임을 업데이트합니다.

## 관리자

### 번들 목록 가져오기

 - [GET /v2/project/{project_id}/admin/items/bundle](https://developers.xsolla.com/ko/api/catalog/bundles-admin/admin-get-bundle-list.md): 관리를 위해 프로젝트 내부의 번들 목록을 가져옵니다.

참고스토어 카탈로그를 빌드하기 위해 이 엔드포인트를 사용해선 안 됩니다.

### 번들 생성하기

 - [POST /v2/project/{project_id}/admin/items/bundle](https://developers.xsolla.com/ko/api/catalog/bundles-admin/admin-create-bundle.md): 번들을 생성합니다.

### 지정한 그룹 외부 ID로 번들 목록 가져오기

 - [GET /v2/project/{project_id}/admin/items/bundle/group/external_id/{external_id}](https://developers.xsolla.com/ko/api/catalog/bundles-admin/admin-get-bundle-list-in-group-by-external-id.md): 관리를 위해 그룹 내부의 번들 목록을 가져옵니다.

참고스토어 카탈로그를 빌드하기 위해 이 엔드포인트를 사용해선 안 됩니다.

### 지정한 그룹 ID로 번들 목록 가져오기

 - [GET /v2/project/{project_id}/admin/items/bundle/group/id/{group_id}](https://developers.xsolla.com/ko/api/catalog/bundles-admin/admin-get-bundle-list-in-group-by-id.md): 관리를 위해 그룹 내부의 번들 목록을 가져옵니다.

참고스토어 카탈로그를 빌드하기 위해 이 엔드포인트를 사용해선 안 됩니다.

### 번들 삭제

 - [DELETE /v2/project/{project_id}/admin/items/bundle/sku/{sku}](https://developers.xsolla.com/ko/api/catalog/bundles-admin/admin-delete-bundle.md): 번들을 삭제합니다.

### 번들 가져오기

 - [GET /v2/project/{project_id}/admin/items/bundle/sku/{sku}](https://developers.xsolla.com/ko/api/catalog/bundles-admin/admin-get-bundle.md): 관리를 위해 프로젝트 내부의 번들을 가져옵니다.

참고스토어 카탈로그를 빌드하기 위해 이 엔드포인트를 사용해선 안 됩니다.

### 번들 업데이트

 - [PUT /v2/project/{project_id}/admin/items/bundle/sku/{sku}](https://developers.xsolla.com/ko/api/catalog/bundles-admin/admin-update-bundle.md): 번들을 업데이트합니다.

### 카탈로그에서 번들 숨기기

 - [PUT /v2/project/{project_id}/admin/items/bundle/sku/{sku}/hide](https://developers.xsolla.com/ko/api/catalog/bundles-admin/admin-hide-bundle.md): 카탈로그에서 번들을 숨깁니다.

### 카탈로그에 번들 표시

 - [PUT /v2/project/{project_id}/admin/items/bundle/sku/{sku}/show](https://developers.xsolla.com/ko/api/catalog/bundles-admin/admin-show-bundle.md): 카탈로그에 번들을 표시합니다.

## 카탈로그

### 번들 목록 가져오기

 - [GET /v2/project/{project_id}/items/bundle](https://developers.xsolla.com/ko/api/catalog/bundles-catalog/get-bundle-list.md): 카탈로그 작성을 위해 번들 목록을 가져옵니다.

주의모든 프로젝트에는 응답에서 얻을 수 있는 아이템 수에 제한이 있습니다. 기본값과 최대값은 응답당 50개 아이템입니다.  참고아이템 카탈로그 API 호출은 권한이 없어도 사용할 수 있지만 인증 헤더에서 사용자 JWT를 전달한 경우에만 사용자 맞춤형 카탈로그를 가져올 수 있습니다.

### 지정한 그룹으로 번들 목록 가져오기

 - [GET /v2/project/{project_id}/items/bundle/group/{external_id}](https://developers.xsolla.com/ko/api/catalog/bundles-catalog/get-bundle-list-in-group.md): 카탈로그 작성을 위해 그룹 내 번들 목록을 가져옵니다.

주의모든 프로젝트에는 응답에서 얻을 수 있는 아이템 수에 제한이 있습니다. 기본값과 최대값은 응답당 50개 아이템입니다.  참고일반적으로 아이템 카탈로그 API 호출은 권한이 없어도 사용할 수 있지만 인증 헤더에서 사용자 JWT를 전달한 경우에만 사용자 맞춤형 카탈로그를 가져올 수 있습니다.

### 지정한 번들 가져오기

 - [GET /v2/project/{project_id}/items/bundle/sku/{sku}](https://developers.xsolla.com/ko/api/catalog/bundles-catalog/get-bundle.md): 지정된 번들을 가져옵니다.

참고권한 없이 액세스할 수 있는 이 끝점은 일반 데이터를 반환합니다. 그러나 권한 부여는 사용 가능한 사용자 제한 및 프로모션과 같은 개인화된 결과에 대한 사용자별 세부 정보로 응답을 강화합니다.

## 장바구니(클라이언트 측)

### 현재 사용자의 장바구니 가져오기

 - [GET /v2/project/{project_id}/cart](https://developers.xsolla.com/ko/api/catalog/cart-client-side/get-user-cart.md): 현재 사용자의 장바구니를 반환합니다.

### 현재 장바구니에서 모든 장바구니 아이템 삭제

 - [PUT /v2/project/{project_id}/cart/clear](https://developers.xsolla.com/ko/api/catalog/cart-client-side/cart-clear.md): 모든 장바구니 아이템을 삭제합니다.

### 아이템으로 장바구니 채우기

 - [PUT /v2/project/{project_id}/cart/fill](https://developers.xsolla.com/ko/api/catalog/cart-client-side/cart-fill.md): 장바구니를 아이템으로 채웁니다. 장바구니에 동일한 SKU를 가진 아이템이 이미 있으면 기존 아이템이 전달된 값으로 교체됩니다.

### 현재 장바구니에서 장바구니 아이템 삭제

 - [DELETE /v2/project/{project_id}/cart/item/{item_sku}](https://developers.xsolla.com/ko/api/catalog/cart-client-side/delete-item.md): 장바구니에서 아이템을 제거합니다.

### 현재 장바구니에서 장바구니 아이템 업데이트

 - [PUT /v2/project/{project_id}/cart/item/{item_sku}](https://developers.xsolla.com/ko/api/catalog/cart-client-side/put-item.md): 기존 장바구니 아이템을 업데이트하거나 장바구니에서 아이템을 생성합니다.

### 장바구니 ID로 장바구니 가져오기

 - [GET /v2/project/{project_id}/cart/{cart_id}](https://developers.xsolla.com/ko/api/catalog/cart-client-side/get-cart-by-id.md): 장바구니 ID로 사용자의 장바구니를 반환합니다.

### 장바구니 ID로 모든 장바구니 아이템 삭제하기

 - [PUT /v2/project/{project_id}/cart/{cart_id}/clear](https://developers.xsolla.com/ko/api/catalog/cart-client-side/cart-clear-by-id.md): 모든 장바구니 아이템을 삭제합니다.

### 아이템으로 특정 장바구니 채우기

 - [PUT /v2/project/{project_id}/cart/{cart_id}/fill](https://developers.xsolla.com/ko/api/catalog/cart-client-side/cart-fill-by-id.md): 특정 장바구니를 아이템으로 채웁니다. 장바구니에 동일한 SKU를 가진 아이템이 이미 있으면 기존 아이템의 위치가 전달된 값으로 교체됩니다.

### 장바구니 ID로 장바구니 아이템 삭제하기

 - [DELETE /v2/project/{project_id}/cart/{cart_id}/item/{item_sku}](https://developers.xsolla.com/ko/api/catalog/cart-client-side/delete-item-by-cart-id.md): 장바구니에서 아이템을 제거합니다.

### 장바구니 ID로 장바구니 아이템 업데이트하기

 - [PUT /v2/project/{project_id}/cart/{cart_id}/item/{item_sku}](https://developers.xsolla.com/ko/api/catalog/cart-client-side/put-item-by-cart-id.md): 기존 장바구니 아이템을 업데이트하거나 장바구니에서 아이템을 생성합니다.

## 장바구니(서버 측)

### 아이템으로 장바구니 채우기

 - [PUT /v2/admin/project/{project_id}/cart/fill](https://developers.xsolla.com/ko/api/catalog/cart-server-side/admin-cart-fill.md): 현재 장바구니를 아이템으로 채웁니다. 장바구니에 동일한 SKU를 가진 아이템이 이미 있으면 기존 아이템이 전달된 값으로 교체됩니다.

### 장바구니 ID를 사용하는 장바구니 아이템으로 채우기

 - [PUT /v2/admin/project/{project_id}/cart/{cart_id}/fill](https://developers.xsolla.com/ko/api/catalog/cart-server-side/admin-fill-cart-by-id.md): 장바구니 ID별로 장바구니를 아이템으로 채웁니다. 장바구니에 동일한 SKU를 가진 아이템이 이미 있으면 기존 아이템이 전달된 값으로 교체됩니다.

## 결제(클라이언트 측)

### 현재 장바구니의 모든 아이템을 사용하는 주문 생성

 - [POST /v2/project/{project_id}/payment/cart](https://developers.xsolla.com/ko/api/catalog/payment-client-side/create-order.md): 클라이언트-서버 연동에 사용됩니다. 특정 장바구니의 모든 아이템으로 주문을 생성하고 이에 대한 결제 토큰을 생성합니다. 생성된 주문은 new 주문 상태를 가져옵니다.

클라이언트 IP는 사용자의 국가를 확인하는 데 사용되며, 해당 통화 및 주문에 사용 사용할 수 있는 결제 방식을 적용하는 데 사용됩니다.

결제 UI를 새 창에서 열려면 https://secure.xsolla.com/paystation4/?token={token} 링크를 사용합니다. 여기서 {token}은 수신한 토큰입니다.

테스트를 진행할 때에는 https://sandbox-secure.xsolla.com/paystation4/?token={token} URL을 사용합니다.

참고이 방식은 IP를 사용하여 사용자의 국가를 확인하고 주문에 사용할 통화를 선택하므로 서버 측이 아닌 클라이언트 측에서만 이 방식을 사용해야 합니다. 서버 측에서 이 방식을 사용하면 통화가 잘못 결정되어 페이 스테이션의 결제 방식에 영향을 줄 수 있습니다.

### 특정 장바구니의 모든 아이템으로 주문 생성

 - [POST /v2/project/{project_id}/payment/cart/{cart_id}](https://developers.xsolla.com/ko/api/catalog/payment-client-side/create-order-by-cart-id.md): 클라이언트-서버 연동에 사용됩니다. 특정 장바구니의 모든 아이템으로 주문을 생성하고 이에 대한 결제 토큰을 생성합니다. 생성된 주문은 new 주문 상태를 가져옵니다.

클라이언트 IP는 사용자의 국가를 확인하는 데 사용되며, 해당 통화 및 주문에 사용 사용할 수 있는 결제 방식을 적용하는 데 사용됩니다.

결제 UI를 새 창에서 열려면 https://secure.xsolla.com/paystation4/?token={token} 링크를 사용합니다. 여기서 {token}은 수신한 토큰입니다.

테스트를 진행할 때에는 https://sandbox-secure.xsolla.com/paystation4/?token={token} URL을 사용합니다.

참고이 방식은 IP를 사용하여 사용자의 국가를 확인하고 주문에 사용할 통화를 선택하므로 서버 측이 아닌 클라이언트 측에서만 이 방식을 사용해야 합니다. 서버 측에서 이 방식을 사용하면 통화가 잘못 결정되어 페이 스테이션의 결제 방식에 영향을 줄 수 있습니다.

### 특정 아이템을 사용하는 주문 생성

 - [POST /v2/project/{project_id}/payment/item/{item_sku}](https://developers.xsolla.com/ko/api/catalog/payment-client-side/create-order-with-item.md): 클라이언트-서버 연동에 사용됩니다. 지정된 아이템으로 주문을 생성하고 이에 대한 결제 토큰을 생성합니다. 생성된 주문은 new 주문 상태를 가져옵니다.

클라이언트 IP는 사용자의 국가를 확인하는 데 사용되며, 해당 통화 및 주문에 사용 사용할 수 있는 결제 방식을 적용하는 데 사용됩니다.

결제 UI를 새 창에서 열려면 https://secure.xsolla.com/paystation4/?token={token} 링크를 사용합니다. 여기서 {token}은 수신한 토큰입니다.

테스트를 진행할 때에는 https://sandbox-secure.xsolla.com/paystation4/?token={token} URL을 사용합니다.

참고이 방식은 IP를 사용하여 사용자의 국가를 확인하고 주문에 사용할 통화를 선택하므로 서버 측이 아닌 클라이언트 측에서만 이 방식을 사용해야 합니다. 서버 측에서 이 방식을 사용하면 통화가 잘못 결정되어 페이 스테이션의 결제 방식에 영향을 줄 수 있습니다.

## 결제(서버 측)

### 구매용 결제 토큰 생성하기

 - [POST /v3/project/{project_id}/admin/payment/token](https://developers.xsolla.com/ko/api/catalog/payment-server-side/admin-create-payment-token.md): 주문 및 주문에 대한 지불 토큰을 생성합니다. 주문은 요청 본문에 전달된 아이템에 기반하여 생성됩니다.

새 창에서 결제 UI를 열려면 https://secure.xsolla.com/paystation4/?token={token} 링크를 사용하십시오. 여기에서 {token}은 받은 토큰입니다.

테스트 목적으로 https://sandbox-secure.xsolla.com/paystation4/?token={token} URL을 사용합니다.

참고
    
   user.country.value 매개 변수는 주문에 대한 통화를 선택하는 데 사용됩니다. 사용자의 국가를 알 수 없는 경우, 대신 
 X-User-Ip 헤더의 사용자 IP를 제공할 수 있습니다.  이 메서드가 적절히 작동하기 위해서는 두 가지 옵션 중 하나가 필요합니다.  선택한 통화는 페이 스테이션의 결제 방식에 사용됩니다.

## 주문

### 주문 가져오기

 - [GET /v2/project/{project_id}/order/{order_id}](https://developers.xsolla.com/ko/api/catalog/order/get-order.md): 지정한 주문을 검색합니다.

### 지정된 기간의 주문 목록 가져오기

 - [POST /v3/project/{project_id}/admin/order/search](https://developers.xsolla.com/ko/api/catalog/order/admin-order-search.md): 가장 빠른 생성 날짜부터 최근 생성 날짜 순으로 정렬된 주문 목록을 검색합니다.

## 무료 아이템

### 무료 장바구니로 주문 생성하기

 - [POST /v2/project/{project_id}/free/cart](https://developers.xsolla.com/ko/api/catalog/free-item/create-free-order.md): 무료 장바구니의 모든 아이템으로 주문을 생성합니다. 생성된 주문은 done 주문 상태를 가져옵니다.

### 특정 무료 장바구니로 주문 생성하기

 - [POST /v2/project/{project_id}/free/cart/{cart_id}](https://developers.xsolla.com/ko/api/catalog/free-item/create-free-order-by-cart-id.md): 특정 무료 장바구니의 모든 아이템으로 주문을 생성합니다. 생성된 주문은 done 주문 상태를 가져옵니다.

### 지정한 무료 아이템으로 주문 생성하기

 - [POST /v2/project/{project_id}/free/item/{item_sku}](https://developers.xsolla.com/ko/api/catalog/free-item/create-free-order-with-item.md): 지정한 무료 아이템으로 주문을 생성합니다. 생성된 주문은 done 주문 상태를 가져옵니다.

## 관리

### 지정된 사용자의 모든 구매 제한 설정 새로고침

 - [DELETE /v2/project/{project_id}/admin/user/limit/item/all](https://developers.xsolla.com/ko/api/catalog/user-limits-admin/reset-all-user-items-limit.md): 지정된 사용자가 해당 아이템을 다시 구매할 수 있도록 모든 아이템의 모든 구매 한도를 새로고침합니다.

사용자 제한 API를 사용하면 제한된 수량만 아이템을 판매할 수 있습니다. 구매 한도를 구성하려면 원하는 아이템 유형 모듈의 관리 섹션으로 이동합니다.
* 게임 키
* 가상 아이템 및 인게임 재화
* 번들

### 지정된 사용자가 사용할 수 있는 아이템 개수를 줄입니다

 - [DELETE /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/ko/api/catalog/user-limits-admin/remove-user-item-limit.md): 적용된 제한 설정 내에서 지정된 사용자가 사용할 수 있는 남은 아이템 개수를 줄입니다.

사용자 제한 API를 사용하면 제한된 수량만 아이템을 판매할 수 있습니다. 구매 한도를 구성하려면 원하는 아이템 유형 모듈의 관리 섹션으로 이동합니다.
* 게임 키
* 가상 아이템 및 인게임 재화
* 번들

### 지정된 사용자가 사용할 수 있는 아이템의 수량을 가져옵니다

 - [GET /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/ko/api/catalog/user-limits-admin/get-user-item-limit.md): 적용된 제한 설정 내에서 지정된 사용자가 사용할 수 있는 남은 아이템 개수를 가져옵니다.

사용자 제한 API를 사용하면 제한된 수량만 아이템을 판매할 수 있습니다. 구매 한도를 구성하려면 원하는 아이템 유형 모듈의 관리 섹션으로 이동합니다.
* 게임 키
* 가상 아이템 및 인게임 재화
* 번들

### 지정된 사용자가 사용할 수 있는 아이템의 수량을 늘립니다

 - [POST /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/ko/api/catalog/user-limits-admin/add-user-item-limit.md): 적용된 제한 설정 내에서 지정된 사용자가 사용할 수 있는 남은 아이템 개수를 늘립니다.

사용자 제한 API를 사용하면 제한된 수량만 아이템을 판매할 수 있습니다. 구매 한도를 구성하려면 원하는 아이템 유형 모듈의 관리 섹션으로 이동합니다.
* 게임 키
* 가상 아이템 및 인게임 재화
* 번들

### 지정된 사용자가 사용할 수 있는 아이템의 수량을 설정합니다

 - [PUT /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/ko/api/catalog/user-limits-admin/set-user-item-limit.md): 지정된 사용자가 제한 설정이 증가되거나 감소된 후 적용된 제한 설정 내에서 구매할 수 있는 아이템 개수를 설정합니다.

사용자 제한 API를 사용하면 제한된 수량만 아이템을 판매할 수 있습니다. 구매 한도를 구성하려면 원하는 아이템 유형 모듈의 관리 섹션으로 이동합니다.
* 게임 키
* 가상 아이템 및 인게임 재화
* 번들

### 구매 한도 새로고침

 - [DELETE /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}/all](https://developers.xsolla.com/ko/api/catalog/user-limits-admin/reset-user-item-limit.md): 사용자가 아이템을 다시 구입할 수 있도록 아이템의 구매 한도를 새로고침합니다. user 매개변수가 null인 경우 이 호출은 모든 사용자에 대해 이 제한을 새로고침합니다.

사용자 제한 API를 사용하면 제한된 수량만 아이템을 판매할 수 있습니다. 구매 한도를 구성하려면 원하는 아이템 유형 모듈의 관리 섹션으로 이동합니다.
* 게임 키
* 가상 아이템 및 인게임 재화
* 번들

## 관리자

### 아이템 가져오기 상태 검색

 - [GET /v1/admin/projects/{project_id}/connectors/import_items/import/status](https://developers.xsolla.com/ko/api/catalog/connector-admin/get-items-import-status.md): 프로젝트로 아이템을 가져오는 진행률에 대한 정보를 검색합니다. 이 API 호출은 API 또는 관리자 페이지 API를 통해 수행된 마지막 가져오기에 대한 데이터를 검색합니다.

### JSON 파일을 통해 아이템 가져오기

 - [POST /v1/projects/{project_id}/import/from_external_file](https://developers.xsolla.com/ko/api/catalog/connector-admin/import-items-from-external-file.md): 지정된 URL을 통해 JSON 파일에서 스토어로 아이템을 가져옵니다. JSON 파일에서 가져오기에 대한 자세한 정보는 설명서를 참조하세요.

## 웹훅

### 웹훅 설정에 대한 정보 가져오기

 - [GET /v2/project/{project_id}/admin/webhook](https://developers.xsolla.com/ko/api/catalog/common-webhooks/get-webhook.md): 스토어의 웹훅 설정에 대한 정보를 가져옵니다.
자세한 정보는 웹훅 설명서를 확인하십시오.

### 웹훅 설정에 대한 정보 업데이트

 - [PUT /v2/project/{project_id}/admin/webhook](https://developers.xsolla.com/ko/api/catalog/common-webhooks/update-webhook.md): 스토어의 웹훅 설정에 대한 정보를 업데이트합니다.
자세한 정보는 웹훅 설명서를 참조하세요.

## 선주문

### 아이템의 사전 판매 수량 제한 제거

 - [DELETE /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/ko/api/catalog/common-pre-orders/remove-pre-order-limit.md): 아이템의 사전 판매 수량 제한을 제거합니다.

사전 판매 제한 API를 사용하면 제한된 수량의 아이템을 판매할 수 있습니다. 사전 판매를 구성하려면 원하는 아이템 모듈의 관리자 섹션으로 이동합니다.
* 게임 키
* 가상 아이템 및 인게임 재화
* 번들

이 엔드포인트의 별칭:
* /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id}

### 아이템의 사전 판매 제한에 대한 정보 가져오기

 - [GET /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/ko/api/catalog/common-pre-orders/get-pre-order-limit.md): 아이템의 사전 판매 수량 제한을 가져옵니다.

사전 판매 제한 API를 사용하면 제한된 수량의 아이템을 판매할 수 있습니다. 사전 판매를 구성하려면 원하는 아이템 모듈의 관리자 섹션으로 이동합니다.
* 게임 키
* 가상 아이템 및 인게임 재화
* 번들

이 엔드포인트의 별칭:
* /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id}

### 아이템 사전 판매 제한에 수량 추가하기

 - [POST /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/ko/api/catalog/common-pre-orders/add-pre-order-limit.md): 아이템의 사전 판매 수량 제한에 수량을 추가합니다.

사전 판매 제한 API를 사용하면 제한된 수량의 아이템을 판매할 수 있습니다. 사전 판매를 구성하려면 원하는 아이템 모듈의 관리자 섹션으로 이동합니다.
* 게임 키
* 가상 아이템 및 인게임 재화
* 번들

이 엔드포인트의 별칭:
* /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id}

### 아이템의 사전 판매 수량 제한 설정

 - [PUT /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/ko/api/catalog/common-pre-orders/set-pre-order-limit.md): 아이템의 사전 판매 수량 제한에 대한 수량을 설정합니다.

사전 판매 제한 API를 사용하면 제한된 수량의 아이템을 판매할 수 있습니다. 사전 판매를 구성하려면 원하는 아이템 모듈의 관리자 섹션으로 이동합니다.
* 게임 키
* 가상 아이템 및 인게임 재화
* 번들

이 엔드포인트의 별칭:
* /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id}

### 아이템의 모든 사전 판매 수량 제한 제거

 - [DELETE /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}/all](https://developers.xsolla.com/ko/api/catalog/common-pre-orders/remove-all-pre-order-limit.md): 아이템의 모든 사전 판매 수량 제한을 제거합니다.

사전 판매 제한 API를 사용하면 제한된 수량의 아이템을 판매할 수 있습니다. 사전 판매를 구성하려면 원하는 아이템 모듈의 관리자 섹션으로 이동합니다.
* 게임 키
* 가상 아이템 및 인게임 재화
* 번들

이 엔드포인트의 별칭:
* /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id}

### 아이템의 사전 판매 제한 토글

 - [PUT /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}/toggle](https://developers.xsolla.com/ko/api/catalog/common-pre-orders/toggle-pre-order-limit.md): 아이템의 사전 판매 수량 제한을 활성화/비활성화합니다.

사전 판매 제한 API를 사용하면 제한된 수량의 아이템을 판매할 수 있습니다. 사전 판매를 구성하려면 원하는 아이템 모듈의 관리자 섹션으로 이동합니다.
* 게임 키
* 가상 아이템 및 인게임 재화
* 번들

이 엔드포인트의 별칭:
* /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id}

## 판매자

### 프로젝트 가져오기

 - [GET /v2/merchant/{merchant_id}/projects](https://developers.xsolla.com/ko/api/catalog/common-merchant/get-projects.md): 판매자의 프로젝트 목록을 가져옵니다.


  참고이 API 호출에는 project_id path 매개 변수가 포함되어 있지 않으므로 회사의 모든 프로젝트에서 유효한 API 키를 사용하여 권한 부여를 설정해야 합니다.

## 카탈로그

이 API를 사용하면 모든 종류의 판매할 수 있는 아이템 또는 특정 아이템을 가져올 수 있습니다.

### 판매할 수 있는 아이템 목록 가져오기

 - [GET /v2/project/{project_id}/items](https://developers.xsolla.com/ko/api/catalog/common-catalog/get-sellable-items.md): 카탈로그 작성을 위해 판매할 수 있는 아이템 목록을 가져옵니다.

주의모든 프로젝트에는 응답에서 얻을 수 있는 아이템 수에 제한이 있습니다. 기본값과 최대값은 응답당 50개 아이템입니다. 페이지별로 더 많은 데이터 페이지를 가져오려면 제한 및 오프셋 필드를 사용합니다.  참고아이템 카탈로그 API 호출은 권한이 없어도 사용할 수 있지만 인증 헤더에서 사용자 JWT를 전달한 경우에만 사용자 맞춤형 카탈로그를 가져올 수 있습니다.

### 지정한 그룹으로 판매할 수 있는 아이템 목록 가져오기

 - [GET /v2/project/{project_id}/items/group/{external_id}](https://developers.xsolla.com/ko/api/catalog/common-catalog/get-sellable-items-group.md): 카탈로그 작성을 위해 지정된 그룹에서 판매할 수 있는 아이템 목록을 가져옵니다.

주의모든 프로젝트에는 응답에서 얻을 수 있는 아이템 수에 제한이 있습니다. 기본값과 최대값은 응답당 50개 아이템입니다. 페이지별로 더 많은 데이터 페이지를 가져오려면 제한 및 오프셋 필드를 사용합니다.  참고일반적으로 아이템 카탈로그 API 호출은 권한이 없어도 사용할 수 있지만 인증 헤더에서 사용자 JWT를 전달한 경우에만 사용자 맞춤형 카탈로그를 가져올 수 있습니다.

### ID를 사용하여 판매 가능한 아이템 가져오기

 - [GET /v2/project/{project_id}/items/id/{item_id}](https://developers.xsolla.com/ko/api/catalog/common-catalog/get-sellable-item-by-id.md): ID로 판매 가능한 아이템을 가져옵니다.
참고권한 없이 액세스할 수 있는 이 끝점은 일반 데이터를 반환합니다. 그러나 권한 부여는 사용 가능한 사용자 제한 및 프로모션과 같은 개인화된 결과에 대한 사용자별 세부 정보로 응답을 강화합니다.

### SKU로 판매할 수 있는 아이템 가져오기

 - [GET /v2/project/{project_id}/items/sku/{sku}](https://developers.xsolla.com/ko/api/catalog/common-catalog/get-sellable-item-by-sku.md): 카탈로그를 작성하기 위해 SKU별로 판매 가능한 항목을 가져옵니다.
참고권한 없이 액세스할 수 있는 이 끝점은 일반 데이터를 반환합니다. 그러나 권한 부여는 사용 가능한 사용자 제한 및 프로모션과 같은 개인화된 결과에 대한 사용자별 세부 정보로 응답을 강화합니다.

## 공통 지역

### 지역 목록 가져오기

 - [GET /v2/project/{project_id}/admin/region](https://developers.xsolla.com/ko/api/catalog/common-regions/admin-get-regions.md): 지역 목록을 가져옵니다.

지역을 사용하여 지역 제한을 관리할 수 있습니다.

### 지역 생성하기

 - [POST /v2/project/{project_id}/admin/region](https://developers.xsolla.com/ko/api/catalog/common-regions/admin-create-region.md): 지역을 생성합니다.

지역을 사용하여 지역 제한을 관리할 수 있습니다.

### 지역 삭제

 - [DELETE /v2/project/{project_id}/admin/region/{region_id}](https://developers.xsolla.com/ko/api/catalog/common-regions/admin-delete-region.md): 특정 지역을 삭제합니다.

### 지역 가져오기

 - [GET /v2/project/{project_id}/admin/region/{region_id}](https://developers.xsolla.com/ko/api/catalog/common-regions/admin-get-region.md): 특정 지역을 가져옵니다.

지역을 사용하여 지역 제한을 관리할 수 있습니다.

### 지역 업데이트

 - [PUT /v2/project/{project_id}/admin/region/{region_id}](https://developers.xsolla.com/ko/api/catalog/common-regions/admin-update-region.md): 특정 지역을 업데이트합니다.

지역을 사용하여 지역 제한을 관리할 수 있습니다.

## 관리자

### 특성 목록 가져오기(관리자)

 - [GET /v2/project/{project_id}/admin/attribute](https://developers.xsolla.com/ko/api/catalog/attribute-admin/admin-get-attribute-list.md): 관리 대상 프로젝트에서 특성 목록을 가져옵니다.

### 특성 생성하기

 - [POST /v2/project/{project_id}/admin/attribute](https://developers.xsolla.com/ko/api/catalog/attribute-admin/admin-create-attribute.md): 특성을 생성합니다.

### 특성 삭제

 - [DELETE /v2/project/{project_id}/admin/attribute/{external_id}](https://developers.xsolla.com/ko/api/catalog/attribute-admin/delete-attribute.md): 특성을 삭제합니다.
참고아이템 특성을 삭제하면 해당 아이템의 모든 데이터와 아이템 연결을 잃게 됩니다.

### 지정된 특성 가져오기

 - [GET /v2/project/{project_id}/admin/attribute/{external_id}](https://developers.xsolla.com/ko/api/catalog/attribute-admin/admin-get-attribute.md): 지정된 특성을 가져옵니다.

### 특성 업데이트

 - [PUT /v2/project/{project_id}/admin/attribute/{external_id}](https://developers.xsolla.com/ko/api/catalog/attribute-admin/admin-update-attribute.md): 특성을 업데이트합니다.

### 모든 특성 값 삭제

 - [DELETE /v2/project/{project_id}/admin/attribute/{external_id}/value](https://developers.xsolla.com/ko/api/catalog/attribute-admin/admin-delete-all-attribute-value.md): 특성의 모든 값을 삭제합니다.
참고특성 값을 삭제하면 특성과 아이템 사이의 모든 연결이 끊어집니다. 아이템의 특성 값을 변경하려면 값을 삭제하고 새 값을 생성하는 대신특성 값 업데이트 API 호출을 사용하십시오.

### 특성 값 생성하기

 - [POST /v2/project/{project_id}/admin/attribute/{external_id}/value](https://developers.xsolla.com/ko/api/catalog/attribute-admin/admin-create-attribute-value.md): 특성 값을 생성합니다.

주의모든 프로젝트는 특성 값의 수를 제한합니다. 기본값과 최대값은 특성당 20개입니다.

### 특성 값 삭제

 - [DELETE /v2/project/{project_id}/admin/attribute/{external_id}/value/{value_external_id}](https://developers.xsolla.com/ko/api/catalog/attribute-admin/admin-delete-attribute-value.md): 특성 값을 삭제합니다.
참고특성 값을 삭제하면 특성과 아이템 사이의 모든 연결이 끊어집니다. 아이템의 특성 값을 변경하려면 값을 삭제하고 새 값을 생성하는 대신특성 값 업데이트 API 호출을 사용하십시오.

### 특성 값 업데이트

 - [PUT /v2/project/{project_id}/admin/attribute/{external_id}/value/{value_external_id}](https://developers.xsolla.com/ko/api/catalog/attribute-admin/admin-update-attribute-value.md): 특성 값을 업데이트합니다.