批量购买皮肤并发送给用户

主要

基本信息生成签名

存款

入门创建存款创建存款（不带重定向）(iframe) 存款通知（webhook）检查存款状态获取存款列表无需8天等待的存款（Steam交易保护）批准8天冻结期的存款获取失败的 webhook 通知

无SkinsBack用户界面的存款

Create a deposit without SkinsBack UI (API) 获取用户库存

提取皮肤

价格列表（皮肤可用性）搜索皮肤购买皮肤批量购买皮肤购买皮肤的状态皮肤购买历史

其他

项目余额余额和存款提现历史记录货币和汇率服务器状态事件实时性：websockets 实时事件：回调

批量购买皮肤并发送给用户

批量购买皮肤并发送给用户。

个蓝色 个必填参数。

向 API终点发送POST请求，使用以下参数：

method

string

market_batch_buy

partner

string

来自用户的交易URL中的'partner'值

token

string

来自用户的交易URL中的'token'值

items

array

购买皮肤的一系列物品

items[][id]

int

皮肤在价格列表或搜索中的ID

items[][max_price]

float

购买皮肤的最大成本（以美元计）。用作成本限制器

items[][custom_id]

string

系统中的唯一ID。用于防止重复购买

服务器响应：

如果成功，服务器的响应将是一个JSON对象，内容如下：

purchased

array

包含已购买皮肤列表的数组，描述如下

unavailable

array

包含不可用皮肤 ID 和原因列表的数组：
- insufficient_funds (error_code: 4) — 项目余额不足
- skin_unavailable (error_code: 5) — 皮肤无法购买
- skins_not_found_at_specified_price (error_code: 6) — 没有找到价格小于'max_price'的皮肤
- custom_id_already_exists: (error_code: 7) — 'custom_id'已存在于我们的系统中

已购买数组

item

object

包含已购买的皮肤信息的对象

— item.id

int

皮肤ID

— item.name

string

皮肤名称

— item.price

float

皮肤价格（美元）

— item.classid

string

皮肤的Class ID

buy_id

int

购买的ID，在之后用于检查物品传递的状态

offer_status

string

购买状态：
1. 'creating_trade' — 创建交易
2. 'waiting_accept' — 等待接受交易
3. 'accepted' — 交易已接受
4. 'canceled' — 交易被用户取消
5. 'timeout' — 10分钟内未接受交易
6. 'invalid_trade_token' — 交易令牌无效
7. 'user_not_tradable' — 用户在交易系统中受限
8. 'trade_create_error' — 创建交易错误（请重试
9. 'rollback_user' — 皮肤已被用户退回（Steam交易保护）
10. 'rollback_supplier' — 皮肤已被供应商退回（Steam交易保护）

该方法只能包含create_trade。其他状态在market_getinfo / market_history方法中

balance_debited_sum

float

从项目余额扣除的金额（美元）

成功响应示例：

{
   "status":"success",
   "purchased":{
      "62696971":{
         "item":{
            "id":"62696971",
            "name":"'The Doctor' Romanov | Sabre",
            "price":8.28,
            "classid":"3608084106",
            "instanceid":"0"
         },
         "buy_id":129112705,
         "offer_status":"creating_trade",
         "steamid":"76561198050648523",
         "date":"1748862060",
         "balance_debited_sum":8.28,
         "custom_id":"10000"
      },
      "62697425":{
         "item":{
            "id":"62697425",
            "name":"'The Doctor' Romanov | Sabre",
            "price":8.03,
            "classid":"3608084106",
            "instanceid":"0"
         },
         "buy_id":129112706,
         "offer_status":"creating_trade",
         "steamid":"76561198050648523",
         "date":"1748862060",
         "balance_debited_sum":8.03,
         "custom_id":"10001"
      }
   },
    "unavailable":{
      "62696979":{
         "error_code":5,
         "error_message":"skin_unavailable"
      },
      "62697480":{
         "error_code":5,
         "error_message":"skin_unavailable"
      }
   }
}

可能的错误列表：

invalid_partner_value

'partner'的值无效

invalid_token_value

'token'的值无效。请向用户请求新的交易URL

too_many_failed_attempts_for_user

向用户发送皮肤失败次数过多（交易URL无效，用户在指定时间内不接受皮肤，用户无法交换皮肤）。请稍后再试

-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 标头

API

批量购买皮肤并发送给用户

向 API终点 发送POST请求，使用以下参数：

服务器响应：

已购买数组

成功响应示例：

可能的错误列表：

向 API终点发送POST请求，使用以下参数：