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

CS2DT开放平台接入指南

更新说明#

20240430#

第一版
商户访问后台地址
https://admin.cs2dt.com

前提条件#

接入方需要准备以下信息:
获取CS2DT账号: 后续如果迭代了购买功能, 您需要预充值账户余额, 才能完成购买饰品的操作, 需要您自行通过接口进行余额查询, 以及进行充值, 保证账户余额充足, 以免影响使用.
app-key: 所有接口都需要在 query parameter 中填写您的 app-key, app-key可以在个人中心-api管理查看. 使用示例: https://openapi.cs2dt.com/v1/user/v1/t-coin/balance?app-key=appkey-example

请求结构#

调用开放平台的接口时,是指通过向我们的服务地址发送请求, 需要按照接口的地址, 请求方式, 请求参数构造请求, 否则不能调用成功. 一条查询余额的请求示例如下:

服务地址#

CS2DT开放平台已有的服务接入地址如下
服务地域域名备注
国内外https://openapi.cs2dt.com开放平台OpenAPI接入地址

通信协议#

提供的所有接口均通过 HTTPS 进行通信,提供高安全性的通信通道。

请求方式#

根据各个接口的具体需求,选择 GET 或 POST 方式发起请求。

请求参数#

在发起请求时,请求体中可能会包含两类参数:公共请求参数和接口特有的业务参数。
公共请求参数是每一个接口需要包含的,目前为query参数中的app-key。
接口特有的业务参数是各个接口特有的,参考各接口的参数描述。

字符编码#

请求及返回结果使用 UTF-8 的字符集进行编码。

签名机制#

目前无

返回结果#

API请求返回以下结果
调用成功:
{
    "success": true,
    "data": {
        "userId": 0000000000000000000,
        "name": "usdt_money",
        "data": "0.02"
    },
    "errorCode": 0,
    "errorMsg": null,
    "errorData": null
}
调用失败:
{
    "success": false,
    "data": null,
    "errorCode": 140020,
    "errorMsg": "请求需要参数app-key",
    "errorData": null
}
字段类型是否一定返回说明
successBoolean是本次请求是否成功,未true代表服务端流程走完,没有异常;如果为false,则需要去看errorCode字段的错误码,根据此错误码业务上进行处理
errorCodeInt32是错误码,当success为true时,errorCode必为0;当success为false时,errorCode必非0
errorMsgString是错误消息,当success为true时,errorMsg为空字符串;当success为false时,errorMsg错误描述
errorDataObject否发生错误时的返回数据,此结构类型不定,根据各个接口返回不同的类型
errorCodeStrString否错误的英文简要描述,只有当success为false时, 才可能有非空字符串返回
dataObject否请求成功时返回的业务数据,结构根据每个接口不同

名词解释#

名字解释
服务域名我们提供服务的域名, 生产环境为https://openapi.cs2dt.com
app-key我方用来鉴权的密钥,代表您在我们平台的凭证,请妥善保存,泄漏后别人也可以使用这个密钥进行关键操作.
appIdSteam 官方对于游戏的唯一标识。DOTA2 -> 570,CSGO -> 730,TF2 -> 440,PayDay2->218620,CSOL -> 2504460

如何调试#

如何使用接口文档提供的调试功能
1.
选择任意接口,点击调试按钮
1.jpg
2.
第一次调试, 将引导您去设置环境变量, 目前需要设置的环境变量为app-key, 获取方式请参考前提条件章节
2.jpg
3.
填写您的 app-key
3.jpg
4.
设置之后点击发送即可获得响应参数
4.jpg
下一页
用户余额查询
Built with