Xsolla-logoXsolla Developers
または
パブリッシャーアカウントへ

カートIDでカートにアイテムを入れるServer-side

put/v2/admin/project/{project_id}/cart/{cart_id}/fill

カートIDによるカートにアイテムを入れます。カートにすでに同じSKUのアイテムがある場合、既存のアイテムは渡された値で置き換えられます。

SecuritybasicAuth
Request
path Parameters
project_id
required
integer

プロジェクトID。このパラメータは、パブリッシャーアカウントのプロジェクト名の横にあります。

Example: 44056
cart_id
required
string

カートID。

Example: custom_id
query Parameters
locale
string
Default: "en"

応答言語。ISO 639-1に基づく小文字の2文字言語コード。

header Parameters
x-user-for
string

ユーザー識別子は、エクソーラログインユーザーJWTまたはペイステーションアクセストークンを使用して転送することができます。

Example: ACCESS_TOKEN/LOGIN_JWT
x-user-id
string <= 32 characters

ゲーム付きカートを販売する場合、自分のユーザーIDを使用することができます。

Example: UNIQUE_ID
Request Body schema: application/json
required
Array of objects non-empty
Array (non-empty)
sku
required
string non-empty

一意のアイテムID。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。

quantity
required
number >= 1

アイテムの数量。

country
string = 2 characters

ISO 3166-1 alpha-2に従った2文字の大文字の国名コード。エクソーラがサポートする国の詳細情報については、ドキュメントを確認してください。
例：country=US

currency
string = 3 characters

カートに表示されるアイテム価格の通貨。ISO4217規格詳細については、ドキュメントを参照してください。エクソーラでサポートされている通貨。

Responses
200

アイテムの入ったカートは正常に返送されました。

401

基本認証が不合格または不正です。基本認証または正しい認証情報を使用したことを確認してください。

404

ユーザが見つかりませんでした。x-user-forまたはx-user-idトークンが正しいことを確認してください。

422

無効なカート。カートが存在し、空でなく、すべてのアイテムが無料でないことを確認してください。

Request samples
application/json
{
  • "currency": "USD",
  • "items": [
    ]
}
Response samples
application/json
{
  • "cart_id": "cart_id",
  • "is_free": false,
  • "items": [],
  • "price": {
    },
  • "promotions": [],
  • "warnings": [
    ]
}
System statusAll services operational

Privacy Settings

Privacy PolicyEnd User License Agreement© 2006–2025 Xsolla Inc.