Merchant API v2
Overview
主要
基本信息
生成签名
存款
入门
创建存款
创建存款(不带重定向)(iframe)
存款通知(webhook)
检查存款状态
获取存款列表
无需8天等待的存款(Steam交易保护)
批准8天冻结期的存款
获取失败的 webhook 通知
无SkinsBack用户界面的存款
Create a deposit without SkinsBack UI (API)
获取用户库存
提取皮肤
价格列表(皮肤可用性)
搜索皮肤
购买皮肤
批量购买皮肤
购买皮肤的状态
皮肤购买历史
取消皮肤购买
其他
项目余额
余额和存款提现历史记录
货币和汇率
服务器状态
事件实时性:websockets
实时事件:回调
价格列表(有库存的皮肤)
此方法返回可提取的现有皮肤列表。
个蓝色 个必填参数。
向 API终点 发送POST请求,使用以下参数:
method
string
market_pricelist
game
string
'cs2', 'dota2', 'rust'
full
bool
默认情况下,返回按名称分组的物品列表,其中包含可提取的数量。如果指定full=1,则返回不进行分组的带有物品标识符的完整列表。建议使用分组列表。
extended
bool
默认情况下,返回items数组中的最小字段集。如果指定extended=1,则返回每个皮肤的更多详细信息(仅与full=1一起使用)。
注意!文件大小可能非常大,为了处理它,请使用高效的 JSON 解析库(例如,PHP 的 json-machine)。
注意!文件大小可能非常大,为了处理它,请使用高效的 JSON 解析库(例如,PHP 的 json-machine)。
服务器响应:
如果成功,服务器的响应将是一个JSON对象,内容如下:
价格列表包含 Instant 和 Slow 皮肤。使用 full=1 时,每个 item 包含 delivery_type(1 = Instant,2 = Slow)。
last_update
int
价格列表的更新日期(UNIX时间)
items
array
包含可用皮肤列表的数组
'items'对象
name
string
皮肤名称
price
float
皮肤价格(美元)
classid
string
皮肤的Class ID
count
int
可用数量
完整 'items' 结构(full=1)
id
string
皮肤ID
name
string
皮肤名称
price
float
皮肤价格(美元)
classid
string
皮肤的Class ID
delivery_type
int
交付类型:1 = Instant,2 = Slow
扩展的 'items' 结构(full=1, extended=1)
paint_index
int / null
皮肤 Paint Index(可为 null)
paint_seed
int / null
皮肤 Paint Seed(可为 null)
assetid
string / null
皮肤 Steam asset ID(可为 null)
source_id
int
皮肤来源 ID
stickers
array
物品上的贴纸、挂件和臂章(仅 CS2)
贴纸项结构
name
string
带类型前缀的名称(Sticker | ...,Charm | ...,Patch | ...)
img
string
图片 URL
wear
float / null
磨损值(可为 null)
slot
int / null
槽位(可为 null)
成功响应示例:
{
"status": "success",
"last_update": "1596621504",
"items": [
{
"name": "M4A1-S | Golden Coil (Battle-Scarred)",
"price": "831.16",
"count": 1
},
{
"name": "SSG 08 | Fever Dream (Field-Tested)",
"price": "77.02",
"count": 2
},
{
"name": "Operator | FBI SWAT",
"price": "77.76",
"count": 1
}
]
}
成功响应示例(扩展模式)
下面的示例展示了带 full=1 和 extended=1 的响应。
{
"status": "success",
"last_update": "1596621504",
"items": [
{
"id": "771502",
"name": "M4A1-S | Golden Coil (Battle-Scarred)",
"price": "831.16",
"classid": "3020283907",
"delivery_type": 1,
"paint_index": 426,
"paint_seed": 661,
"assetid": "41234567890",
"source_id": 1,
"stickers": [
{
"name": "Sticker | FaZe Clan (Gold) | Shanghai 2024",
"img": "https://cdn.steamstatic.com/apps/730/icons/econ/stickers/rmr2020/faze_gold.png",
"wear": 0,
"slot": 0
},
{
"name": "Charm | Die-cast AK",
"img": "https://cdn.steamstatic.com/apps/730/icons/econ/keychains/weapon_1/kc_wpn_ak_jelly.png",
"wear": 0,
"slot": null
}
]
},
{
"id": "771503",
"name": "Operator | FBI SWAT",
"price": "77.76",
"classid": "4699526876",
"delivery_type": 2,
"paint_index": null,
"paint_seed": null,
"assetid": "41234567891",
"source_id": 2,
"stickers": [
{
"name": "Patch | Howl Patch",
"img": "https://cdn.steamstatic.com/apps/730/icons/econ/patches/howl.png",
"wear": 0,
"slot": null
}
]
},
{
"id": "771504",
"name": "SSG 08 | Fever Dream (Field-Tested)",
"price": "77.02",
"classid": "3770669160",
"delivery_type": 1,
"paint_index": 844,
"paint_seed": 412,
"assetid": "41234567892",
"source_id": 1,
"stickers": []
}
]
}
可能的错误列表:
1
file_unavailable
文件暂时不可用
-6
market_disabled
市场已禁用
标准错误:
-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 标头