# 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 ゲーム付きカートを販売する場合、[認証なしでエンドポイントを呼び出すこと](/ja/doc/buy-button/how-to/set-up-authentication/#guides_buy_button_selling_items_not_authenticated_users)ができます。 そのためには： * ゲームのヘッダーの`x-unauthorized-id`パラメータに一意の識別子を追加します。 * ゲームのヘッダーで`x-user`パラメータ（Base64でエンコードされた）にユーザーのメールアドレスを追加します。 デフォルトでは、エクソーラログインユーザートークン（Bearerトークン）が認証に使用されます。テスト用のエクソーラログインユーザートークンでこのエンドポイントを呼び出すことができます：`Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE5NjIyMzQwNDgsImlzcyI6Imh0dHBzOi8vbG9naW4ueHNvbGxhLmNvbSIsImlhdCI6MTU2MjE0NzY0OCwidXNlcm5hbWUiOiJ4c29sbGEiLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6IjA2SWF2ZHpDeEVHbm5aMTlpLUc5TmMxVWFfTWFZOXhTR3ZEVEY4OFE3RnMiLCJzdWIiOiJkMzQyZGFkMi05ZDU5LTExZTktYTM4NC00MjAxMGFhODAwM2YiLCJlbWFpbCI6InN1cHBvcnRAeHNvbGxhLmNvbSIsInR5cGUiOiJ4c29sbGFfbG9naW4iLCJ4c29sbGFfbG9naW5fcHJvamVjdF9pZCI6ImU2ZGZhYWM2LTc4YTgtMTFlOS05MjQ0LTQyMDEwYWE4MDAwNCIsInB1Ymxpc2hlcl9pZCI6MTU5MjR9.GCrW42OguZbLZTaoixCZgAeNLGH2xCeJHxl8u8Xn2aI`。 [ペイステーションアクセストークン](https://developers.xsolla.com/ja/api/pay-station/operation/create-token/)を代用として使用することができます。 Type: http Scheme: bearer ### XsollaLoginUserJWT デフォルトでは、エクソーラログインユーザートークン（Bearerトークン）が認証に使用されます。テスト用のエクソーラログインユーザートークンでこのエンドポイントを呼び出すことができます：`Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE5NjIyMzQwNDgsImlzcyI6Imh0dHBzOi8vbG9naW4ueHNvbGxhLmNvbSIsImlhdCI6MTU2MjE0NzY0OCwidXNlcm5hbWUiOiJ4c29sbGEiLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6IjA2SWF2ZHpDeEVHbm5aMTlpLUc5TmMxVWFfTWFZOXhTR3ZEVEY4OFE3RnMiLCJzdWIiOiJkMzQyZGFkMi05ZDU5LTExZTktYTM4NC00MjAxMGFhODAwM2YiLCJlbWFpbCI6InN1cHBvcnRAeHNvbGxhLmNvbSIsInR5cGUiOiJ4c29sbGFfbG9naW4iLCJ4c29sbGFfbG9naW5fcHJvamVjdF9pZCI6ImU2ZGZhYWM2LTc4YTgtMTFlOS05MjQ0LTQyMDEwYWE4MDAwNCIsInB1Ymxpc2hlcl9pZCI6MTU5MjR9.GCrW42OguZbLZTaoixCZgAeNLGH2xCeJHxl8u8Xn2aI`。 [ペイステーションアクセストークン](https://developers.xsolla.com/ja/api/pay-station/operation/create-token/)を代用として使用することができます。 Type: http Scheme: bearer Bearer Format: JWT ### basicAuth エクソーラのAPIは基礎アクセス認証を使用します。APIへのすべてのリクエストは `Authorization: Basic ` ヘッダーを含む必要があり、`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/`。 * `api_key`は、作成時に一度だけパブリッシャーアカウントに表示され、お客様側で保存する必要があります。新しいキーは、次のセクションで作成することができます： * **会社設定＞APIキー** * **プロジェクト設定 > APIキー** * `project_id`表示： * プロジェクト名の横にあるパブリッシャーアカウントで表示されます。 * パブリッシャーアカウントでプロジェクトを操作する際に、ブラウザのアドレスバーに表示されるURL。URLは以下の形式です：`https://publisher.xsolla.com//projects/`。 APIキーの操作に関する詳細は、[APIリファレンス](https://developers.xsolla.com/ja/api/getting-started/#api_keys_overview)を参照してください。 Type: http Scheme: basic ### basicMerchantAuth エクソーラAPIはベーシックアクセス認証を使用します。APIへのすべてのリクエストは`Authorization: Basic `ヘッダーを含む必要があり、`your_authorization_basic_key`はBase64標準に従ってエンコードされた`merchant_id:api_key`ペアです。 [パブリッシャーアカウント](https://publisher.xsolla.com/)に移動して、パラメータの値を確認します： * `merchant_id`が表示されます： * **会社設定 > 会社**セクションで * 任意のパブリッシャーアカウントページのブラウザアドレスバーにあるURL。URLは以下の形式です：`https://publisher.xsolla.com/` * `api_key`は、作成時に一度だけパブリッシャーアカウントに表示され、お客様側で保存する必要があります。新しいキーは、次のセクションで作成することができます： * **会社設定 > APIキー** * **プロジェクト設定 > APIキー** APIキーの操作に関する詳細は、[APIリファレンス](https://developers.xsolla.com/ja/api/getting-started/#api_keys_overview)を参照してください。 Type: http Scheme: basic ## Download OpenAPI description [Catalog API](https://developers.xsolla.com/_bundle/@l10n/ja/api/catalog/index.yaml) ## 管理者 ### 仮想通貨のリストを取得する - [GET /v2/project/{project_id}/admin/items/virtual_currency](https://developers.xsolla.com/ja/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/ja/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/ja/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/ja/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/ja/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/ja/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/ja/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/ja/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/ja/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/ja/api/catalog/virtual-items-currency-admin/admin-update-virtual-currency.md): 仮想通貨を更新します。 ### 仮想アイテムのリストを取得する - [GET /v2/project/{project_id}/admin/items/virtual_items](https://developers.xsolla.com/ja/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/ja/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/ja/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/ja/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/ja/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/ja/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/ja/api/catalog/virtual-items-currency-admin/admin-update-virtual-item.md): 仮想アイテムを更新します。 ## カタログ ### アイテムグループリストを取得する - [GET /v2/project/{project_id}/items/groups](https://developers.xsolla.com/ja/api/catalog/virtual-items-currency-catalog/get-item-groups.md): カタログを構築するためのアイテムグループリストを取得します。 ### 仮想通貨リストを取得する - [GET /v2/project/{project_id}/items/virtual_currency](https://developers.xsolla.com/ja/api/catalog/virtual-items-currency-catalog/get-virtual-currency.md): カタログ構築のために、仮想通貨のリストを取得します。 注意すべてのプロジェクトには、応答で得られるアイテムの数に制限があります。初期値および最大値は、1応答50アイテムです。ページごとに多くのデータを取得するには、制限とオフセットフィールドを使用します。 注意事項アイテムカタログAPIコールの利用は、認証なしで可能ですが、パーソナライズされたカタログを取得するには、「認証」ヘッダーにユーザーのJWTを渡す必要があります。 ### 仮想通貨パッケージリストを取得 - [GET /v2/project/{project_id}/items/virtual_currency/package](https://developers.xsolla.com/ja/api/catalog/virtual-items-currency-catalog/get-virtual-currency-package.md): カタログ構築のために、仮想通貨パッケージを取得します。 注意すべてのプロジェクトには、応答で得られるアイテムの数に制限があります。初期値および最大値は、1応答50アイテムです。ページごとに多くのデータを取得するには、制限とオフセットフィールドを使用します。 注意事項アイテムカタログAPIコールの利用は、認証なしで可能ですが、パーソナライズされたカタログを取得するには、「認証」ヘッダーにユーザーのJWTを渡す必要があります。 ### SKUによる販売可能なアイテムを取得する - [GET /v2/project/{project_id}/items/virtual_currency/package/sku/{virtual_currency_package_sku}](https://developers.xsolla.com/ja/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/ja/api/catalog/virtual-items-currency-catalog/get-virtual-currency-sku.md): カタログを作成するためにSKUによる仮想通貨を取得します。 注このエンドポイントは認証なしでアクセスでき、一般的なデータを返します。しかし、認証は、利用可能なユーザー制限やプロモーションのような、パーソナライズされた結果のためのユーザー固有の詳細で応答の質を高めます。 ### 仮想アイテムリストを取得 - [GET /v2/project/{project_id}/items/virtual_items](https://developers.xsolla.com/ja/api/catalog/virtual-items-currency-catalog/get-virtual-items.md): カタログ構築のために、仮想アイテムのリストを取得します。 注意すべてのプロジェクトには、応答で得られるアイテムの数に制限があります。初期値および最大値は、1応答50アイテムです。ページごとに多くのデータを取得するには、制限とオフセットフィールドを使用します。 注意事項アイテムカタログAPIコールの利用は、認証なしで可能ですが、パーソナライズされたカタログを取得するには、「認証」ヘッダーにユーザーのJWTを渡す必要があります。 ### すべての仮想アイテムリストを取得する - [GET /v2/project/{project_id}/items/virtual_items/all](https://developers.xsolla.com/ja/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/ja/api/catalog/virtual-items-currency-catalog/get-virtual-items-group.md): カタログを作成するために、指定されたグループからアイテムリストを取得します。 注意すべてのプロジェクトで、応答で取得できるアイテム数に制限があります。デフォルトおよび最大値は、1応答50アイテムです。ページごとにさらに多くのデータを取得するには、「制限」と「オフセット」フィールドを使用します。 注このエンドポイントは認証なしでアクセスでき、一般的なデータを返します。しかし、認証は、利用可能なユーザー制限やプロモーションのような、パーソナライズされた結果のためのユーザー固有の詳細で応答の質を高めます。 ### SKUによる仮想アイテムを取得する - [GET /v2/project/{project_id}/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/ja/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/ja/api/catalog/virtual-payment/create-order-with-item-for-virtual-currency.md): 仮想通貨を利用したアイテム購入を構築します。 ## カタログ ### ゲームリストを取得 - [GET /v2/project/{project_id}/items/game](https://developers.xsolla.com/ja/api/catalog/game-keys-catalog/get-games-list.md): カタログ構築のために、ゲームのリストを取得します。 注意すべてのプロジェクトには、応答で得られるアイテムの数に制限があります。初期値および最大値は、1応答50アイテムです。ページごとに多くのデータを取得するには、制限とオフセットフィールドを使用します。 注意事項アイテムカタログAPIコールの利用は、認証なしで可能ですが、パーソナライズされたカタログを取得するには、「認証」ヘッダーにユーザーのJWTを渡す必要があります。 ### DRMリストを取得 - [GET /v2/project/{project_id}/items/game/drm](https://developers.xsolla.com/ja/api/catalog/game-keys-catalog/get-drm-list.md): 利用可能なDRMのリストを取得します。 ### 指定されたグループによるゲームリストを取得 - [GET /v2/project/{project_id}/items/game/group/{external_id}](https://developers.xsolla.com/ja/api/catalog/game-keys-catalog/get-games-group.md): カタログ構築のために、指定されたグループからゲームリストを取得します。 注意すべてのプロジェクトには、応答で得られるアイテムの数に制限があります。初期値および最大値は、1応答50アイテムです。ページごとに多くのデータを取得するには、制限とオフセットフィールドを使用します。 注意事項アイテムカタログAPIコールの利用は、認証なしで可能ですが、パーソナライズされたカタログを取得するには、「認証」ヘッダーにユーザーのJWTを渡す必要があります。 ### 指定されたグループのゲームキーリストを取得 - [GET /v2/project/{project_id}/items/game/key/group/{external_id}](https://developers.xsolla.com/ja/api/catalog/game-keys-catalog/get-game-keys-group.md): カタログ構築のために、指定されたグループからゲームキーのリストを取得します。 注意すべてのプロジェクトには、応答で得られるアイテムの数に制限があります。初期値および最大値は、1応答50アイテムです。ページごとに多くのデータを取得するには、制限とオフセットフィールドを使用します。 注意事項アイテムカタログAPIコールの利用は、認証なしで可能ですが、パーソナライズされたカタログを取得するには、「認証」ヘッダーにユーザーのJWTを渡す必要があります。 ### カタログ用のゲームキーを取得する - [GET /v2/project/{project_id}/items/game/key/sku/{item_sku}](https://developers.xsolla.com/ja/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/ja/api/catalog/game-keys-catalog/get-game-by-sku.md): カタログのゲームを取得します。 注このエンドポイントは認証なしでアクセスでき、一般的なデータを返します。しかし、認証は、利用可能なユーザー制限やプロモーションのような、パーソナライズされた結果のためのユーザー固有の詳細で応答の質を高めます。 ## 資格 ### 資格付与（管理者） - [POST /v2/project/{project_id}/admin/entitlement/grant](https://developers.xsolla.com/ja/api/catalog/game-keys-entitlement/grant-entitlement-admin.md): ユーザーに権利を付与します。 注意 ゲームコードやDRM-freeプラットフォームのゲームのみ付与可能です。 ### 資格の取り消し（管理者） - [POST /v2/project/{project_id}/admin/entitlement/revoke](https://developers.xsolla.com/ja/api/catalog/game-keys-entitlement/revoke-entitlement-admin.md): ユーザーの権利を取り消します。 注意ゲームコードやDRMフリープラットフォームのゲームのみ取り消すことができます。 ### ユーザーが所有しているゲームソフトのリストを取得 - [GET /v2/project/{project_id}/entitlement](https://developers.xsolla.com/ja/api/catalog/game-keys-entitlement/get-user-games.md): ユーザーが所有しているゲームソフトのリストを取得します。レスポンスには特定のユーザーが所有するゲームの配列が含まれます。 注意すべてのプロジェクトには、応答で得られるアイテムの数に制限があります。初期値および最大値は、1応答あたり50アイテムです。ページごとにより多くのデータを取得するには、LIMITとOFFSETフィールドを使用してください。 ### クライアントによるゲームコードを引き換える - [POST /v2/project/{project_id}/entitlement/redeem](https://developers.xsolla.com/ja/api/catalog/game-keys-entitlement/redeem-game-pin-code.md): 提供されたゲームコードで権利を付与します。 注意DRM-freeプラットフォームでのみコードの引き換えが可能です。 ## 管理者 ### ゲームリストを取得する（管理者） - [GET /v2/project/{project_id}/admin/items/game](https://developers.xsolla.com/ja/api/catalog/game-keys-admin/admin-get-game-list.md): 管理用プロジェクト内のゲームのリストを取得します。 ゲームは、ユーザーが購入可能なゲームキーで構成されています。 注意このエンドポイントは、ストアカタログの構築に使用しないでください。 ### ゲームを作成 - [POST /v2/project/{project_id}/admin/items/game](https://developers.xsolla.com/ja/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/ja/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/ja/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/ja/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/ja/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/ja/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/ja/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/ja/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/ja/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/ja/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/ja/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/ja/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/ja/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/ja/api/catalog/game-keys-admin/admin-update-game-by-sku.md): SKUによるプロジェクト内のゲームを更新します。 ## 管理者 ### バンドルのリストを取得 - [GET /v2/project/{project_id}/admin/items/bundle](https://developers.xsolla.com/ja/api/catalog/bundles-admin/admin-get-bundle-list.md): 管理用のプロジェクト内のバンドルリストを取得します。 注このエンドポイントは、ストアカタログの構築に使用しないでください。 ### バンドルを作成 - [POST /v2/project/{project_id}/admin/items/bundle](https://developers.xsolla.com/ja/api/catalog/bundles-admin/admin-create-bundle.md): バンドルを作成します。 ### 指定されたグループexternal IDのバンドルリストを取得する - [GET /v2/project/{project_id}/admin/items/bundle/group/external_id/{external_id}](https://developers.xsolla.com/ja/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/ja/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/ja/api/catalog/bundles-admin/admin-delete-bundle.md): バンドルを削除します。 ### バンドルを取得 - [GET /v2/project/{project_id}/admin/items/bundle/sku/{sku}](https://developers.xsolla.com/ja/api/catalog/bundles-admin/admin-get-bundle.md): 管理用プロジェクト内のバンドルを取得します。 注このエンドポイントは、ストアカタログの構築に使用しないでください。 ### バンドルを更新 - [PUT /v2/project/{project_id}/admin/items/bundle/sku/{sku}](https://developers.xsolla.com/ja/api/catalog/bundles-admin/admin-update-bundle.md): バンドルを更新します。 ### カタログにバンドルを非表示 - [PUT /v2/project/{project_id}/admin/items/bundle/sku/{sku}/hide](https://developers.xsolla.com/ja/api/catalog/bundles-admin/admin-hide-bundle.md): カタログにバンドルを非表示します。 ### カタログにバンドルを表示 - [PUT /v2/project/{project_id}/admin/items/bundle/sku/{sku}/show](https://developers.xsolla.com/ja/api/catalog/bundles-admin/admin-show-bundle.md): カタログにバンドルを表示します。 ## カタログ ### バンドルのリストを取得 - [GET /v2/project/{project_id}/items/bundle](https://developers.xsolla.com/ja/api/catalog/bundles-catalog/get-bundle-list.md): カタログ構築のために、バンドルのリストを取得します。 注意すべてのプロジェクトには、応答で得られるアイテムの数に制限があります。初期値および最大値は、1応答50アイテムです。 注意事項アイテムカタログAPIコールの利用は、認証なしで可能ですが、パーソナライズされたカタログを取得するには、「認証」ヘッダーにユーザーのJWTを渡す必要があります。 ### 指定されたグループのバンドルリストを取得する - [GET /v2/project/{project_id}/items/bundle/group/{external_id}](https://developers.xsolla.com/ja/api/catalog/bundles-catalog/get-bundle-list-in-group.md): カタログ構築のために、グループ内のバンドルのリストを取得します。 注意すべてのプロジェクトには、応答で得られるアイテムの数に制限があります。初期値および最大値は、1応答50アイテムです。 注意事項アイテムカタログAPIコールの利用は、認証なしで可能ですが、パーソナライズされたカタログを取得するには、「認証」ヘッダーにユーザーのJWTを渡す必要があります。 ### 指定されたバンドルを取得する - [GET /v2/project/{project_id}/items/bundle/sku/{sku}](https://developers.xsolla.com/ja/api/catalog/bundles-catalog/get-bundle.md): 指定されたバンドルを取得します。 注このエンドポイントは認証なしでアクセスでき、一般的なデータを返します。しかし、認証は、利用可能なユーザー制限やプロモーションのような、パーソナライズされた結果のためのユーザー固有の詳細で応答の質を高めます。 ## カート（クライアント側） ### 現在のユーザーのカートを取得 - [GET /v2/project/{project_id}/cart](https://developers.xsolla.com/ja/api/catalog/cart-client-side/get-user-cart.md): 現在のユーザーのカートを返します。 ### 現在のカートからすべてのカートアイテムを削除 - [PUT /v2/project/{project_id}/cart/clear](https://developers.xsolla.com/ja/api/catalog/cart-client-side/cart-clear.md): カートのアイテムをすべて削除します。 ### カートにアイテムを入れる - [PUT /v2/project/{project_id}/cart/fill](https://developers.xsolla.com/ja/api/catalog/cart-client-side/cart-fill.md): カートにアイテムを入れます。カートにすでに同じSKUのアイテムがある場合、既存のアイテムは渡された値で置き換えられます。 ### 現在のカートからアイテムを削除 - [DELETE /v2/project/{project_id}/cart/item/{item_sku}](https://developers.xsolla.com/ja/api/catalog/cart-client-side/delete-item.md): カートからアイテムを削除します。 ### 現在のカートからカートのアイテムを更新 - [PUT /v2/project/{project_id}/cart/item/{item_sku}](https://developers.xsolla.com/ja/api/catalog/cart-client-side/put-item.md): 既存のカートアイテムを更新するか、カート内のアイテムを作成します。 ### カートIDによりカートを取得 - [GET /v2/project/{project_id}/cart/{cart_id}](https://developers.xsolla.com/ja/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/ja/api/catalog/cart-client-side/cart-clear-by-id.md): カートのアイテムをすべて削除します。 ### カートに特定のアイテムを入れる - [PUT /v2/project/{project_id}/cart/{cart_id}/fill](https://developers.xsolla.com/ja/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/ja/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/ja/api/catalog/cart-client-side/put-item-by-cart-id.md): 既存のカートアイテムを更新するか、カート内のアイテムを作成します。 ## カート（サーバー側） ### カートにアイテムを入れる - [PUT /v2/admin/project/{project_id}/cart/fill](https://developers.xsolla.com/ja/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/ja/api/catalog/cart-server-side/admin-fill-cart-by-id.md): カートIDによるカートにアイテムを入れます。カートにすでに同じSKUのアイテムがある場合、既存のアイテムは渡された値で置き換えられます。 ## 決済（クライアント側） ### 現在のカートの全アイテムを対象とした注文を作成する - [POST /v2/project/{project_id}/payment/cart](https://developers.xsolla.com/ja/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}。 注意このメソッドはIPを使用してユーザーの国を決定し、注文の通貨を選択するため、このメソッドはクライアント側からのみ使用し、サーバー側からは使用しないことが重要です。サーバー側からこの方法を使用すると、通貨が正しく判定されず、ペイステーションの決済方法に影響を与える可能性があります。 ### 特定のカートの全アイテムを対象とした注文を作成する - [POST /v2/project/{project_id}/payment/cart/{cart_id}](https://developers.xsolla.com/ja/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}。 注意このメソッドはIPを使用してユーザーの国を決定し、注文の通貨を選択するため、このメソッドはクライアント側からのみ使用し、サーバー側からは使用しないことが重要です。サーバー側からこの方法を使用すると、通貨が正しく判定されず、ペイステーションの決済方法に影響を与える可能性があります。 ### 指定したアイテムで注文を作成する - [POST /v2/project/{project_id}/payment/item/{item_sku}](https://developers.xsolla.com/ja/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}。 注意このメソッドはIPを使用してユーザーの国を決定し、注文の通貨を選択するため、このメソッドはクライアント側からのみ使用し、サーバー側からは使用しないことが重要です。サーバー側からこの方法を使用すると、通貨が正しく判定されず、ペイステーションの決済方法に影響を与える可能性があります。 ## 決済（サーバー側） ### 購入用の決済トークンを作成する - [POST /v3/project/{project_id}/admin/payment/token](https://developers.xsolla.com/ja/api/catalog/payment-server-side/admin-create-payment-token.md): 注文とその支払いトークンを生成します。注文はリクエストボディに渡されたアイテムに基づいて生成されます。 決済UIを新しいウィンドウで開くには、次のリンクを使用します：https://secure.xsolla.com/paystation4/?token={token}。そこで、{token}は受信したトークンです。 テスト目的では、次のURLを使用します：https://sandbox-secure.xsolla.com/paystation4/?token={token}。 通知 user.country.valueパラメータは、注文の通貨を選択するために使用されます。ユーザーの国が不明な場合は、 X-User-IpヘッダーにユーザーのIPを指定することもできます。この方法の正しい動作には、これら2つのオプションのいずれかが必要です。選択した通貨は、ペイステーションでの決済方法に使用されます。 ## 注文 ### 注文する - [GET /v2/project/{project_id}/order/{order_id}](https://developers.xsolla.com/ja/api/catalog/order/get-order.md): 指定された注文を取得します。 ### 指定期間の注文リストを取得する - [POST /v3/project/{project_id}/admin/order/search](https://developers.xsolla.com/ja/api/catalog/order/admin-order-search.md): 作成日の古いものから新しいものへと並べられた注文リストを取得します。 ## 無料アイテム ### 無料カートで注文を作成する - [POST /v2/project/{project_id}/free/cart](https://developers.xsolla.com/ja/api/catalog/free-item/create-free-order.md): 無料カートのすべてのアイテムを含む注文を作成します。作成された注文はdoneという注文状況を取得します。 ### 特定の無料カートで注文を作成する - [POST /v2/project/{project_id}/free/cart/{cart_id}](https://developers.xsolla.com/ja/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/ja/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/ja/api/catalog/user-limits-admin/reset-all-user-items-limit.md): ユーザーが再度購入できるように、アイテムの購入制限を更新します。 User limit APIを使用すると、アイテムを数量限定で販売できます。購入制限を構成するには、目的のアイテム タイプ モジュールの 管理セクションに移動します： * ゲームキー * 仮想アイテム & 通貨 * バンドル ### 指定したユーザーが利用できるアイテムの数を減らす - [DELETE /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/ja/api/catalog/user-limits-admin/remove-user-item-limit.md): 適用される制限内で、指定されたユーザーが使用できるアイテムの残りの数を減らします。 User limit APIを使用すると、アイテムを数量限定で販売できます。購入制限を構成するには、目的のアイテム タイプ モジュールの 管理セクションに移動します： * ゲームキー * 仮想アイテム & 通貨 * バンドル ### 指定されたユーザが利用できるアイテムの数を取得する - [GET /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/ja/api/catalog/user-limits-admin/get-user-item-limit.md): 適用される制限内で、指定されたユーザーが使用できるアイテムの残りの数を取得します。 User limit APIを使用すると、アイテムを数量限定で販売できます。購入制限を構成するには、目的のアイテムタイプモジュールの 管理セクションに移動します： * ゲームキー * 仮想アイテム & 通貨 * バンドル ### 指定したユーザーが使用できるアイテムの数を増やす - [POST /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/ja/api/catalog/user-limits-admin/add-user-item-limit.md): 適用される制限内で、指定されたユーザーが使用できるアイテムの残りの数を増やします。 User limit APIを使用すると、アイテムを数量限定で販売できます。購入制限を構成するには、目的のアイテム タイプ モジュールの 管理セクションに移動します： * ゲームキー * 仮想アイテム & 仮想通貨 * バンドル ### 指定されたユーザーが利用できるアイテムの数を設定する - [PUT /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/ja/api/catalog/user-limits-admin/set-user-item-limit.md): 指定されたユーザーが、増減後に適用された制限の範囲内で購入できる数量を設定します。 User limit APIを使用すると、アイテムを数量限定で販売できます。購入制限を構成するには、目的のアイテムタイプモジュールの 管理セクションに移動します： * ゲームキー * 仮想アイテム & 仮想通貨 * バンドル ### 購入制限を更新する - [DELETE /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}/all](https://developers.xsolla.com/ja/api/catalog/user-limits-admin/reset-user-item-limit.md): ユーザーが再び購入できるように、アイテムの購入制限を更新します。userパラメータがnullである場合、このコールはすべてのユーザーに対してこの制限を更新します。 User limit APIを使用すると、アイテムを数量限定で販売できます。購入制限を構成するには、目的のアイテム タイプ モジュールの 管理セクションに移動します： * ゲームキー * 仮想アイテム & 仮想通貨 * バンドル ## 管理者 ### アイテムのインポート状況を取得する - [GET /v1/admin/projects/{project_id}/connectors/import_items/import/status](https://developers.xsolla.com/ja/api/catalog/connector-admin/get-items-import-status.md): プロジェクトへのアイテムのインポートの進行状況に関する情報を取得します。このAPIコールでは、APIまたはPublisher Account APIを通じて最後に実行されたインポートに関するデータを取得します。 ### JSONファイル経由でアイテムをインポートする - [POST /v1/projects/{project_id}/import/from_external_file](https://developers.xsolla.com/ja/api/catalog/connector-admin/import-items-from-external-file.md): 指定したURLを介してJSONファイルからストアにアイテムをインポートします。JSONファイルからのインポートの詳細については、ドキュメントを参照してください。 ## ウェブフック ### ウェブフック設定に関する情報を取得 - [GET /v2/project/{project_id}/admin/webhook](https://developers.xsolla.com/ja/api/catalog/common-webhooks/get-webhook.md): ストアのウェブフック設定に関する情報を取得します。 詳しくは、ウェブフックのドキュメントをご覧ください。 ### ウェブフック設定に関する情報を更新 - [PUT /v2/project/{project_id}/admin/webhook](https://developers.xsolla.com/ja/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/ja/api/catalog/common-pre-orders/remove-pre-order-limit.md): アイテムの先行予約制限の数量を削除します。 Pre-Order limit APIは、アイテムを数量限定で販売するための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/ja/api/catalog/common-pre-orders/get-pre-order-limit.md): アイテムの先行予約制限の取得を設定します。 Pre-Order limit APIは、アイテムを数量限定で販売するための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/ja/api/catalog/common-pre-orders/add-pre-order-limit.md): アイテムの先行予約数に数量を追加します。 Pre-Order limit APIは、アイテムを数量限定で販売するための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/ja/api/catalog/common-pre-orders/set-pre-order-limit.md): アイテムの先行予約制限の数量を設定します。 Pre-Order limit APIは、アイテムを数量限定で販売するための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/ja/api/catalog/common-pre-orders/remove-all-pre-order-limit.md): アイテムの先行予約制限のすべての数量を削除します。 Pre-Order limit APIは、アイテムを数量限定で販売するためのAPIです。先行予約の設定は、該当するアイテムモジュールの管理セクションから行います： * ゲームキー * 仮想アイテム & 仮想通貨 * バンドル このエンドポイントの別名： * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id}/all ### アイテムの先行予約制限をトグル - [PUT /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}/toggle](https://developers.xsolla.com/ja/api/catalog/common-pre-orders/toggle-pre-order-limit.md): アイテムの先行予約制限を有効/無効にします。 Pre-Order limit APIは、アイテムを数量限定で販売するためのAPIです。先行予約の設定は、該当するアイテムモジュールの管理セクションから行います： * ゲームキー * 仮想アイテム & 通貨 * バンドル このエンドポイントの別名： * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id}/toggle ## マーチャント ### プロジェクトを取得 - [GET /v2/merchant/{merchant_id}/projects](https://developers.xsolla.com/ja/api/catalog/common-merchant/get-projects.md): マーチャントのプロジェクトのリストを取得します。 注意このAPIコールには、project_idパスパラメータが含まれていないため、会社の全プロジェクトで有効なAPIキーを使用して認可を設定する必要があります。 ## カタログ このAPIは販売可能なアイテムや特定のアイテムを取得することができます。 ### 販売可能なアイテムのリストを取得 - [GET /v2/project/{project_id}/items](https://developers.xsolla.com/ja/api/catalog/common-catalog/get-sellable-items.md): カタログ構築のために、販売可能なアイテムのリストを取得します。 注意すべてのプロジェクトには、応答で得られるアイテムの数に制限があります。初期値および最大値は、1応答50アイテムです。ページごとに多くのデータを取得するには、制限とオフセットフィールドを使用します。 注意事項アイテムカタログAPIコールの利用は、認証なしで可能ですが、パーソナライズされたカタログを取得するには、「認証」ヘッダーにユーザーのJWTを渡す必要があります。 ### 指定されたグループの販売可能なアイテムリストを取得 - [GET /v2/project/{project_id}/items/group/{external_id}](https://developers.xsolla.com/ja/api/catalog/common-catalog/get-sellable-items-group.md): カタログ構築のために、指定されたグループから販売可能なアイテムのリストを取得します。 注意すべてのプロジェクトには、応答で得られるアイテムの数に制限があります。初期値および最大値は、1応答50アイテムです。ページごとに多くのデータを取得するには、制限とオフセットフィールドを使用します。 注意事項アイテムカタログAPIコールの利用は、認証なしで可能ですが、パーソナライズされたカタログを取得するには、「認証」ヘッダーにユーザーのJWTを渡す必要があります。 ### IDによる販売可能なアイテムを取得する - [GET /v2/project/{project_id}/items/id/{item_id}](https://developers.xsolla.com/ja/api/catalog/common-catalog/get-sellable-item-by-id.md): IDによる販売可能なアイテムを取得します。 注このエンドポイントは認証なしでアクセスでき、一般的なデータを返します。しかし、認証は、利用可能なユーザー制限やプロモーションのような、パーソナライズされた結果のためのユーザー固有の詳細で応答の質を高めます。 ### SKUによる販売可能なアイテムを取得する - [GET /v2/project/{project_id}/items/sku/{sku}](https://developers.xsolla.com/ja/api/catalog/common-catalog/get-sellable-item-by-sku.md): カタログを作成するためにSKUによる販売可能なアイテムを取得します。 注このエンドポイントは認証なしでアクセスでき、一般的なデータを返します。しかし、認証は、利用可能なユーザー制限やプロモーションのような、パーソナライズされた結果のためのユーザー固有の詳細で応答の質を高めます。 ## 共通地域 ### 地域リストを取得する - [GET /v2/project/{project_id}/admin/region](https://developers.xsolla.com/ja/api/catalog/common-regions/admin-get-regions.md): 地域を取得します。 地域制限を管理するためにリージョンを使用することができます。 ### 地域を作成する - [POST /v2/project/{project_id}/admin/region](https://developers.xsolla.com/ja/api/catalog/common-regions/admin-create-region.md): 地域を作成します。 地域制限を管理するためにリージョンを使用することができます。 ### 地域を削除する - [DELETE /v2/project/{project_id}/admin/region/{region_id}](https://developers.xsolla.com/ja/api/catalog/common-regions/admin-delete-region.md): 特定の地域を削除します。 ### 地域を取得する - [GET /v2/project/{project_id}/admin/region/{region_id}](https://developers.xsolla.com/ja/api/catalog/common-regions/admin-get-region.md): 特定地域を取得します。 地域制限を管理するために地域を使用することができます。 ### 地域を更新する - [PUT /v2/project/{project_id}/admin/region/{region_id}](https://developers.xsolla.com/ja/api/catalog/common-regions/admin-update-region.md): 特定地域を更新します。 地域制限を管理するために地域を使用することができます。 ## 管理者 ### 属性リストを取得する（管理者） - [GET /v2/project/{project_id}/admin/attribute](https://developers.xsolla.com/ja/api/catalog/attribute-admin/admin-get-attribute-list.md): 管理用プロジェクトから属性のリストを取得します。 ### 属性を作成 - [POST /v2/project/{project_id}/admin/attribute](https://developers.xsolla.com/ja/api/catalog/attribute-admin/admin-create-attribute.md): 属性を作成します。 ### 属性を削除 - [DELETE /v2/project/{project_id}/admin/attribute/{external_id}](https://developers.xsolla.com/ja/api/catalog/attribute-admin/delete-attribute.md): 属性を削除します。 注意アイテム属性を削除すると、そのすべてのデータおよびアイテムとの関連付けが失われます。 ### 指定された属性を取得 - [GET /v2/project/{project_id}/admin/attribute/{external_id}](https://developers.xsolla.com/ja/api/catalog/attribute-admin/admin-get-attribute.md): 指定された属性を取得します。 ### 属性を更新 - [PUT /v2/project/{project_id}/admin/attribute/{external_id}](https://developers.xsolla.com/ja/api/catalog/attribute-admin/admin-update-attribute.md): 属性を更新します。 ### 属性値をすべて削除 - [DELETE /v2/project/{project_id}/admin/attribute/{external_id}/value](https://developers.xsolla.com/ja/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/ja/api/catalog/attribute-admin/admin-create-attribute-value.md): 属性値を作成します。 注意すべてのプロジェクトには、応答で得られる属性値に制限があります。初期値および最大値は、1属性あたり20個の値。 ### 属性値を削除 - [DELETE /v2/project/{project_id}/admin/attribute/{external_id}/value/{value_external_id}](https://developers.xsolla.com/ja/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/ja/api/catalog/attribute-admin/admin-update-attribute-value.md): 属性値を更新します。