プロジェクト内のアップセルアイテムのリストを取得する

Xsolla Developers

または

パブリッシャーアカウントへ

← ホームページ

Shop Builder API

Overview

Download API definition

ユーザー属性

管理者

個人用カタログ

バンドル

管理者

カタログ

カート＆決済

カート（クライアント側）

カート（サーバー側）

決済（クライアント側）

決済（サーバー側）

注文

無料アイテム

通常

ウェブフック

先行予約

マーチャント

カタログ

共通地域

ゲームキー

カタログ

資格

管理者

プロモーション

通常

仮想アイテム & 仮想通貨

管理者

カタログ

仮想決済

制限

管理

リワードチェーン & バリューポイント

管理者

クライアント

クランクライアント

アップセル

管理者

クライアント

get

プロジェクト内のアップセルアイテムのリストを取得する

アイテムインポート

管理者

プロジェクト内のアップセルアイテムのリストを取得するClient-side

get/v2/project/{project_id}/items/upsell

プロジェクト内のアップセルアイテムがすでに設定されている場合、そのリストを取得します。

SecurityXsollaLoginUserJWT

Request

path Parameters

project_id

required

integer

プロジェクトID。このパラメータは、ドメインページのプロジェクト名の横にあります。

Example: 44056

Responses

200

アップセルアイテムのリストが正常に受信されました。

401

認証を通過できず、または間違っています。

Request samples

Response samples

application/json

{"has_more": true,
"items": [{"attributes": [{"external_id": "stack_size",
"name": {"en": "Quantity of items in the upsell set"
},
"values": [{"external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85",
"value": "5"
}
]
}
],
"can_be_bought": true,
"custom_attributes": {"attr": "value",
"purchased": 0
},
"description": "Big Rocket - description",
"groups": [{"external_id": "accessory",
"name": {"en": "accessory"
}
}
],
"image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png",
"inventory_options": {"consumable": {"usages_count": 1
},
"expiration_period": {"type": "day",
"value": 1
}
},
"is_free": false,
"limits": {"per_user": {"available": 3,
"recurrent_schedule": {"interval_type": "weekly",
"reset_next_date": 1746057600
},
"total": 5
}
},
"name": "Big Rocket",
"periods": [{"date_from": "2020-08-11T10:00:00+03:00",
"date_until": "2020-08-11T20:00:00+03:00"
}
],
"price": {"amount": "100.99",
"amount_without_discount": "100.99",
"currency": "USD"
},
"promotions": [{"bonus": [{"image_url": "https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png",
"name": "Xsolla Minigun",
"quantity": 1,
"sku": "com.xsolla.minigun_1",
"type": "virtual_good"
},
{"quantity": 1,
"sku": "com.xsolla.phys_good_1",
"type": "physical_good"
},
{"bundle_type": "standard",
"image_url": "https://cdn.xsolla.net/img/misc/images/9676f06265375087e607cb79c5283688.png",
"name": "Super Lootbox with items",
"quantity": 1,
"sku": "com.xsolla.SuperLootboxBundle_1",
"type": "bundle"
}
],
"date_end": "2026-04-15T16:16:00+03:00",
"date_start": "2020-04-15T16:16:00+03:00",
"discount": null,
"name": "Bonus promotion"
}
],
"sku": "com.xsolla.big_rocket_1",
"type": "virtual_good",
"virtual_item_type": "non_renewing_subscription",
"virtual_prices": [{"amount": 100,
"amount_without_discount": 100,
"description": "description",
"image_url": "http://image.png",
"is_default": true,
"name": "SHOTGUN FOR TRUE RAIDERS",
"sku": "com.xsolla.vc_1",
"type": "virtual_currency"
}
],
"vp_rewards": [ ]
},
{"attributes": [{"external_id": "stack_size",
"name": {"en": "Quantity of items in the upsell set"
},
"values": [{"external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85",
"value": "5"
}
]
},
{"external_id": "rating",
"name": {"en": "Items rating"
},
"values": [{"external_id": "rating_e3364991f92e751689a68b96598a5a5a84010b85",
"value": "3.9"
}
]
}
],
"can_be_bought": true,
"description": "description",
"groups": [{"external_id": "hair",
"name": {"en": "hair"
}
}
],
"image_url": "http://image.png",
"inventory_options": {"consumable": {"usages_count": 1
},
"expiration_period": {"type": "day",
"value": 1
}
},
"is_free": false,
"limits": null,
"name": "SHOTGUN FOR TRUE RAIDERS",
"periods": [{"date_from": "2020-08-11T20:00:00+03:00",
"date_until": null
}
],
"price": {"amount": "101.0",
"amount_without_discount": "101.0",
"currency": "USD"
},
"promotions": [ ],
"sku": "com.xsolla.shotgun_raider_1",
"type": "virtual_good",
"virtual_item_type": "non_renewing_subscription",
"virtual_prices": [{"amount": 100,
"amount_without_discount": 100,
"description": "description",
"image_url": "http://image.png",
"is_default": true,
"name": "SHOTGUN FOR TRUE RAIDERS",
"sku": "com.xsolla.vc_2",
"type": "virtual_currency"
},
{"amount": 200,
"amount_without_discount": 200,
"description": "description",
"image_url": "http://image.png",
"is_default": false,
"name": "SHOTGUN FOR TRUE RAIDERS",
"sku": "com.xsolla.vc_3",
"type": "virtual_currency"
}
],
"vp_rewards": [ ]
},
{"attributes": [ ],
"can_be_bought": true,
"description": "description",
"groups": [ ],
"image_url": "http://image.png",
"inventory_options": {"consumable": {"usages_count": 1
},
"expiration_period": {"type": "day",
"value": 1
}
},
"is_free": true,
"limits": null,
"name": "SHOTGUN FOR TRUE RAIDERS",
"periods": [ ],
"price": null,
"promotions": [ ],
"sku": "com.xsolla.shotgun_raider_2",
"type": "virtual_good",
"virtual_item_type": "non_renewing_subscription",
"virtual_prices": [ ],
"vp_rewards": [ ]
}
]
}