主要
基本信息
生成签名
存款
入门
创建存款
创建存款(不带重定向)(iframe)
存款通知(webhook)
检查存款状态
获取存款列表
无需8天等待的存款(Steam交易保护)
批准8天冻结期的存款
获取失败的 webhook 通知
无SkinsBack用户界面的存款
Create a deposit without SkinsBack UI (API)
获取用户库存
提取皮肤
价格列表(皮肤可用性)
搜索皮肤
购买皮肤
批量购买皮肤
购买皮肤的状态
皮肤购买历史
其他
项目余额
余额和存款提现历史记录
货币和汇率
服务器状态
事件实时性:websockets
实时事件:回调
Get a user's inventory
This method allows you to obtain the user's Steam inventory for further creation of a deposit via the API.
个蓝色 个必填参数。
向 API终点 发送POST请求,使用以下参数:
method
string
user_inventory
game
string
'cs2', 'dota2', 'rust'
steam_id
string
User Steam ID
trade_token
string
'token' value from the user's Trade URL
custom_multiplier
double
自定义价格乘数(覆盖项目设置中的值)。最小值:0.5,最大值:2
custom_currency
string
自定义货币(custom_currency_rate 必需)。您可以传递自定义货币的名称并指定其汇率。皮肤价格将以此货币显示。最多 4 个字符。
custom_currency_rate
double
任意货币的汇率(custom_currency 必需)。最小值:0.1
服务器响应:
如果成功,服务器的响应将是一个JSON对象,内容如下:
items
array
下面是一个元素数组
currency_local
string
Passed currency for skin prices (price_local and multiplied_price_local)
'items'对象
item.asset_id
string
Asset ID of the skin from the Steam inventory. The deposit creation method is passed to the API
item.tradable
bool
Is the skin available for trade on Steam?
item.app_id
int
App ID of the game on Steam. Can be used to form a link to a skin image
item.icon_url
string
Value from the Steam inventory, used to form a link to the skin image (https://steamcommunity-a.akamaihd.net/economy/image/{icon_url}/200fx200f)
item.class_id
string
Value from Steam inventory. Can be used to form a link to a skin image
name
string
Skin name
price
float
The price in USD currency that you will receive on the project balance
stickers
array
Skin stickers (CS2 only)
disabled
bool
If the value is 'true', then we cannot accept this skin and its Asset ID should not be transferred when creating a deposit
price_local
float
Price in currency 'currency'
multiplied_price_local
float
Skin price in currency 'currency' with a multiplier from the project settings
成功响应示例:
{
"status": "success",
"data": {
"items": [
{
"item": {
"asset_id": "4284666526576951869",
"tradable": 1,
"app_id": 252490,
"icon_url": "6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Je5GTEfCk4nReh8DEiv5dbOK0-r7A-Rvoc_CHvvg",
"class_id": "1239822445"
},
"name": "Black Bandana",
"price": 0.07,
"stickers": [],
"disabled": false,
"price_local": 6.49,
"multiplied_price_local": 12.98
},
{
"item": {
"asset_id": "4284666526576951710",
"tradable": 1,
"app_id": 252490,
"icon_url": "6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Je5GPMfCk4nReh8DEiv5daMK84rrwwQ_m6f-_bfrM",
"class_id": "1150042773"
},
"name": "Forest Camo Pants",
"price": 0.06,
"stickers": [],
"disabled": true,
"price_local": 5.56,
"multiplied_price_local": 11.13
},
{
"item": {
"asset_id": "4284666526576951707",
"tradable": 1,
"app_id": 252490,
"icon_url": "6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Je5GPGfCk4nReh8DEiv5ddOKo-rrY3Rf642xqEoVY",
"class_id": "1132469022"
},
"name": "Multicam Jacket",
"price": 0.06,
"stickers": [],
"disabled": true,
"price_local": 5.56,
"multiplied_price_local": 11.13
},
{
"item": {
"asset_id": "4284666526576951664",
"tradable": 1,
"app_id": 252490,
"icon_url": "6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Je5GHEfCk4nReh8DEiv5dYMKA5pLYzRv6605EYJLk",
"class_id": "1217055316"
},
"name": "Cloth",
"price": 0.06,
"stickers": [],
"disabled": true,
"price_local": 5.56,
"multiplied_price_local": 11.13
},
{
"item": {
"asset_id": "4477205562413429653",
"tradable": 1,
"app_id": 252490,
"icon_url": "6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Je5GTGfCk4nReh8DEiv5dYP6A2rbA-Rf25SfAER4E",
"class_id": "1239847866"
},
"name": "Forest Camo Bandana",
"price": 0.08,
"stickers": [],
"disabled": false,
"price_local": 7.42,
"multiplied_price_local": 14.84
},
{
"item": {
"asset_id": "7040881650036228451",
"tradable": 1,
"app_id": 252490,
"icon_url": "6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Je5GvGfCk4nReh8DEiv5dRPa89rbIzQPHomfYsJw",
"class_id": "1367550349"
},
"name": "XXL Picture Frame",
"price": 0.14,
"stickers": [],
"disabled": false,
"price_local": 12.98,
"multiplied_price_local": 25.97
},
{
"item": {
"asset_id": "7040881650018509899",
"tradable": 1,
"app_id": 252490,
"icon_url": "6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Je5GfDfCk4nReh8DEiv5dePqo-rbE2QfDetTZYmg",
"class_id": "1221869347"
},
"name": "Facepunch TShirt",
"price": 0.07,
"stickers": [],
"disabled": false,
"price_local": 6.49,
"multiplied_price_local": 12.98
},
{
"item": {
"asset_id": "7040881650018503217",
"tradable": 1,
"app_id": 252490,
"icon_url": "6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Je5GvHfCk4nReh8DEiv5dYMK48rbA3Qf25xd6nYFI",
"class_id": "1367240336"
},
"name": "Two Sided Hanging Sign",
"price": 0.14,
"stickers": [],
"disabled": false,
"price_local": 12.98,
"multiplied_price_local": 25.97
},
{
"item": {
"asset_id": "7040881650018499246",
"tradable": 1,
"app_id": 252490,
"icon_url": "6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Je5GvNfCk4nReh8DEiv5dRMao6rrcxRfpxw9ozkg",
"class_id": "1368658386"
},
"name": "One Sided Town Sign Post",
"price": 0.14,
"stickers": [],
"disabled": false,
"price_local": 12.98,
"multiplied_price_local": 25.97
},
{
"item": {
"asset_id": "7040881650018499211",
"tradable": 1,
"app_id": 252490,
"icon_url": "6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Je5GvEfCk4nReh8DEiv5ddOag8qL02QPu8iE0BWx4",
"class_id": "1368124330"
},
"name": "Large Banner Hanging",
"price": 0.14,
"stickers": [],
"disabled": false,
"price_local": 12.98,
"multiplied_price_local": 25.97
},
{
"item": {
"asset_id": "7040881650018498241",
"tradable": 1,
"app_id": 252490,
"icon_url": "6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Je5GTHfCk4nReh8DEiv5daPK03qrA0Q_64iUe-2eI",
"class_id": "1239833770"
},
"name": "Snow Camo Bandana",
"price": 0.08,
"stickers": [],
"disabled": false,
"price_local": 7.42,
"multiplied_price_local": 14.84
},
{
"item": {
"asset_id": "7040881650018497805",
"tradable": 1,
"app_id": 252490,
"icon_url": "6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Je5GbAfCk4nReh8DEiv5dROag6pLw1SPnr505JuQ",
"class_id": "1221777137"
},
"name": "Rescue Cap",
"price": 0.06,
"stickers": [],
"disabled": true,
"price_local": 5.56,
"multiplied_price_local": 11.13
},
{
"item": {
"asset_id": "7040881650018497278",
"tradable": 1,
"app_id": 252490,
"icon_url": "6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Je5GTGfCk4nReh8DEiv5dYP6A2rbA-Rf25SfAER4E",
"class_id": "1239847866"
},
"name": "Forest Camo Bandana",
"price": 0.08,
"stickers": [],
"disabled": false,
"price_local": 7.42,
"multiplied_price_local": 14.84
},
{
"item": {
"asset_id": "7040881650018497260",
"tradable": 1,
"app_id": 252490,
"icon_url": "6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Je5WbEfCk4nReh8DEiv5daOa4_rLI_RPi6S8mOXYo",
"class_id": "1594188998"
},
"name": "Gun Box",
"price": 0.16,
"stickers": [],
"disabled": false,
"price_local": 14.84,
"multiplied_price_local": 29.68
},
{
"item": {
"asset_id": "4284666526577962863",
"tradable": 1,
"app_id": 252490,
"icon_url": "6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Je5GTEfCk4nReh8DEiv5dbOK0-r7A-Rvoc_CHvvg",
"class_id": "1239822445"
},
"name": "Black Bandana",
"price": 0.07,
"stickers": [],
"disabled": false,
"price_local": 6.49,
"multiplied_price_local": 12.98
},
{
"item": {
"asset_id": "4284666526577962836",
"tradable": 1,
"app_id": 252490,
"icon_url": "6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Je5GTEfCk4nReh8DEiv5dbOK0-r7A-Rvoc_CHvvg",
"class_id": "1239822445"
},
"name": "Black Bandana",
"price": 0.07,
"stickers": [],
"disabled": false,
"price_local": 6.49,
"multiplied_price_local": 12.98
},
{
"item": {
"asset_id": "4284666526577962770",
"tradable": 1,
"app_id": 252490,
"icon_url": "6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Je5GTEfCk4nReh8DEiv5dbOK0-r7A-Rvoc_CHvvg",
"class_id": "1239822445"
},
"name": "Black Bandana",
"price": 0.07,
"stickers": [],
"disabled": false,
"price_local": 6.49,
"multiplied_price_local": 12.98
}
],
"currency_local": "rub"
}
}
可能的错误列表:
1
invalid_game
指定的游戏无效
2
invalid_steam_id
无效的 steam_id。Steam ID 示例:76561198827262007
3
invalid_trade_token
无效交易令牌。向用户请求一个新的交易 URL
4
invalid_currency
指定的货币无效
5
user_not_tradable
用户在贸易系统中受到限制
6
user_inventory_is_hidden
用户的库存被隐藏。请用户打开
7
user_inventory_is_unavailable
该用户的库存不可用。再试一次
8
invalid_custom_currency
指定的自定义货币无效
9
invalid_custom_currency_rate
指定的自定义货币汇率无效
10
invalid_custom_multiplier
指定的自定义乘数无效. 最小值:0.5,最大值:2
标准错误:
-1
please_use_post_method
需要使用POST方法
-2
invalid_shopid
项目ID在系统中未找到
-3
invalid_signature
签名格式不正确
-4
shop_not_active
项目不处于活动状态
-5
invalid_method
无效的API方法
-7
request_limit_reached
请求限制已达到(每分钟500次)
-8
invalid_ip_address
请在项目设置中指定IP地址
-9
under_maintenance
网站维护中
-10
invalid_client_secret
无效的 X-CLIENT-SECRET 标头
错误响应示例:
{
"status": "error",
"error_code": 4,
"error_message": "invalid_currency"
}