CS2DT饰品开放平台
🇨🇳简体中文
  • 🇨🇳简体中文
  • 🇺🇸 English
首页商户中心
首页商户中心
🇨🇳简体中文
  • 🇨🇳简体中文
  • 🇺🇸 English
  1. 购买功能接口
  • CS2DT开放平台接入指南
  • 关于撤回报价惩罚处理
  • 关于撤回报价状态说明
  • v1
    • 用户相关接口
      • 用户余额查询
      • 创建Steam账号状态检测
      • 查询Steam账号状态
    • 市场商品相关接口
      • CS2款式数据
      • 根据商品id批量查询出售中的商品
      • 获取全量在售文件
      • 市场搜索
      • 饰品价格查询
      • 获取市场所有的筛选条件
      • 获取某一个饰品的所有在售
      • 获取商品的在售状态
      • 获取某个商品的在售详情
    • 购买功能接口
      • 普通购买v2
        POST
      • 快速购买接口v2
        POST
    • 订单相关接口
      • 购买订单列表接口
      • 购买订单详情
      • 买家取消订单接口
    • 回调通知说明
      • 回调通知服务说明
    • 汇率转换
      • 获取usd-cny汇率
    • 市场推送
      • websocket服务说明
      • 获取wss地址
  1. 购买功能接口

普通购买v2

POST
https://openapi.cs2dt.com/v1/trade/v2/buy
使用单个饰品在售列表接口中的商品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 参数

Body 参数application/json

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

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location -g --request POST 'https://openapi.cs2dt.com/v1/trade/v2/buy?app-key=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "outTradeNo": "string",
    "tradeUrl": "string",
    "productId": 0,
    "buyPrice": 0,
    "maxPrice": 0
}'

返回响应

🟢200成功
application/json
Body

示例
{
  "success": false,
  "data": {
    "buyPrice": 0.0,
    "orderId": "",
    "delivery": 0,
    "offerId": ""
  },
  "errorCode": 0,
  "errorMsg": "",
  "errorData": {}
}
修改于 2025-06-10 08:37:31
上一页
获取某个商品的在售详情
下一页
快速购买接口v2
Built with