# Digital Distribution Hub # 概要 {% #overview %} Digital Distribution Hubは、プッシュペイメント技術やEコマースを介して、デジタルとキャッシュベースの決済を結びつけることを目的とした、エクソラの新しいソリューションです。 この参照は、以下の2つエクソラ製品のAPIエンドポイントを組み合わせたものです：[ゲーム内ストア](https://developers.xsolla.com\/ja/doc/in-game-store/)と[決済ステーション](https://developers.xsolla.com\/ja/doc/pay-station/)。2つのベースURLがあります： * **一般**、**カタログ**、**カート**、及び**注文**グループの場合は `https://store.xsolla.com/api`。 * **通知**グループの場合は、`https://ps.xsolla.com`。 **カタログ**グループのAPIエンドポイントは認証を必要としません。 **カート**と**注文**グループの操作を行うには、[ユーザートークンを作成する](https://developers.xsolla.com\/ja/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\/ja/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 [Digital Distribution Hub](https://xsolla.redocly.app/_bundle/@l10n/ja/api/digital-distribution-hub/index.yaml) ## カート ### 現在のユーザーのカートを取得する - [GET /v2/project/{project_id}/cart](https://xsolla.redocly.app/ja/api/digital-distribution-hub/cart/get-user-cart.md): 現在のユーザーのカートを返します。 ### 現在のカートからすべてのカートアイテムを削除する - [PUT /v2/project/{project_id}/cart/clear](https://xsolla.redocly.app/ja/api/digital-distribution-hub/cart/cart-clear.md): すべてのカートアイテムを削除します。 ### カートにアイテムを入れる - [PUT /v2/project/{project_id}/cart/fill](https://xsolla.redocly.app/ja/api/digital-distribution-hub/cart/cart-fill.md): カートにアイテムを入れます。カートに同じSKUのアイテムがすでにある場合、既存のアイテムは渡された値で置き換えられます。 ### 現在のカートからカートアイテムを削除する - [DELETE /v2/project/{project_id}/cart/item/{item_sku}](https://xsolla.redocly.app/ja/api/digital-distribution-hub/cart/delete-item.md): カートからアイテムを削除します。 ### 現在のカートからカートアイテムを更新します - [PUT /v2/project/{project_id}/cart/item/{item_sku}](https://xsolla.redocly.app/ja/api/digital-distribution-hub/cart/put-item.md): 既存のカートアイテムを更新するか、カート内にアイテムを作成します。 ### カートIDでカートを取得する - [GET /v2/project/{project_id}/cart/{cart_id}](https://xsolla.redocly.app/ja/api/digital-distribution-hub/cart/get-cart-by-id.md): カートIDでユーザーのカートを返します。 ### カートIDですべてのカートアイテムを削除する - [PUT /v2/project/{project_id}/cart/{cart_id}/clear](https://xsolla.redocly.app/ja/api/digital-distribution-hub/cart/cart-clear-by-id.md): すべてのカートアイテムを削除します。 ### 特定のカートにアイテムを入れる - [PUT /v2/project/{project_id}/cart/{cart_id}/fill](https://xsolla.redocly.app/ja/api/digital-distribution-hub/cart/cart-fill-by-id.md): 特定のカートにアイテムを入れます。カートに同じSKUのアイテムがすでにある場合は、既存のアイテムの位置が渡された値で置き換えられます。 ### カートIDでカートアイテムを削除する - [DELETE /v2/project/{project_id}/cart/{cart_id}/item/{item_sku}](https://xsolla.redocly.app/ja/api/digital-distribution-hub/cart/delete-item-by-cart-id.md): カートからアイテムを削除します。 ### カートIDでカートアイテムを更新する - [PUT /v2/project/{project_id}/cart/{cart_id}/item/{item_sku}](https://xsolla.redocly.app/ja/api/digital-distribution-hub/cart/put-item-by-cart-id.md): 既存のカートアイテムを更新するか、カート内にアイテムを作成します。 ## ゲームキー ### ゲームリストを取得する - [GET /v2/project/{project_id}/items/game](https://xsolla.redocly.app/ja/api/digital-distribution-hub/game-keys/get-games-list.md): カタログを作成するためのゲームリストを取得します。 注意すべてのプロジェクトには、応答で取得できるアイテムの数に制限があります。デフォルトおよび最大値は1応答あたり50アイテムです。ページごとにより多くのデータを取得するには、制限とオフセットフィールドを使用します。 ### DRMリストを取得する - [GET /v2/project/{project_id}/items/game/drm](https://xsolla.redocly.app/ja/api/digital-distribution-hub/game-keys/get-drm-list.md): 使用可能なDRMのリストを取得します。 ### 指定されたグループごとにゲームリストを取得する - [GET /v2/project/{project_id}/items/game/group/{external_id}](https://xsolla.redocly.app/ja/api/digital-distribution-hub/game-keys/get-games-group.md): カタログを作成するために、指定されたグループからゲームリストを取得します。 注意すべてのプロジェクトには、取得できるアイテムの数に制限があります。応答。デフォルトおよび最大値は1応答あたり50アイテムです。ページごとにより多くのデータを取得するには、制限とオフセットフィールドを使用します。 ### 指定されたグループごとにゲームキーリストを取得する - [GET /v2/project/{project_id}/items/game/key/group/{external_id}](https://xsolla.redocly.app/ja/api/digital-distribution-hub/game-keys/get-game-keys-group.md): カタログを作成するために、指定されたグループからゲームキーリストを取得します。 注意すべてのプロジェクトには、取得できるアイテムの数に制限があります。応答。デフォルトおよび最大値は1応答あたり50アイテムです。ページごとにより多くのデータを取得するには、制限とオフセットフィールドを使用します。 ### カタログ用のゲームキーを取得する - [GET /v2/project/{project_id}/items/game/key/sku/{item_sku}](https://xsolla.redocly.app/ja/api/digital-distribution-hub/game-keys/get-game-key-by-sku.md): カタログのゲームキーを取得します。 ### カタログ用のゲームを取得する - [GET /v2/project/{project_id}/items/game/sku/{item_sku}](https://xsolla.redocly.app/ja/api/digital-distribution-hub/game-keys/get-game-by-sku.md): カタログのゲームを取得します。 ## 仮想アイテム & 通貨 ### アイテムグループリストを取得する - [GET /v2/project/{project_id}/items/groups](https://xsolla.redocly.app/ja/api/digital-distribution-hub/virtual-items-and-currency/get-item-groups.md): カタログを作成するためのアイテムグループリストを取得します。 ### 仮想通貨リストを取得する - [GET /v2/project/{project_id}/items/virtual_currency](https://xsolla.redocly.app/ja/api/digital-distribution-hub/virtual-items-and-currency/get-virtual-currency.md): カタログを作成するための仮想通貨リストを取得します。 注意すべてのプロジェクトには、応答で取得できるアイテムの数に制限があります。デフォルトおよび最大値は応答あたり50アイテムです。ページごとにより多くのデータを取得するには、制限フィールドとオフセットフィールドを使用します。 ### 仮想通貨パッケージリストを取得する - [GET /v2/project/{project_id}/items/virtual_currency/package](https://xsolla.redocly.app/ja/api/digital-distribution-hub/virtual-items-and-currency/get-virtual-currency-package.md): カタログを作成するための仮想通貨パッケージリストを取得します。 注意すべてのプロジェクトには、応答で取得できるアイテムの数に制限があります。デフォルトおよび最大値は応答あたり50アイテムです。ページごとにより多くのデータを取得するには、制限フィールドとオフセットフィールドを使用します。 ### 仮想アイテムリストを取得する - [GET /v2/project/{project_id}/items/virtual_items](https://xsolla.redocly.app/ja/api/digital-distribution-hub/virtual-items-and-currency/get-virtual-items.md): カタログを作成するための仮想アイテムリストを取得します。 注意すべてのプロジェクトには、応答で取得できるアイテムの数に制限があります。デフォルトおよび最大値は応答あたり50アイテムです。ページごとにより多くのデータを取得するには、制限とオフセットフィールドを使用します。 ### 指定されたグループごとにアイテムリストを取得する - [GET /v2/project/{project_id}/items/virtual_items/group/{external_id}](https://xsolla.redocly.app/ja/api/digital-distribution-hub/virtual-items-and-currency/get-virtual-items-group.md): カタログを作成するために、指定されたグループからアイテムリストを取得します。 注意すべてのプロジェクトには、取得できるアイテムの数に制限があります。応答。デフォルトおよび最大値は1応答あたり50アイテムです。ページごとにより多くのデータを取得するには、制限とオフセットフィールドを使用します。 ## バンドル ### バンドルのリストを取得する - [GET /v2/project/{project_id}/items/bundle](https://xsolla.redocly.app/ja/api/digital-distribution-hub/bundles/get-bundle-list.md): カタログを作成するためのバンドルリストを取得します。 注意すべてのプロジェクトには、応答で取得できるアイテムの数に制限があります。デフォルトおよび最大値は、1応答あたり50アイテムです。 ### 指定されたバンドルを取得する - [GET /v2/project/{project_id}/items/bundle/sku/{sku}](https://xsolla.redocly.app/ja/api/digital-distribution-hub/bundles/get-bundle.md): 指定されたバンドルを取得します。 ## ユーザートークン ### ユーザートークンを作成する - [POST /v2/project/{project_id}/distribution_hub/user/auth](https://xsolla.redocly.app/ja/api/digital-distribution-hub/user-token/create-user-token.md): ユーザーがゲームに存在することを確認し、ユーザートークンを作成します。 ## 通知 ### 通知をキャンセルする - [POST /push-payments/cancel](https://xsolla.redocly.app/ja/api/digital-distribution-hub/notifications/cancel-notification.md): 次の場合、支払いのキャンセルに関する通知を送信します： - 支払いが完了しなかった場合 - 支払いが払い戻された場合 ### 支払い通知 - [POST /push-payments/pay](https://xsolla.redocly.app/ja/api/digital-distribution-hub/notifications/pay-notification.md): ユーザーへの請求が成功した後に、この通知を送信します。 ## 注文 ### 注文を受ける - [GET /v2/project/{project_id}/distribution_hub/order/{order_id}](https://xsolla.redocly.app/ja/api/digital-distribution-hub/order/get-order.md): 指定された注文を取得します。 ### 現在のカートからすべてのアイテムを注文する - [POST /v2/project/{project_id}/distribution_hub/payment/cart](https://xsolla.redocly.app/ja/api/digital-distribution-hub/order/create-order.md): カートからすべてのアイテムを含む注文を作成します。作成された注文は、newの注文ステータスになります。 ### 特定のカートからすべてのアイテムを注文する - [POST /v2/project/{project_id}/distribution_hub/payment/cart/{cart_id}](https://xsolla.redocly.app/ja/api/digital-distribution-hub/order/create-order-by-cart-id.md): 特定のカートからすべてのアイテムを含む注文を作成します。作成された注文は、new注文ステータスを取得します。 ### 指定したアイテムで注文を作成する - [POST /v2/project/{project_id}/distribution_hub/payment/item/{item_sku}](https://xsolla.redocly.app/ja/api/digital-distribution-hub/order/create-order-with-item.md): 指定されたアイテムで注文を作成します。作成された注文はnew注文ステータスになります。