`는 사용자 토큰입니다. 이 토큰은 사용자를 식별하고 개인화된 데이터에 대한 액세스를 제공합니다.
또한, [결제 UI 열기 위한 토큰](/ko/api/pay-station/token/create-token)을 사용할 수 있습니다.
2. **Simplified mode without Authorization header.** 이 모드는 미인증 사용자만 사용하며, [게임 키 판매](/ko/doc/buy-button/how-to/set-up-authentication/#guides_buy_button_selling_items_not_authenticated_users)에만 적용할 수 있습니다. 토큰 대신 요청에 다음 헤더를 포함해야 합니다.
- 요청 ID와 `x-unauthorized-id`
- Base64로 인코딩된 사용자의 이메일 주소와 `x-user`
## 유용한 링크
- [상호작용 모델별 API 호출](https://developers.xsolla.com/ko/api/catalog/)
- [엔드포인트 유형](https://developers.xsolla.com/ko/api/catalog/)
- [오류 처리](https://developers.xsolla.com/ko/api/catalog/)
- [API 키](https://developers.xsolla.com/ko/api/catalog/)
# 핵심 엔티티 구조
모든 유형의 아이템(가상 아이템, 번들, 인게임 재화, 키)은 유사한 데이터 구조를 사용합니다. 기본 구조를 이해하면 API 작업이 간소화되고 문서를 더 쉽게 탐색할 수 있습니다.
참고
일부 호출에는 추가 입력란이 포함될 수 있지만 기본 구조는 변경되지 않습니다.
**식별**
- `merchant_id`- [관리자 페이지](https://publisher.xsolla.com/)의 회사 ID
- `project_id` - 관리자 페이지의 프로젝트 ID
- `sku` - 프로젝트 내의 고유한 아이템 SKU
**Store display**
- `name` - 아이템 이름
- `description` - 아이템 설명
- `image_url` - 이미지 URL
- `is_enabled` - 아이템 가용성
- `is_show_in_store` - 카탈로그에 아이템이 표시되는지 여부
카탈로그에서 아이템 가용성 관리에 대한 자세한 정보는 [문서](/ko/items-catalog/catalog-features/items-availability/)를 참조하세요.
**Organization**
- `type` - 아이템 유형, 예를 들어 가상 아이템(`virtual_item`) 또는 번들(`bundle`)
- `groups` - 아이템이 속한 그룹
- `order` - 카탈로그 내 디스플레이 순서
**판매 조건**
- `prices` - 실제 화폐 또는 인게임 재화로 된 가격
- `limits` - 구매 한도
- `periods` - 가용 기간
- `regions` - 지역 제한
**핵심 엔티티 구조 예시:**
```json
{
"attributes": [],
"bundle_type": "virtual_currency_package",
"content": [
{
"description": {
"en": "Main in-game currency"
},
"image_url": "https://.../image.png",
"name": {
"en": "Crystals",
"de": "Kristalle"
},
"quantity": 500,
"sku": "com.xsolla.crystal_2",
"type": "virtual_currency"
}
],
"description": {
"en": "Crystals x500"
},
"groups": [],
"image_url": "https://.../image.png",
"is_enabled": true,
"is_free": false,
"is_show_in_store": true,
"limits": {
"per_item": null,
"per_user": null,
"recurrent_schedule": null
},
"long_description": null,
"media_list": [],
"name": {
"en": "Medium crystal pack"
},
"order": 1,
"periods": [
{
"date_from": null,
"date_until": "2020-08-11T20:00:00+03:00"
}
],
"prices": [
{
"amount": 20,
"country_iso": "US",
"currency": "USD",
"is_default": true,
"is_enabled": true
}
],
"regions": [],
"sku": "com.xsolla.crystal_pack_2",
"type": "bundle",
"vc_prices": []
}
```
# 기본 구매 흐름
엑솔라 API를 사용하면 아이템 카탈로그 검색, 장바구니 관리, 주문 생성 및 상태 추적을 포함한 인게임 스토어 로직을 구현할 수 있습니다. 통합 시나리오에 따라 API 호출은 **Admin**와 **Catalog** 하위 섹션으로 구분되며, 서로 다른 [인증 방식](/ko/api/catalog/section/authentication)을 사용합니다.
다음 예시는 아이템 생성부터 구매까지 스토어 설정 및 운영을 위한 기본 흐름을 보여줍니다.
## 아이템 및 그룹 생성(관리자)
가상 아이템, 번들, 인게임 재화와 같은 스토어의 아이템 카탈로그를 생성합니다.
예시 API 호출:
- [가상 아이템 생성](/ko/api/catalog/virtual-items-currency-admin/admin-create-virtual-item)
- [번들 생성](/ko/api/catalog/bundles-admin/admin-create-bundle)
- [인게임 재화 생성](/ko/api/catalog/virtual-items-currency-admin/admin-create-virtual-currency)
## 프로모션, 체인 및 한도 설정(관리자)
할인, 보너스, 일일 보상 또는 혜택 체인과 같은 사용자 획득 및 수익화 도구를 구성합니다.
예시 API 호출:
- [보너스 프로모션 생성](/ko/api/liveops/promotions-bonuses/create-bonus-promotion)
- [일일 보상 생성](/ko/api/liveops/daily-chain-admin/admin-create-daily-chain)
- [고유 카탈로그 혜택 프로모션 생성](/ko/api/liveops/promotions-unique-catalog-offers/admin-create-unique-catalog-offer)
## 아이템 정보 가져오기(클라이언트)
애플리케이션에서 아이템 디스플레이를 구성합니다.
알림
사용자 카탈로그를 구축하는 데 관리자 하위 섹션의 API 호출을 사용하지 마십시오. 이러한 API 호출에는
속도 제한이 있으며 사용자 트래픽을 위한 것이 아닙니다.
API 호출 예시:
- [가상 아이템 목록 가져오기](/ko/api/catalog/virtual-items-currency-catalog/get-virtual-items)
- [아이템 그룹 목록 가져오기](/ko/api/catalog/virtual-items-currency-catalog/get-item-groups)
- [번들 목록 가져오기](/ko/api/catalog/bundles-catalog/get-bundle-list)
- [판매 가능한 아이템 목록 가져오기](/ko/api/catalog/common-catalog/get-sellable-items)
참고
기본적으로 카탈로그 API 호출은 요청 시점에 스토어에서 현재 사용 가능한 아이템을 반환합니다. 아직 사용 가능하지 않거나 더 이상 사용 가능하지 않은 아이템을 검색하려면 카탈로그 요청에 "show_inactive_time_limited_items": 1 매개 변수를 포함하십시오.
## 아이템 판매
다음 방법을 사용하여 아이템을 판매할 수 있습니다:
- 빠른 구매 - 하나의 SKU를 여러 번 판매합니다.
- 장바구니 구매 - 사용자가 장바구니에 아이템을 추가하고, 제거하고, 수량을 업데이트합니다.
아이템이 실제 돈 대신 인게임 재화로 구매된 경우, [인게임 재화로 구매한 특정 아이템으로 주문 생성](/ko/api/catalog/virtual-payment/create-order-with-item-for-virtual-currency) API 호출을 사용하십시오. 결제 UI는 필요하지 않으며, API 호출이 실행될 때 청구가 처리됩니다.
무료 아이템 구매의 경우, [특정 무료 아이템으로 주문 생성](/ko/api/catalog/free-item/create-free-order-with-item) API 호출 또는 [무료 장바구니로 주문 생성](/ko/api/catalog/free-item/create-free-order) API 호출을 사용하십시오. 결제 UI는 필요하지 않으며, 주문은 즉시 done 상태로 설정됩니다.
### 빠른 구매
클라이언트 측 API 호출을 사용하여 [특정 아이템으로 주문 생성](/ko/api/catalog/payment-client-side/create-order-with-item)을 수행합니다. 호출은 결제 UI를 열기 위한 토큰을 반환합니다.
참고
할인 정보는 결제 UI에서만 사용자에게 제공됩니다. 프로모션 코드는 지원되지 않습니다.
### 장바구니 구매
장바구니 설정 및 구매는 클라이언트 또는 서버 측에서 수행할 수 있습니다.
**클라이언트에서 장바구니 설정 및 구매**
아이템 추가 및 제거 로직을 직접 구현하십시오. 장바구니 설정을 위한 API 호출 전에는 구매에 적용될 프로모션에 대한 정보를 알 수 없습니다. 이는 총 비용과 추가 보너스 아이템의 세부 사항을 알 수 없음을 의미합니다.
다음 장바구니 로직을 구현하십시오:
1. 플레이어가 장바구니를 채운 후, [아이템으로 장바구니 채우기](/ko/api/shop-builder/operation/cart-fill/) API 호출을 사용하십시오. 호출은 선택한 아이템에 대한 현재 정보를 반환합니다 (할인 전후 가격, 보너스 아이템).
2. 사용자 작업에 따라 장바구니 내용을 업데이트하십시오:
- 아이템을 추가하거나 아이템 수량을 변경하려면 [장바구니 ID로 장바구니 아이템 업데이트](/ko/api/shop-builder/operation/put-item-by-cart-id/) API 호출을 사용하십시오.
- 아이템을 제거하려면 [장바구니 ID로 장바구니 아이템 삭제](/ko/api/shop-builder/operation/delete-item-by-cart-id/) API 호출을 사용하십시오.
참고
현재 장바구니 상태를 얻으려면 현재 사용자의 장바구니 가져오기 API 호출을 사용하십시오.
3. [현재 장바구니의 모든 아이템으로 주문 생성](/ko/api/shop-builder/operation/create-order/) API 호출을 사용하십시오. 호출은 주문 ID와 결제 토큰을 반환합니다. 새로 생성된 주문은 기본적으로 new 상태로 설정됩니다.
**서버에서 장바구니 설정 및 구매**
이 설정 옵션은 장바구니 설정에 더 많은 시간이 걸릴 수 있습니다. 장바구니의 각 변경 사항은 API 호출을 동반해야 하기 때문입니다.
다음 장바구니 로직을 구현하십시오:
1. 플레이어가 장바구니를 채운 후, [아이템으로 장바구니 채우기](/ko/api/catalog/cart-server-side) API 호출을 사용하십시오. 호출은 선택한 아이템에 대한 현재 정보를 반환합니다(할인 전후 가격, 보너스 아이템).
2. [현재 장바구니의 모든 아이템으로 주문 생성](/ko/api/shop-builder/operation/create-order/) API 호출을 사용하십시오. 호출은 주문 ID와 결제 토큰을 반환합니다. 새로 생성된 주문은 기본적으로 new 상태로 설정됩니다.
## 결제 UI 열기
반환된 토큰을 사용하여 새 창에서 결제 UI를 엽니다. 결제 UI를 여는 다른 방법은 [문서](/ko/payment-ui-and-flow/payment-ui/how-to-open-payment-ui/#open_payment_ui)에 설명되어 있습니다.
| 작업 | 엔드포인트 |
|:--------------------------------|:--------------------------------------------------------------------------|
| 프로덕션 환경에서 열기. | https://secure.xsolla.com/paystation4/?token={token} |
| 샌드박스 모드에서 열기. | https://sandbox-secure.xsolla.com/paystation4/?token={token} |
참고
개발 및 테스트 중에는 샌드박스 모드를 사용하세요. 테스트 구매는 실제 계정에 청구되지 않습니다.
테스트 은행 카드를 사용할 수 있습니다.
첫 번째 실제 결제가 이루어진 후에는 엄격한 샌드박스 결제 정책이 적용됩니다. 샌드박스 모드에서의 결제는 [관리자 페이지 > 회사 설정 > 사용자](https://publisher.xsolla.com/0/settings/users)에 지정된 사용자에게만 가능합니다.
실제 통화로 인게임 재화와 아이템을 구매하려면 엑솔라와의 라이선스 계약을 체결해야 합니다. 이를 위해 [관리자 페이지](https://publisher.xsolla.com/)에서 **Agreements & Taxes > Agreements**으로 이동하여 계약 양식을 작성하고 확인을 기다리세요. 계약 검토에는 최대 3영업일이 소요될 수 있습니다.
샌드박스 모드를 활성화하거나 비활성화하려면 빠른 구매 및 장바구니 구매 요청에서 `sandbox` 매개 변수의 값을 변경하세요. 기본적으로 샌드박스 모드는 꺼져 있습니다.
가능한 주문 상태:
- `new` - 주문 생성됨
- `paid` - 결제 완료됨
- `done` - 아이템 전달됨
- `canceled` - 주문 취소됨
- `expired` -주문 만료됨
다음 방법 중 하나를 사용하여 주문 상태를 추적하세요:
- [서버에 구성된 웹훅](/ko/virtual-goods/own-ui/server-side-token-generation/set-up-order-tracking/#payments_integration_order_tracking)
- [짧은 폴링](/ko/virtual-goods/own-ui/client-side-token-generation/set-up-order-tracking/#guides_shop_builder_integrate_store_get_order_status_via_short_polling)
- [WebSocket API](/ko/virtual-goods/own-ui/client-side-token-generation/set-up-order-tracking/#guides_shop_builder_integrate_store_get_order_status_via_websocket_api)
## 유용한 링크
- 인증
- [상호작용 모델에 따른 API 호출](/ko/api/catalog/section/authentication)
- [결제 테스트](/ko/dev-resources/testing/general-info/#general_overview)
- [주문 상태 추적 설정](/ko/virtual-goods/own-ui/client-side-token-generation/set-up-order-tracking/?link=200-api#payments_integration_order_tracking)
- [웹훅](/ko/webhooks/overview)
- [속도 제한](/ko/api/login/rate-limits)
- [오류 처리](/ko/api/getting-started/#api_errors_handling)
- [API 키](/ko/api/getting-started/#api_keys_overview)
# 페이지 매김
대량의 레코드를 반환하는 API 호출(예: 카탈로그 작성 시)은 데이터를 페이지 단위로 반환합니다. 페이지 매김은 단일 API 응답에서 반환되는 항목 수를 제한하고 이후 페이지를 순차적으로 검색할 수 있는 메커니즘입니다.
반환되는 아이템 수를 제어하기 위해 다음 매개 변수를 사용하세요:
- `limit` - 페이지당 항목 수
- `offset` - 페이지의 첫 번째 항목의 인덱스(번호는 0부터 시작)
- `has_more` - 다른 페이지가 있는지 여부를 나타냄
- `total_items_count` - 총 항목 수
요청 예시:
```
GET /items?limit=20&offset=40
```
응답 예시:
```json
{
"items": [...],
"has_more": true,
"total_items_count": 135
}
```
응답이 `has_more = false`를 반환할 때까지 후속 요청을 보내는 것이 좋습니다.
# 날짜 및 시간 형식
날짜 및 시간 값은 [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) 형식으로 전달됩니다.
다음이 지원됩니다:
- UTC 오프셋
- 항목 표시 시간 제한이 없는 경우 `null` 값
- 일부 입력란에서 사용되는 [Unix 타임스탬프](https://www.unixtimestamp.com/)(초 단위)
형식: `YYYY-MM-DDTHH:MM:SS±HH:MM`
예시: `2026-03-16T10:00:00+03:00`
# 현지화
엑솔라는 항목 이름 및 설명과 같은 사용자 대상 입력란의 현지화를 지원합니다. 현지화된 값은 언어 코드를 키로 사용하는 개체로 전달됩니다. 지원되는 언어의 전체 목록은 [문서](/ko/doc/shop-builder/references/supported-languages/)에서 확인할 수 있습니다.
**Supported fields**
다음 매개 변수에 대해 현지화를 지정할 수 있습니다:
- `name`
- `description`
- `long_description`
**Locale format**
로케일 키는 다음 형식 중 하나로 지정할 수 있습니다:
- 두 글자 언어 코드: `en`, `ru`
- 다섯 글자 언어 코드: `en-US`, `ru-RU`, `de-DE`
**Examples**
두 글자 언어 코드 예시:
```json
{
"name": {
"en": "Starter Pack",
"ru": "Стартовый набор"
}
}
```
다섯 글자 언어 코드 예시:
```json
{
"description": {
"en-US": "Premium bundle",
"de-DE": "Premium-Paket"
}
}
```
# 오류 응답 형식
오류가 발생하면, API는 HTTP 상태와 JSON 응답 본문을 반환합니다. 스토어 관련 오류의 전체 목록은 [문서](/ko/dev-resources/references/errors/store-errors/)에서 확인할 수 있습니다.
**Response example:**
```json
{
"errorCode": 1102,
"errorMessage": "Validation error",
"statusCode": 422,
"transactionId": "c9e1a..."
}
```
- `errorCode` - 오류 코드.
- `errorMessage` - 짧은 오류 설명.
- `statusCode` - HTTP 응답 상태.
- `transactionId` - 요청 ID. 일부 경우에만 반환됩니다.
- `errorMessageExtended` - 요청 매개 변수와 같은 추가 오류 세부 정보. 일부 경우에만 반환됩니다.
**Extended response example:**
```json
{
"errorCode": 7001,
"errorMessage": "Chain not found",
"errorMessageExtended": {
"chain_id": "test_chain_id",
"project_id": "test_project_id",
"step_number": 2
},
"statusCode": 404
}
```
**Common HTTP status codes**
- `400` - 잘못된 요청
- `401` - 인증 오류
- `403` - 권한 부족
- `404` - 리소스를 찾을 수 없음
- `422` - 유효성 검사 오류
- `429` - 속도 제한 초과
**Recommendations**
- HTTP 상태와 응답 본문을 함께 처리하세요.
- `errorCode`를 사용하여 애플리케이션 로직과 관련된 오류를 처리하세요.
- `transactionId`를 사용하여 오류 분석 시 요청을 더 빠르게 식별하세요.
Version: 2.0.0
## Servers
```
https://store.xsolla.com/api
```
## Security
### basicAuth
서버 측 호출은 `basicAuth` 인증 체계를 사용합니다. API에 대한 모든 요청은 `Authorization: Basic ` 헤더를 포함해야 하며, 여기에서 `your_authorization_basic_key`는 Base64 표준에 따라 인코딩된 `project_id:api_key` 쌍입니다.
필요한 경우 `project_id` 대신 `merchant_id`를 사용할 수 있습니다. 기능에는 영향을 미치지 않습니다.
다음과 같이 매개 변수 값을 확인하려면 [관리자 페이지](https://publisher.xsolla.com/)로 이동합니다.
* `merchant_id`는 다음 위치에 표시됩니다:
* **Company settings > Company** 섹션
* 관리자 페이지의 모든 페이지에서 브라우저 주소 표시줄의 URL. URL 형식은 다음과 같습니다: `https://publisher.xsolla.com/`.
* `api_key`는 생성 시 관리자 페이지에서 한 번만 표시되며, 귀하의 측에서 저장해야 합니다. 새 키는 다음 섹션에서 생성할 수 있습니다:
* [Company settings > API keys](https://publisher.xsolla.com/0/settings/api_key)
* [Project settings > API keys](https://publisher.xsolla.com/0/projects/0/edit/api_key)
{% html name="div" attrs={"class": "notice"} %}
**Notice**
필수 API 호출에 `project_id` 경로 매개 변수가 포함되어 있지 않으면, 모든 회사 프로젝트에 대해 유효한 API 키를 사용하여 인증하세요.
{% /html %}
* `project_id`는 다음 위치에 표시됩니다:
* 프로젝트 이름 옆의 관리자 페이지.
* 관리자 페이지에서 프로젝트 작업 시 브라우저 주소 표시줄의 URL. URL 형식은 다음과 같습니다: `https://publisher.xsolla.com//projects/`.
API 키 작업에 대한 자세한 정보는 [API 레퍼런스](https://developers.xsolla.com/ko/api/getting-started/#api_keys_overview)를 참조하세요.
Type: http
Scheme: basic
### XsollaLoginUserJWT
클라이언트 측 호출은 `XsollaLoginUserJWT` 인증 체계를 사용합니다. 요청에는 Bearer `` 형식으로 `Authorization` 헤더에 사용자의 JWT를 포함해야 합니다. 이 토큰은 사용자를 식별하고 개인화된 데이터에 대한 액세스 를 제공합니다. 토큰 생성 방법에 대한 자세한 내용은 [엑솔라 로그인 API 문서](/ko/api/login/authentication-schemes#getting-user-token)를 참조하십시오.
또는 [결제 UI를 여는 토큰](/ko/api/pay-station/token/create-token)을 사용할 수 있습니다.
Type: http
Scheme: bearer
Bearer Format: JWT
### AuthForCart
이 `AuthForCart` 인증 체계는 장바구니 구매에 사용되며 두 가지 모드를 지원합니다.
1. 사용자의 JWT로 인증합니다. 토큰은 인증 헤더에 `Authorization: Bearer ` 형식으로 전달되며, ``는 사용자 토큰입니다. 이 토큰은 사용자를 식별하고 사용자 맞춤 설정된 데이터에 대한 액세스를 제공합니다.
또는 [결제 UI를 여는 토큰](/ko/api/pay-station/token/create-token)을 사용할 수 있습니다.
2. `Authorization` 헤더가 없는 간소화된 모드. 이 모드는 인증되지 않은 사용자만 사용하며, [게임 키 판매](/ko/doc/buy-button/how-to/set-up-authentication/#guides_buy_button_selling_items_not_authenticated_users)에만 적용할 수 있습니다. 토큰 대신 요청에 다음 헤더를 포함해야 합니다.
* 요청 ID와 `x-unauthorized-id`
* Base64로 인코딩된 사용자의 이메일 주소와 `x-user`.
Type: http
Scheme: bearer
### basicMerchantAuth
서버 측 호출은 `basicMerchantAuth` 인증 체계를 사용합니다. 모든 API 요청에는 `Authorization: Basic ` 헤더가 포함되어야 하며, 여기서 `your_authorization_basic_key`는 Base64 표준에 따라 인코딩된 `merchant_id:api_key` 쌍입니다.
다음과 같이 매개 변수 값을 확인하려면 [관리자 페이지](https://publisher.xsolla.com/)로 이동합니다.
* `merchant_id`는 다음 위치에 표시됩니다:
* **Company settings > Company** 섹션
* 관리자 페이지의 모든 페이지에서 브라우저 주소 표시줄의 URL에 표시됩니다. URL 형식은 다음과 같습니다: `https://publisher.xsolla.com/`
* `api_key`는 생성 시 관리자 페이지에 한 번만 표시되며, 귀하의 측에서 저장해야 합니다. 새로운 키는 [Company settings > API keys](https://publisher.xsolla.com/0/settings/api_key) 섹션에서 생성할 수 있습니다.
API 키 작업에 대한 자세한 정보는 [API 레퍼런스](https://developers.xsolla.com/ko/api/getting-started/#api_keys_overview)를 참조하세요.
Type: http
Scheme: basic
## Download OpenAPI description
[카탈로그 API](https://developers.xsolla.com/_bundle/@l10n/ko/api/catalog/index.yaml)
## 관리자
### 가상 아이템 목록 가져오기
- [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): 관리를 위해 그룹 내부의 가상 아이템 목록을 가져옵니다.
참고상점 카탈로그를 작성에 이 엔드포인트를 사용하지 마세요.
### 가상 아이템 가져오기
- [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): 가상 아이템을 업데이트합니다.
### 가상 아이템 삭제
- [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_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/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): 인게임 재화를 업데이트합니다.
### 인게임 재화 삭제
- [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/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): 인게임 재화 패키지를 생성합니다.
### 인게임 재화 패키지 업데이트
- [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/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): 관리를 위해 프로젝트 내부의 인게임 재화 패키지를 가져옵니다.
참고상점 카탈로그를 작성에 이 엔드포인트를 사용하지 마세요.
## 카탈로그
### 가상 아이템 목록 가져오기
- [GET /v2/project/{project_id}/items/virtual_items](https://developers.xsolla.com/ko/api/catalog/virtual-items-currency-catalog/get-virtual-items.md): 카탈로그 작성을 위해 아이템 목록을 가져옵니다.
공지
모든 프로젝트에는 응답에서 가져올 수 있는 아이템 수에 제한이 있습니다. 기본값 및 최대값은 응답당 50개 아이템입니다. 페이지별로 더 많은 데이터를 얻으려면 limit 및 offset 입력란을 사용하세요.
참고
이 API 호출은 인증 없이 사용될 때 일반적인 아이템 카탈로그 데이터를 반환합니다. 인증을 사용하여 아이템과 관련된 제한 및 프로모션과 같은 개인화된 사용자 데이터를 검색하세요. 이를 위해 Authorization 헤더에 사용자 JWT를 전달하십시오. 사용자 JWT에 대한 자세한 내용은 이 호출의 보안 블록을 참조하십시오.
참고: 클라이언트 측 검색 또는 인덱싱을 위한 모든 가상 아이템 목록 가져오기 API 호출을 참조하세요.
### 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별로 가상 아이템을 가져옵니다.
알림
이 API 호출은 인증 없이 사용될 때 일반적인 아이템 카탈로그 데이터를 반환합니다. 인증을 사용하여 아이템과 관련된 한도 및 프로모션과 같은 사용자 맞춤형 데이터를 검색하세요. 이를 위해 Authorization 헤더에 사용자 JWT를 전달하세요. 사용자 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 호출은 인증 없이 사용될 때 일반적인 아이템 카탈로그 데이터를 반환합니다. 인증을 사용하여 아이템과 관련된 제한 및 프로모션과 같은 개인화된 사용자 데이터를 검색하세요. 이를 위해 Authorization 헤더에 사용자 JWT를 전달하십시오. 사용자 JWT에 대한 자세한 내용은 이 호출의 보안 블록을 참조하십시오.
참고: 페이지 매김을 통해 자세한 아이템 데이터를 검색하기 위한 가상 아이템 목록 가져오기 API 호출을 참조하세요.
### 인게임 재화 목록 가져오기
- [GET /v2/project/{project_id}/items/virtual_currency](https://developers.xsolla.com/ko/api/catalog/virtual-items-currency-catalog/get-virtual-currency.md): 카탈로그 작성을 위해 인게임 재화 목록을 가져옵니다.
주의
모든 프로젝트에는 응답에서 가져올 수 있는 항목 수에 제한이 있습니다. 기본 및 최대 값은 응답당 50개 항목입니다. 페이지별로 더 많은 데이터를 얻으려면 limit 및 offset 입력란을 사용하세요.
참고
이 API 호출은 인증 없이 사용될 때 일반적인 아이템 카탈로그 데이터를 반환합니다. 인증을 사용하여 아이템과 관련된 제한 및 프로모션과 같은 개인화된 사용자 데이터를 검색하세요. 이를 위해 Authorization 헤더에 사용자 JWT를 전달하십시오. 사용자 JWT에 대한 자세한 내용은 이 호출의 보안 블록을 참조하십시오.
### 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별로 인게임 재화를 가져옵니다.
참고
이 API 호출은 인증 없이 사용될 때 일반적인 아이템 카탈로그 데이터를 반환합니다. 인증을 사용하여 아이템과 관련된 제한 및 프로모션과 같은 개인화된 사용자 데이터를 검색하세요. 이를 위해 Authorization 헤더에 사용자 JWT를 전달하십시오. 사용자 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개 항목입니다. 페이지별로 더 많은 데이터를 얻으려면 limit 및 offset 입력란을 사용하세요.
참고
이 API 호출은 인증 없이 사용될 때 일반적인 아이템 카탈로그 데이터를 반환합니다. 인증을 사용하여 아이템과 관련된 제한 및 프로모션과 같은 개인화된 사용자 데이터를 검색하세요. 이를 위해 Authorization 헤더에 사용자 JWT를 전달하십시오. 사용자 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별로 가상 재화 패키지를 가져옵니다.
참고
이 API 호출은 인증 없이 사용될 때 일반적인 아이템 카탈로그 데이터를 반환합니다. 인증을 사용하여 아이템과 관련된 제한 및 프로모션과 같은 개인화된 사용자 데이터를 검색하세요. 이를 위해 Authorization 헤더에 사용자 JWT를 전달하십시오. 사용자 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개 항목입니다. 페이지별로 더 많은 데이터를 얻으려면 limit 및 offset 입력란을 사용하세요.
참고
이 API 호출은 인증 없이 사용될 때 일반적인 아이템 카탈로그 데이터를 반환합니다. 인증을 사용하여 아이템과 관련된 제한 및 프로모션과 같은 개인화된 사용자 데이터를 검색하세요. 이를 위해 Authorization 헤더에 사용자 JWT를 전달하십시오. 사용자 JWT에 대한 자세한 내용은 이 호출의 보안 블록을 참조하십시오.
### 지정한 그룹으로 인게임 재화 목록 가져오기
- [GET /v2/project/{project_id}/items/virtual_currency/group/{external_id}](https://developers.xsolla.com/ko/api/catalog/virtual-items-currency-catalog/get-virtual-currency-group.md): 카탈로그 작성을 위해 지정한 그룹에서 인게임 재화 목록을 가져옵니다.
주의
모든 프로젝트에는 응답에서 가져올 수 있는 항목 수에 제한이 있습니다. 기본 및 최대 값은 응답당 50개 항목입니다. 페이지별로 더 많은 데이터를 얻으려면 limit 및 offset 입력란을 사용하세요.
참고
이 API 호출은 인증 없이 사용될 때 일반적인 아이템 카탈로그 데이터를 반환합니다. 인증을 사용하여 아이템과 관련된 제한 및 프로모션과 같은 개인화된 사용자 데이터를 검색하세요. 이를 위해 Authorization 헤더에 사용자 JWT를 전달하십시오. 사용자 JWT에 대한 자세한 내용은 이 호출의 보안 블록을 참조하십시오.
### 지정한 그룹으로 인게임 재화 패키지 목록 가져오기
- [GET /v2/project/{project_id}/items/virtual_currency/package/group/{external_id}](https://developers.xsolla.com/ko/api/catalog/virtual-items-currency-catalog/get-virtual-currency-package-group.md): 카탈로그 작성을 위해 지정한 그룹에서 인게임 재화 패키지 목록을 가져옵니다.
주의
모든 프로젝트에는 응답에서 가져올 수 있는 항목 수에 제한이 있습니다. 기본 및 최대 값은 응답당 50개 항목입니다. 페이지별로 더 많은 데이터를 얻으려면 limit 및 offset 입력란을 사용하세요.
참고
이 API 호출은 인증 없이 사용될 때 일반적인 아이템 카탈로그 데이터를 반환합니다. 인증을 사용하여 아이템과 관련된 제한 및 프로모션과 같은 개인화된 사용자 데이터를 검색하세요. 이를 위해 Authorization 헤더에 사용자 JWT를 전달하십시오. 사용자 JWT에 대한 자세한 내용은 이 호출의 보안 블록을 참조하십시오.
## 가상 결제
### 특정 아이템을 인게임 재화로 구매하는 주문 생성
- [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): 인게임 재화를 사용하여 아이템 구매를 생성합니다.
참고
이 API 호출은 인증 없이 사용될 때 일반적인 아이템 카탈로그 데이터를 반환합니다. 인증을 사용하여 아이템과 관련된 제한 및 프로모션과 같은 개인화된 사용자 데이터를 검색하세요. 이를 위해 Authorization 헤더에 사용자 JWT를 전달하십시오. 사용자 JWT에 대한 자세한 내용은 이 호출의 보안 블록을 참조하십시오.
## 카탈로그
### 게임 목록 가져오기
- [GET /v2/project/{project_id}/items/game](https://developers.xsolla.com/ko/api/catalog/game-keys-catalog/get-games-list.md): 카탈로그 작성을 위해 게임 목록을 가져옵니다.
주의
모든 프로젝트에는 응답에서 가져올 수 있는 항목 수에 제한이 있습니다. 기본 및 최대 값은 응답당 50개 항목입니다. 페이지별로 더 많은 데이터를 얻으려면 limit 및 offset 입력란을 사용하세요.
참고
이 API 호출은 인증 없이 사용될 때 일반적인 아이템 카탈로그 데이터를 반환합니다. 인증을 사용하여 아이템과 관련된 제한 및 프로모션과 같은 개인화된 사용자 데이터를 검색하세요. 이를 위해 Authorization 헤더에 사용자 JWT를 전달하십시오. 사용자 JWT에 대한 자세한 내용은 이 호출의 보안 블록을 참조하십시오.
### 지정한 그룹으로 게임 목록 가져오기
- [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개 항목입니다. 페이지별로 더 많은 데이터를 얻으려면 limit 및 offset 입력란을 사용하세요.
참고
이 API 호출은 인증 없이 사용될 때 일반적인 아이템 카탈로그 데이터를 반환합니다. 인증을 사용하여 아이템과 관련된 제한 및 프로모션과 같은 개인화된 사용자 데이터를 검색하세요. 이를 위해 Authorization 헤더에 사용자 JWT를 전달하십시오. 사용자 JWT에 대한 자세한 내용은 이 호출의 보안 블록을 참조하십시오.
### 카탈로그에 게임 가져오기
- [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): 카탈로그용 게임을 가져옵니다.
참고
이 API 호출은 인증 없이 사용될 때 일반적인 아이템 카탈로그 데이터를 반환합니다. 인증을 사용하여 아이템과 관련된 제한 및 프로모션과 같은 개인화된 사용자 데이터를 검색하세요. 이를 위해 Authorization 헤더에 사용자 JWT를 전달하십시오. 사용자 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): 카탈로그에 대한 게임 키를 가져옵니다.
참고
이 API 호출은 인증 없이 사용될 때 일반적인 아이템 카탈로그 데이터를 반환합니다. 인증을 사용하여 아이템과 관련된 제한 및 프로모션과 같은 개인화된 사용자 데이터를 검색하세요. 이를 위해 Authorization 헤더에 사용자 JWT를 전달하십시오. 사용자 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개 항목입니다. 페이지별로 더 많은 데이터를 얻으려면 limit 및 offset 입력란을 사용하세요.
참고
이 API 호출은 인증 없이 사용될 때 일반적인 아이템 카탈로그 데이터를 반환합니다. 인증을 사용하여 아이템과 관련된 제한 및 프로모션과 같은 개인화된 사용자 데이터를 검색하세요. 이를 위해 Authorization 헤더에 사용자 JWT를 전달하십시오. 사용자 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}/entitlement](https://developers.xsolla.com/ko/api/catalog/game-keys-entitlement/get-user-games.md): 사용자가 소유한 게임 목록을 가져옵니다. 응답에 특정 사용자가 소유한 게임 배열이 포함됩니다.
주의
모든 프로젝트에는 응답에서 가져올 수 있는 항목 수에 제한이 있습니다. 기본 및 최대 값은 응답당 50개 항목입니다. 페이지별로 더 많은 데이터를 얻으려면 limit 및 offset 입력란을 사용하세요.
참고
이 API 호출은 인증 없이 사용될 때 일반적인 아이템 카탈로그 데이터를 반환합니다. 인증을 사용하여 아이템과 관련된 제한 및 프로모션과 같은 개인화된 사용자 데이터를 검색하세요. 이를 위해 Authorization 헤더에 사용자 JWT를 전달하십시오. 사용자 JWT에 대한 자세한 내용은 이 호출의 보안 블록을 참조하십시오.
### 클라이언트로 게임 코드 사용하기
- [POST /v2/project/{project_id}/entitlement/redeem](https://developers.xsolla.com/ko/api/catalog/game-keys-entitlement/redeem-game-pin-code.md): 제공된 게임 코드로 권한을 부여합니다.
알림
DRM이 없는 플랫폼에서만 코드를 사용할 수 있습니다.
참고
이 API 호출은 인증 없이 사용될 때 일반적인 아이템 카탈로그 데이터를 반환합니다. 인증을 사용하여 아이템과 관련된 제한 및 프로모션과 같은 개인화된 사용자 데이터를 검색하세요. 이를 위해 Authorization 헤더에 사용자 JWT를 전달하십시오. 사용자 JWT에 대한 자세한 내용은 이 호출의 보안 블록을 참조하십시오.
### 권한 부여(관리자)
- [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 플랫폼용 게임 코드 또는 게임만 취소할 수 있습니다.
## 관리자
### 게임 생성하기
- [POST /v2/project/{project_id}/admin/items/game](https://developers.xsolla.com/ko/api/catalog/game-keys-admin/admin-create-game.md): 프로젝트에서 게임을 생성합니다.
### 게임 목록 가져오기(관리자)
- [GET /v2/project/{project_id}/admin/items/game](https://developers.xsolla.com/ko/api/catalog/game-keys-admin/admin-get-game-list.md): 관리를 위해 프로젝트 내부의 게임 목록을 가져옵니다.
게임은 사용자가 구매할 수 있는 게임 키로 구성되어 있습니다.
참고상점 카탈로그를 작성에 이 엔드포인트를 사용하지 마세요.
### 게임 가져오기(관리자)
- [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로 프로젝트에 있는 게임을 업데이트합니다.
### 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로 프로젝트에 있는 게임을 삭제합니다.
### 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/id/{item_id}](https://developers.xsolla.com/ko/api/catalog/game-keys-admin/admin-delete-game-by-id.md): ID로 프로젝트의 게임을 삭제합니다.
### 코드 업로드
- [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로 코드를 업로드합니다.
### 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): 세션 정보를 로드하는 코드를 가져옵니다.
### 코드 가져오기
- [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로 코드 가져오기
- [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로 특정 수의 코드를 가져옵니다.
### 코드 삭제하기
- [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로 코드 삭제하기
- [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로 모든 코드를 삭제합니다.
## 관리자
### 번들 목록 가져오기
- [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): 단일 단위로 판매되는 아이템 세트인 번들을 생성합니다. 번들에는 가상 아이템, 인게임 재화 패키지, 게임 키 및 기타 번들이 포함될 수 있습니다. 자세한 내용은 번들 섹션을 참조하십시오.
공지content 배열의 모든 아이템은 프로젝트에 미리 생성되어 있어야 합니다. 지정한 SKU가 존재하지 않으면 시스템에서 오류를 반환합니다.
### 지정한 그룹 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): 관리 목적으로 그룹 내 번들 목록을 가져옵니다.
참고상점 카탈로그를 작성에 이 엔드포인트를 사용하지 마세요.
### 지정한 그룹 외부 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): 관리 목적으로 그룹 내 번들 목록을 가져옵니다.
참고상점 카탈로그를 작성에 이 엔드포인트를 사용하지 마세요.
### 번들 업데이트
- [PUT /v2/project/{project_id}/admin/items/bundle/sku/{sku}](https://developers.xsolla.com/ko/api/catalog/bundles-admin/admin-update-bundle.md): 번들을 업데이트합니다. 이 호출은 번들을 완전히 대체합니다 변경하려는 필드뿐만 아니라 요청 본문의 모든 필수 필드를 전달합니다. 자세한 내용은 번들 섹션을 참조하십시오.
공지content 배열의 모든 아이템은 프로젝트에 미리 생성되어 있어야 합니다. 지정한 SKU가 존재하지 않으면 시스템에서 오류를 반환합니다.
### 번들 삭제
- [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}/show](https://developers.xsolla.com/ko/api/catalog/bundles-admin/admin-show-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): 카탈로그에서 번들을 숨깁니다.
## 카탈로그
### 번들 목록 가져오기
- [GET /v2/project/{project_id}/items/bundle](https://developers.xsolla.com/ko/api/catalog/bundles-catalog/get-bundle-list.md): 카탈로그 작성을 위해 번들 목록을 가져옵니다.
주의
모든 프로젝트에는 응답에서 가져올 수 있는 항목 수에 제한이 있습니다. 기본 및 최대 값은 응답당 50개 항목입니다. 페이지별로 더 많은 데이터를 얻으려면 limit 및 offset 입력란을 사용하세요.
참고
이 API 호출은 인증 없이 사용될 때 일반적인 아이템 카탈로그 데이터를 반환합니다. 인증을 사용하여 아이템과 관련된 제한 및 프로모션과 같은 개인화된 사용자 데이터를 검색하세요. 이를 위해 Authorization 헤더에 사용자 JWT를 전달하십시오. 사용자 JWT에 대한 자세한 내용은 이 호출의 보안 블록을 참조하십시오.
### 지정한 번들 가져오기
- [GET /v2/project/{project_id}/items/bundle/sku/{sku}](https://developers.xsolla.com/ko/api/catalog/bundles-catalog/get-bundle.md): 지정된 번들을 가져옵니다.
참고
이 API 호출은 인증 없이 사용될 때 일반적인 아이템 카탈로그 데이터를 반환합니다. 인증을 사용하여 아이템과 관련된 제한 및 프로모션과 같은 개인화된 사용자 데이터를 검색하세요. 이를 위해 Authorization 헤더에 사용자 JWT를 전달하십시오. 사용자 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개 항목입니다. 페이지별로 더 많은 데이터를 얻으려면 limit 및 offset 입력란을 사용하세요.
참고
이 API 호출은 인증 없이 사용될 때 일반적인 아이템 카탈로그 데이터를 반환합니다. 인증을 사용하여 아이템과 관련된 제한 및 프로모션과 같은 개인화된 사용자 데이터를 검색하세요. 이를 위해 Authorization 헤더에 사용자 JWT를 전달하십시오. 사용자 JWT에 대한 자세한 내용은 이 호출의 보안 블록을 참조하십시오.
## 장바구니(클라이언트 측)
이 섹션의 호출을 사용하여 클라이언트 측에서 장바구니를 관리합니다.
### 장바구니 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로 사용자의 장바구니를 반환합니다.
### 현재 사용자의 장바구니 가져오기
- [GET /v2/project/{project_id}/cart](https://developers.xsolla.com/ko/api/catalog/cart-client-side/get-user-cart.md): 현재 사용자의 장바구니를 반환합니다.
### 장바구니 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/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를 가진 아이템이 이미 있으면 기존 아이템이 전달된 값으로 교체됩니다.
### 아이템으로 특정 장바구니 채우기
- [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로 장바구니 아이템 업데이트하기
- [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): 기존 장바구니 아이템을 업데이트하거나 장바구니에서 아이템을 생성합니다.
### 장바구니 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): 장바구니에서 아이템을 제거합니다.
### 현재 장바구니에서 장바구니 아이템 업데이트
- [PUT /v2/project/{project_id}/cart/item/{item_sku}](https://developers.xsolla.com/ko/api/catalog/cart-client-side/put-item.md): 기존 장바구니 아이템을 업데이트하거나 장바구니에서 아이템을 생성합니다.
### 현재 장바구니에서 장바구니 아이템 삭제
- [DELETE /v2/project/{project_id}/cart/item/{item_sku}](https://developers.xsolla.com/ko/api/catalog/cart-client-side/delete-item.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/{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/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/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를 사용하여 사용자의 국가를 확인하고 주문에 사용할 통화를 선택하므로 서버 측이 아닌 클라이언트 측에서만 이 방식을 사용해야 합니다. 서버 측에서 이 방식을 사용하면 통화가 잘못 결정되어 페이 스테이션의 결제 방식에 영향을 줄 수 있습니다.
Notice
이 API 호출은 인증을 위해 사용자 JWT를 사용합니다.
Authorization 헤더에 Bearer <user_JWT> 형식으로 토큰을 포함하세요. 사용자 JWT에 대한 자세한 내용은 이 호출의 보안 블록을 참조하세요.
## 결제(서버 측)
이 섹션의 호출을 사용하여 서버 측에서 결제 토큰을 생성합니다.
### 구매용 결제 토큰 생성하기
- [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 주문 상태를 갖게 됩니다.
참고
이 API 호출은 인증 없이 사용될 때 일반적인 아이템 카탈로그 데이터를 반환합니다. 인증을 사용하여 아이템과 관련된 제한 및 프로모션과 같은 개인화된 사용자 데이터를 검색하세요. 이를 위해 Authorization 헤더에 사용자 JWT를 전달하십시오. 사용자 JWT에 대한 자세한 내용은 이 호출의 보안 블록을 참조하십시오.
## 관리
### 지정된 사용자의 모든 구매 제한 설정 새로고침
- [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}/all](https://developers.xsolla.com/ko/api/catalog/user-limits-admin/reset-user-item-limit.md): 사용자가 아이템을 다시 구입할 수 있도록 아이템의 구매 한도를 새로고침합니다. user 매개변수가 null인 경우 이 호출은 모든 사용자에 대해 이 제한을 새로고침합니다.
사용자 제한 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}](https://developers.xsolla.com/ko/api/catalog/user-limits-admin/remove-user-item-limit.md): 적용된 제한 설정 내에서 지정된 사용자가 사용할 수 있는 남은 아이템 개수를 줄입니다.
사용자 제한 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 /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를 통해 수행된 마지막 가져오기에 대한 데이터를 검색합니다.
## 선주문
### 아이템의 사전 판매 제한에 대한 정보 가져오기
- [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}](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}
### 아이템의 사전 판매 제한 토글
- [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}
### 아이템의 모든 사전 판매 수량 제한 제거
- [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}
## 판매자
### 프로젝트 가져오기
- [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개 항목입니다. 페이지별로 더 많은 데이터를 얻으려면 limit 및 offset 입력란을 사용하세요.
참고
이 API 호출은 인증 없이 사용될 때 일반적인 아이템 카탈로그 데이터를 반환합니다. 인증을 사용하여 아이템과 관련된 제한 및 프로모션과 같은 개인화된 사용자 데이터를 검색하세요. 이를 위해 Authorization 헤더에 사용자 JWT를 전달하십시오. 사용자 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로 판매 가능한 아이템을 가져옵니다.
참고
이 API 호출은 인증 없이 사용될 때 일반적인 아이템 카탈로그 데이터를 반환합니다. 인증을 사용하여 아이템과 관련된 제한 및 프로모션과 같은 개인화된 사용자 데이터를 검색하세요. 이를 위해 Authorization 헤더에 사용자 JWT를 전달하십시오. 사용자 JWT에 대한 자세한 내용은 이 호출의 보안 블록을 참조하십시오.
### 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별로 판매 가능한 항목을 가져옵니다.
참고
이 API 호출은 인증 없이 사용될 때 일반적인 아이템 카탈로그 데이터를 반환합니다. 인증을 사용하여 아이템과 관련된 제한 및 프로모션과 같은 개인화된 사용자 데이터를 검색하세요. 이를 위해 Authorization 헤더에 사용자 JWT를 전달하십시오. 사용자 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개 항목입니다. 페이지별로 더 많은 데이터를 얻으려면 limit 및 offset 입력란을 사용하세요.
참고
이 API 호출은 인증 없이 사용될 때 일반적인 아이템 카탈로그 데이터를 반환합니다. 인증을 사용하여 아이템과 관련된 제한 및 프로모션과 같은 개인화된 사용자 데이터를 검색하세요. 이를 위해 Authorization 헤더에 사용자 JWT를 전달하십시오. 사용자 JWT에 대한 자세한 내용은 이 호출의 보안 블록을 참조하십시오.
## 공통 지역
### 지역 목록 가져오기
- [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): 지역을 생성합니다.
지역을 사용하여 지역 제한을 관리할 수 있습니다.
### 지역 가져오기
- [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): 특정 지역을 업데이트합니다.
지역을 사용하여 지역 제한을 관리할 수 있습니다.
### 지역 삭제
- [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/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): 특성을 생성합니다.
### 특성 업데이트
- [PUT /v2/project/{project_id}/admin/attribute/{external_id}](https://developers.xsolla.com/ko/api/catalog/attribute-admin/admin-update-attribute.md): 특성을 업데이트합니다.
### 지정된 특성 가져오기
- [GET /v2/project/{project_id}/admin/attribute/{external_id}](https://developers.xsolla.com/ko/api/catalog/attribute-admin/admin-get-attribute.md): 지정된 특성을 가져옵니다.
### 특성 삭제
- [DELETE /v2/project/{project_id}/admin/attribute/{external_id}](https://developers.xsolla.com/ko/api/catalog/attribute-admin/delete-attribute.md): 특성을 삭제합니다.
참고아이템 특성을 삭제하면 해당 아이템의 모든 데이터와 아이템 연결을 잃게 됩니다.
### 특성 값 생성하기
- [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](https://developers.xsolla.com/ko/api/catalog/attribute-admin/admin-delete-all-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): 특성 값을 업데이트합니다.
### 특성 값 삭제
- [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 호출을 사용하십시오.
## 관리자
### 아이템 그룹 목록 가져오기
- [GET /v2/project/{project_id}/admin/items/groups](https://developers.xsolla.com/ko/api/catalog/item-groups-admin/admin-get-item-group-list.md): 프로젝트 내의 모든 아이템 그룹 목록을 페이지 매김 없이 가져옵니다. 관리 목적으로 사용됩니다.
참고스토어 카탈로그를 작성에 이 엔드포인트를 사용하지 마세요. 대신 아이템 그룹 목록 가져오기 클라이언트 측 엔드포인트를 사용하세요.
### 아이템 그룹 생성하기
- [POST /v2/project/{project_id}/admin/items/groups](https://developers.xsolla.com/ko/api/catalog/item-groups-admin/admin-create-item-group.md): 프로젝트 내에 아이템 그룹을 생성합니다.
카탈로그 작성을 위해 아이템 그룹을 가져오려면 아이템 그룹 목록 가져오기 클라이언트 측 엔드포인트를 사용하세요.
### 외부 ID로 아이템 그룹 가져오기
- [GET /v2/project/{project_id}/admin/items/groups/{external_id}](https://developers.xsolla.com/ko/api/catalog/item-groups-admin/admin-get-item-group.md): 관리 목적으로 외부 ID로 아이템 그룹을 가져옵니다.
참고스토어 카탈로그를 작성에 이 엔드포인트를 사용하지 마세요. 대신 아이템 그룹 목록 가져오기 클라이언트 측 엔드포인트를 사용하세요.
### 아이템 그룹 업데이트
- [PUT /v2/project/{project_id}/admin/items/groups/{external_id}](https://developers.xsolla.com/ko/api/catalog/item-groups-admin/admin-update-item-group.md): 외부 ID로 아이템 그룹을 업데이트합니다.
### 아이템 그룹 삭제
- [DELETE /v2/project/{project_id}/admin/items/groups/{external_id}](https://developers.xsolla.com/ko/api/catalog/item-groups-admin/admin-delete-item-group.md): 외부 ID로 아이템 그룹을 삭제합니다.
### 아이템 유형으로 필터링된 아이템 그룹 목록 가져오기
- [GET /v2/project/{project_id}/admin/items/{item_type}/groups](https://developers.xsolla.com/ko/api/catalog/item-groups-admin/admin-get-item-group-list-by-item-type.md): 아이템 유형으로 필터링하여 아이템 그룹 목록을 가져옵니다. 지정된 유형의 아이템만 해당 그룹에 포함됩니다. 이는 아이템 그룹 목록 가져오기 엔드포인트와 유사하지만, 아이템을 집계할 때 유형이 추가 필터링으로 적용된다는 점이 다릅니다.
### 아이템 유형으로 필터링된 외부 ID로 아이템 그룹 가져오기
- [GET /v2/project/{project_id}/admin/items/{item_type}/groups/{external_id}](https://developers.xsolla.com/ko/api/catalog/item-groups-admin/admin-get-item-group-by-item-type.md): 외부 ID로 아이템 그룹을 가져옵니다. 지정된 유형의 아이템만 해당 그룹에 포함됩니다. 이는 외부 ID로 아이템 그룹 가져오기 엔드포인트와 유사하지만, 아이템을 집계할 때 유형이 추가 필터링으로 적용된다는 점이 다릅니다.
### 아이템 그룹 재정렬
- [PUT /v2/project/{project_id}/admin/group/order](https://developers.xsolla.com/ko/api/catalog/item-groups-admin/admin-reorder-item-groups.md): 프로젝트 내 아이템 그룹의 표시 순서를 설정합니다. 그룹의 새로운 순서 값을 포함한 목록을 전달하세요.
### 그룹 내 아이템 재정렬(외부 ID 기준)
- [PUT /v2/project/{project_id}/admin/group/{external_id}/order/item](https://developers.xsolla.com/ko/api/catalog/item-groups-admin/admin-reorder-items-in-group.md): 외부 ID로 식별된 그룹 내 아이템의 표시 순서를 설정합니다. 아이템의 새로운 순서 값을 포함한 배열을 전달하세요.
### 그룹 내 아이템 재정렬(ID 기준)
- [PUT /v2/project/{project_id}/admin/group/id/{id}/order/item](https://developers.xsolla.com/ko/api/catalog/item-groups-admin/admin-reorder-items-in-group-by-id.md): 내부 숫자 ID로 식별된 그룹 내 아이템의 표시 순서를 설정합니다. 아이템의 새로운 순서 값을 포함한 목록을 전달하세요.
## 카탈로그
### 아이템 그룹 목록 가져오기
- [GET /v2/project/{project_id}/items/groups](https://developers.xsolla.com/ko/api/catalog/item-groups-catalog/get-item-groups.md): 페이지 매김 없이 카탈로그를 작성하기 위한 아이템 그룹 목록을 검색합니다.
NoteIn general, the use of catalog of items is available without authorization. Only authorized users can get a personalized catalog.