快速购买接口v2

POST

https://openapi.cs2dt.com/v1/trade/v2/quick-buy

快速购买
指定某一个饰品(itemId或者marketHashName进行购买)进行快速购买最便宜的一个

支持中英文切换，您需要在请求头header中添加参数名language参数值en_US,用于获取购买失败场景的英文信息响应

1207 当前饰品已被卖家改价或者被其他玩家购买，请重新购买或者选择其他卖家的饰品
1317 无满足条件的在售饰品
1363 发生异常购买失败
1367 该Steam账号由于过去12小时购买订单存在多次不收货或者拒绝收货行为，系统暂时暂时限制其进行购买，该限制将在%s之后解除
1369 该Steam账号存在欺诈行为，被禁止购买
1403 价格发生变更，请重试
1454 商品价格大于购买最大价格
70001 余额不足
70002 获取余额信息失败
100000 系统异常
100001 ip不在白名单中, 当前请求ip: %s
100002 您没有使用接口权限
101008 用户未添加steam账号
106505 用户 steam 账号不可交易
106509 用户 steam 库存未公开
106310 用户提供的交易链接已失效
106516 用户启用了 steam 家庭监护导致无法交易
106517 用户 steam 账号被红锁
106006 用户账号被 vac 所以无法交易
106517 用户 steam 账号被红锁
140000 系统异常
140001 参数错误
140002 操作失败
140005 交易链接错误
140006 用户不存在
140014 商户订单号已存在
140010 当前steam账号购买功能禁用,解封时间:%s
140011 当前用户还未入驻开放平台
140018 调用接口超时，请重试，如果是购买接口请使用相同的outTradeNo重试或者等待回调通知
140020 请求需要参数app-key
140024 采购失败
140025 用户信息不存在
141001 请先登录
141005 交易链接错误(trade Url format error)
201445 发生异常，支付状态未知，请耐心等待回调或等一分钟后主查询订单详情
600024 暂不支持冷却期饰品
1014452 当前饰品已经不是在售
1010324 steam token已失效，请重新填写
1014021 不能购买自己的饰品

请求参数

Query 参数

app-key

string

可选

默认值:

Body 参数application/json

快速购买参数

outTradeNo

string | null

必需

商户订单号，必须唯一
商户订单号

tradeUrl

string | null

必需

收货交易链接
收货的steam交易链接

itemId

integer | null

可选

商品类目id
饰品id, 如果有这个参数，appId和marketHashName这两个参数可不传

appId

integer | null

可选

商品appId
游戏id，配合marketHashName

marketHashName

string | null

可选

商品marketHashName
steam饰品唯一名称，需要和appId一起传

maxPrice

number | null

必需

能接受的最高价
购买a可以接受的最高价格(T币)

delivery

integer | null

可选

发货模式
可选参数，发货模式，1=人工，2自动

lowPrice

integer | null

可选

是否自动发货报价
快速购买是否购买最低价，如果是1，购买最低价，如果不是，采用默认策略, 查所有小于maxPrice的在售，如果这些在售中有自动发货，那就回选最便宜的自动发货，如果没有自动发货的，就会去选一个最便宜的东西

示例

{
  "outTradeNo": "string",
  "tradeUrl": "string",
  "itemId": 0,
  "appId": 0,
  "marketHashName": "string",
  "maxPrice": 0,
  "delivery": 0,
  "lowPrice": 0
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST 'https://openapi.cs2dt.com/v1/trade/v2/quick-buy?app-key=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "outTradeNo": "string",
    "tradeUrl": "string",
    "itemId": 0,
    "appId": 0,
    "marketHashName": "string",
    "maxPrice": 0,
    "delivery": 0,
    "lowPrice": 0
}'

返回响应

🟢200成功

application/json

Body

购买结果

success

boolean | null

可选

Is request successful

data

object (OpenBuyResultDTO)

可选

Business data

buyPrice

number | null

可选

购买实际支付金额（T币）

orderId

string | null

订单id

可选

delivery

integer | null

可选

发货模式，1=人工，2自动

offerId

string | null

可选

如果购买自动发货物品时选择了立即发送报价，则会返回这个offerId，可以使用报价详情接口查看

errorCode

integer | null

可选

Error code

errorMsg

string | null

可选

Error message

errorData

object (Object)

可选

Error data,when errorCode is not equals to 0,maybe this property will have a value

示例

{
  "success": false,
  "data": {
    "buyPrice": 0,
    "orderId": "",
    "delivery": 0,
    "offerId": ""
  },
  "errorCode": 0,
  "errorMsg": "",
  "errorData": {}
}

修改于 2025-01-10 07:00:27

普通购买v2

购买订单列表接口