普通购买v2 - CS2DT饰品开放平台

使用单个饰品在售列表接口中的商品id进行购买, 购买可能会遇到错误码详细见Status中枚举，购买可能会产生的错误码见下方的响应码说明

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

errorCode说明：
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 不能购买自己的饰品
103011 steam状态异常，请重新检测

请求参数

Query 参数

app-key

string

可选

默认值:

Body 参数application/json

outTradeNo

string | null

必需

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

tradeUrl

string | null

必需

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

productId

integer | null

必需

在售id
在售id，使用在售列表接口请求返回的参数

buyPrice

number | null

可选

购买价格
购买价格，可选参数，用于校验价格，如果传了这个参数会与数据库中的价格进行比对，如果不一致则购买失败，单位美元

maxPrice

number | null

可选

最大价格
最大购买价格，可选参数，如果传了这个参数，会导致buyPrice作用失效，另外如果这个商品价格小于等于最大购买价格，都可以购买成功

示例

{
    "outTradeNo": "string",
    "tradeUrl": "string",
    "productId": 0,
    "buyPrice": 0,
    "maxPrice": 0
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢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.0,
    "orderId": "",
    "delivery": 0,
    "offerId": ""
  },
  "errorCode": 0,
  "errorMsg": "",
  "errorData": {}
}