在购物车里添加商品Client-side
put/v2/project/{project_id}/cart/fill
在购物车里添加商品。如果购物车中已有具有相同SKU的商品，则现有商品将被传入的值替换。
SecurityAuthForCart
Responses
200
已成功返回含商品的购物车。
Request samples
- Payload
- curl
- JavaScript
- Node.js
- Python
- C#
- Go
- Java
application/json
{- "items": [
- {
- "quantity": 123,
- "sku": "booster_mega_1"
}
]
}Response samples
- 200
application/json
{- "cart_id": "cart_id",
- "is_free": false,
- "items": [
- {
- "attributes": [ ],
- "can_be_bought": true,
- "description": "Take it, take it all! All of Xsollas riches in one Mega Booster.",
- "groups": [
- {
- "external_id": "powerups",
- "name": "Power Ups"
}
], - "inventory_options": {
- "consumable": {
- "usages_count": 1
}, - "expiration_period": null
}, - "is_bonus": false,
- "is_free": false,
- "limits": {
- "per_user": {
- "available": 3,
- "recurrent_schedule": {
- "interval_type": "weekly",
- "reset_next_date": 1746057600
}, - "total": 5
}
}, - "name": "Xsolla Booster Mega",
- "periods": [
- {
- "date_from": "2020-08-11T10:00:00+03:00",
- "date_until": "2020-08-11T20:00:00+03:00"
}
], - "price": {
- "amount": "50.0000000000000000",
- "amount_without_discount": "100.0000000000000000",
- "currency": "USD"
}, - "promotions": [
- {
- "bonus": [
- {
- "name": "Xsolla Minigun",
- "quantity": 1,
- "sku": "minigun_1",
- "type": "virtual_good"
}
], - "date_end": "2026-04-15T16:16:00+03:00",
- "date_start": "2020-04-15T16:16:00+03:00",
- "discount": {
- "percent": "50.00"
}, - "name": "Bonus promotion"
}
], - "quantity": 123,
- "sku": "booster_mega_1",
- "type": "virtual_good",
- "virtual_item_type": "consumable",
- "virtual_prices": [ ],
- "vp_rewards": [
- {
- "amount": 130,
- "item_id": 175232,
- "name": "Value point",
- "sku": "value_point_1"
}, - {
- "amount": 50,
- "is_clan": true,
- "item_id": 186321,
- "name": "Clan Reward VP 1",
- "sku": "clan_value_point_sku_1"
}
]
}
], - "price": {
- "amount": "6150.0000000000000000",
- "amount_without_discount": "6150.0000000000000000",
- "currency": "USD"
}, - "promotions": [
- {
- "bonus": [
- {
- "name": "Xsolla Minigun",
- "quantity": 1,
- "sku": "minigun_1",
- "type": "virtual_good"
}
], - "date_end": "2026-04-15T16:16:00+03:00",
- "date_start": "2020-04-15T16:16:00+03:00",
- "discount": {
- "percent": "50.00"
}, - "name": "Bonus promotion"
}
], - "warnings": [
- {
- "errorCode": 4001,
- "errorMessage": "[0401-4001]: Item with Project Id = 44056 and Sku = booster_mega_2 not found",
- "quantity": 1,
- "sku": "booster_mega_21"
}
]
}
