# 디지털 배포 솔루션 # 개요 디지털 배포 솔루션는새로운 엑솔라 솔루션으로 푸시 결제 기술 및 전자 상거래를 통한 결제를 기반으로 현금과 디지털을 연결하는 것을 목표로 합니다. 이 참조는 API 엔드포인트를 2개의 엑솔라 제품용으로 결합합니다. [인게임 스토어](https://developers.xsolla.com\/ko/doc/in-game-store/) 및 [페이 스테이션](https://developers.xsolla.com\/ko/doc/pay-station/). 2개의 기준 URL이 있습니다. * `https://store.xsolla.com/api`는 **일반**, **카탈로그**, **장바구니**, **주문** 그룹용입니다. * `https://ps.xsolla.com`은 **알림** 그룹용입니다. **카탈로그** 그룹의 API 엔드포인트는 권한 부여가 필요하지 않습니다. **장바구니** 및 **주문** 그룹의 연산 작업을 하려면 [사용자 토큰 생성](https://developers.xsolla.com\/ko/digital-distribution-hub/common/user-token/create-user-token)을 통해 토큰을 생성해야 합니다.
주의

이 참조는 향후 API 디자인을 나타내며 완전한 기능을 하는 인터페이스가 아닙니다. 현재 카탈로그 및 알림 그룹 엔드포인트만 시도해 보실 수 있습니다. 피드백을 남기고 싶으시면 techdoc@xsolla.com으로 이메일을 보내주십시오.
Version: 1.0.0 ## Servers ``` https://store.xsolla.com/api ``` ## Security ### AuthForClient [용자 토큰 생성](https://developers.xsolla.com\/ko/api/digital-distribution-hub/operation/create-user-token) 엔드포인트를 사용하여 토큰을 생성합니다. Type: http Scheme: bearer ### basicAuth Xsolla API는 기본 액세스 인증을 사용합니다. API에 대한 모든 요청은 `Authorization: Basic ` 헤더를 포함해야 합니다. 여기서 `your_authorization_basic_key`는 Base64 표준에 따라 인코딩된 `distribution_hub_id:api_key` 쌍입니다. `distribution_hub_id`및 `api_key`를 받으려면 계정 관리자에게 문의하세요. Type: http Scheme: basic ## Download OpenAPI description [디지털 배포 솔루션](https://developers.xsolla.com/_bundle/@l10n/ko/api/digital-distribution-hub/index.yaml) ## 장바구니 ### 현재 사용자의 장바구니 가져오기 - [GET /v2/project/{project_id}/cart](https://developers.xsolla.com/ko/api/digital-distribution-hub/cart/get-user-cart.md): 현재 사용자의 장바구니를 반환합니다. ### 현재 장바구니에서 모든 장바구니 아이템 삭제 - [PUT /v2/project/{project_id}/cart/clear](https://developers.xsolla.com/ko/api/digital-distribution-hub/cart/cart-clear.md): 모든 장바구니 항목을 삭제합니다. ### 장바구니에 아이템 채우기 - [PUT /v2/project/{project_id}/cart/fill](https://developers.xsolla.com/ko/api/digital-distribution-hub/cart/cart-fill.md): 장바구니에 아이템을 채웁니다. 장바구니에 동일한 SKU의 아이템이 이미 있는 경우 기존 아이템은 전달된 값으로 대체됩니다. ### 현재 장바구니에서 장바구니 아이템 삭제 - [DELETE /v2/project/{project_id}/cart/item/{item_sku}](https://developers.xsolla.com/ko/api/digital-distribution-hub/cart/delete-item.md): 장바구니에서 아이템을 제거합니다. ### 현재 장바구니에서 장바구니 아이템 업데이트 - [PUT /v2/project/{project_id}/cart/item/{item_sku}](https://developers.xsolla.com/ko/api/digital-distribution-hub/cart/put-item.md): 기존 장바구니 아이템을 업데이트하거나 장바구니에 아이템을 생성합니다. ### 장바구니 ID로 장바구니 가져오기 - [GET /v2/project/{project_id}/cart/{cart_id}](https://developers.xsolla.com/ko/api/digital-distribution-hub/cart/get-cart-by-id.md): 장바구니 ID로 사용자의 장바구니를 반환합니다. ### 장바구니 ID로 모든 장바구니 아이템 삭제 - [PUT /v2/project/{project_id}/cart/{cart_id}/clear](https://developers.xsolla.com/ko/api/digital-distribution-hub/cart/cart-clear-by-id.md): 모든 장바구니 항목을 삭제합니다. ### 특정 장바구니에 아이템 채우기 - [PUT /v2/project/{project_id}/cart/{cart_id}/fill](https://developers.xsolla.com/ko/api/digital-distribution-hub/cart/cart-fill-by-id.md): 특정 장바구니에 아이템을 채웁니다. 장바구니에 동일한 SKU의 아이템이 이미 있는 경우 기존 아이템 위치는 전달된 값으로 대체됩니다. ### 장바구니 ID로 장바구니 아이템 삭제 - [DELETE /v2/project/{project_id}/cart/{cart_id}/item/{item_sku}](https://developers.xsolla.com/ko/api/digital-distribution-hub/cart/delete-item-by-cart-id.md): 장바구니에서 아이템을 제거합니다. ### 장바구니 ID로 장바구니 아이템 업데이트 - [PUT /v2/project/{project_id}/cart/{cart_id}/item/{item_sku}](https://developers.xsolla.com/ko/api/digital-distribution-hub/cart/put-item-by-cart-id.md): 기존 장바구니 아이템을 업데이트하거나 장바구니에 아이템을 생성합니다. ## 게임 키 ### 게임 목록 가져오기 - [GET /v2/project/{project_id}/items/game](https://developers.xsolla.com/ko/api/digital-distribution-hub/game-keys/get-games-list.md): 카탈로그 작성을 위한 게임 목록을 가져옵니다. 주의 모든 프로젝트에는 응답에서 얻을 수 있는 아이템 수에 제한이 있습니다. 기본값 및 최대값은 응답당 50개 아이템입니다. 페이지별로 더 많은 데이터를 얻으려면 limit 및 offset 필드를 사용하세요. ### DRM 목록 가져오기 - [GET /v2/project/{project_id}/items/game/drm](https://developers.xsolla.com/ko/api/digital-distribution-hub/game-keys/get-drm-list.md): 사용 가능한 DRM 목록을 가져옵니다. ### 지정된 그룹별로 게임 목록 가져오기 - [GET /v2/project/{project_id}/items/game/group/{external_id}](https://developers.xsolla.com/ko/api/digital-distribution-hub/game-keys/get-games-group.md): 카탈로그 작성을 위해 지정된 그룹에서 게임 목록을 가져옵니다. 주의. 모든 프로젝트에는 얻을 수 있는 아이템 수에 제한이 있습니다. 응답. 기본값 및 최대값은 응답당 50개 아이템입니다. 페이지별로 더 많은 데이터를 얻으려면 limit 및 offset 필드를 사용하세요. ### 지정된 그룹별로 게임 키 목록 가져오기 - [GET /v2/project/{project_id}/items/game/key/group/{external_id}](https://developers.xsolla.com/ko/api/digital-distribution-hub/game-keys/get-game-keys-group.md): 카탈로그 작성을 위해 지정된 그룹에서 게임 키 목록을 가져옵니다. 주의. 모든 프로젝트에는 응답에서 얻을 수 있는 아이템 수가 제한되어 있습니다. 기본값 및 최대값은 응답당 50개 아이템입니다. 페이지별로 더 많은 데이터를 얻으려면 limit 및 offset 필드를 사용하세요. ### 카탈로그용 게임 키 가져오기 - [GET /v2/project/{project_id}/items/game/key/sku/{item_sku}](https://developers.xsolla.com/ko/api/digital-distribution-hub/game-keys/get-game-key-by-sku.md): 카탈로그용 게임 키를 가져옵니다. ### 카탈로그용 게임 가져오기 - [GET /v2/project/{project_id}/items/game/sku/{item_sku}](https://developers.xsolla.com/ko/api/digital-distribution-hub/game-keys/get-game-by-sku.md): 카탈로그용 게임을 가져옵니다. ## 가상 아이템 및 통화 ### 아이템 그룹 목록 가져오기 - [GET /v2/project/{project_id}/items/groups](https://developers.xsolla.com/ko/api/digital-distribution-hub/virtual-items-and-currency/get-item-groups.md): 카탈로그 작성을 위한 아이템 그룹 목록을 가져옵니다. ### 가상 통화 목록 가져오기 - [GET /v2/project/{project_id}/items/virtual_currency](https://developers.xsolla.com/ko/api/digital-distribution-hub/virtual-items-and-currency/get-virtual-currency.md): 카탈로그 작성을 위한 가상 통화 목록을 가져옵니다. 주의 모든 프로젝트에는 응답에서 얻을 수 있는 아이템 수에 제한이 있습니다. 기본값 및 최대값은 응답당 50개 아이템입니다. 페이지별로 더 많은 데이터를 얻으려면 limit 및 offset 필드를 사용하세요. ### 가상 화폐 패키지 목록 가져오기 - [GET /v2/project/{project_id}/items/virtual_currency/package](https://developers.xsolla.com/ko/api/digital-distribution-hub/virtual-items-and-currency/get-virtual-currency-package.md): 카탈로그 구축을 위한 가상 통화 패키지 목록을 가져옵니다. 주의 모든 프로젝트에는 응답에서 얻을 수 있는 아이템 수에 제한이 있습니다. 기본값 및 최대값은 응답당 50개 아이템입니다. 페이지별로 더 많은 데이터를 얻으려면 limit 및 offset 필드를 사용하세요. ### 가상 아이템 목록 가져오기 - [GET /v2/project/{project_id}/items/virtual_items](https://developers.xsolla.com/ko/api/digital-distribution-hub/virtual-items-and-currency/get-virtual-items.md): 카탈로그 작성을 위한 가상 아이템 목록을 가져옵니다. 주의. 모든 프로젝트에는 응답에서 얻을 수 있는 아이템 수에 제한이 있습니다. 기본값 및 최대값은 응답당 50개 아이템입니다. 페이지별로 더 많은 데이터를 얻으려면 limit 및 offset 필드를 사용하세요. ### 지정된 그룹별로 아이템 목록 가져오기 - [GET /v2/project/{project_id}/items/virtual_items/group/{external_id}](https://developers.xsolla.com/ko/api/digital-distribution-hub/virtual-items-and-currency/get-virtual-items-group.md): 카탈로그를 작성하기 위해 지정된 그룹에서 아이템 목록을 가져옵니다. 주의 모든 프로젝트에는 응답에서 얻을 수 있는 아이템 수에 제한이 있습니다. 기본값 및 최대값은 응답당 50개 아이템입니다. 페이지별로 더 많은 데이터를 얻으려면 limit 및 offset 필드를 사용하세요. ## 번들 ### 번들 목록 가져오기 - [GET /v2/project/{project_id}/items/bundle](https://developers.xsolla.com/ko/api/digital-distribution-hub/bundles/get-bundle-list.md): 카탈로그 작성을 위한 번들 목록을 가져옵니다. 주의 모든 프로젝트에는 응답에서 얻을 수 있는 아이템 수에 제한이 있습니다. 기본값 및 최대값은 응답당 50개 아이템입니다. ### 지정된 번들 가져오기 - [GET /v2/project/{project_id}/items/bundle/sku/{sku}](https://developers.xsolla.com/ko/api/digital-distribution-hub/bundles/get-bundle.md): 지정된 번들을 가져옵니다. ## 사용자 토큰 ### 사용자 토큰 생성 - [POST /v2/project/{project_id}/distribution_hub/user/auth](https://developers.xsolla.com/ko/api/digital-distribution-hub/user-token/create-user-token.md): 사용자가 게임에 존재하는지 확인하고 사용자 토큰을 생성합니다. ## 알림 ### 알림 취소 - [POST /push-payments/cancel](https://developers.xsolla.com/ko/api/digital-distribution-hub/notifications/cancel-notification.md): 다음과 같은 경우 결제 취소 알림을 보냅니다. - 결제가 완료되지 않았습니다. - 결제가 환불되었습니다. ### 지불 알림 - [POST /push-payments/pay](https://developers.xsolla.com/ko/api/digital-distribution-hub/notifications/pay-notification.md): 사용자에게 요금을 청구한 후에 이 알림을 보냅니다. ## 주문 ### 주문 받기 - [GET /v2/project/{project_id}/distribution_hub/order/{order_id}](https://developers.xsolla.com/ko/api/digital-distribution-hub/order/get-order.md): 지정된 주문을 검색합니다. ### 현재 장바구니의 모든 항목으로 주문 생성 - [POST /v2/project/{project_id}/distribution_hub/payment/cart](https://developers.xsolla.com/ko/api/digital-distribution-hub/order/create-order.md): 장바구니의 모든 항목으로 주문을 생성합니다. 생성된 주문은 new 주문 상태가 됩니다. ### 특정 장바구니의 모든 아이템으로 주문 생성 - [POST /v2/project/{project_id}/distribution_hub/payment/cart/{cart_id}](https://developers.xsolla.com/ko/api/digital-distribution-hub/order/create-order-by-cart-id.md): 특정 장바구니의 모든 항목으로 주문을 생성합니다. 생성된 주문은 new 주문 상태가 됩니다. ### 지정된 아이템으로 주문 생성 - [POST /v2/project/{project_id}/distribution_hub/payment/item/{item_sku}](https://developers.xsolla.com/ko/api/digital-distribution-hub/order/create-order-with-item.md): 지정된 아이템으로 주문을 생성합니다. 생성된 주문은 new 주문 상태가 됩니다.