/api/dlt/auth/send-code
累计调用 0 次
发送验证码
向手机号发送注册/登录验证码。
data 为代练通短信接口返回的原始 JSON 对象(原样透传),字段由上游定义。
代练通平台能力:验证码登录注册、用户资料、各游戏公开订单数统计、个人代练订单查询与操作(接收/删除)、图片上传。
/api/dlt/
代练通服务封装代练通平台的数据接口,覆盖验证码登录注册、用户资料与联系方式维护、头像与留言图片上传、各游戏的公开订单数统计,以及个人订单的查询与操作(接收、删除)。
调用链路上,登录成功后需携带返回的 user_id 与 token 继续调用后续接口;部分操作(如接收订单)还需额外的支付密码等信息,请按参数说明谨慎传参。
本服务需项目签名。接收、删除等接口会真实作用于第三方平台的订单数据,调试时请避免在正式环境误操作。
所有接口返回同一个 JSON 信封,业务数据都在 data 里:
{
"code": 10000,
"msg": "成功",
"data": { ... }
}
判断成功与否请看 code,不要依赖 HTTP 状态码。 查看完整错误码
本项目侧需项目签名;业务侧还需先登录代练通取得 user_id / token。含资金/接收订单等高风险操作,调试请务必使用自己的真实小号并谨慎操作。
/api/dlt/auth/send-code
累计调用 0 次
向手机号发送注册/登录验证码。
data 为代练通短信接口返回的原始 JSON 对象(原样透传),字段由上游定义。
/api/dlt/auth/register
累计调用 0 次
用手机号+验证码注册代练通账号。
data 为代练通注册接口返回的原始 JSON 对象(原样透传),字段由上游定义。
/api/dlt/auth/login
累计调用 0 次
验证码或密码登录,返回 user_id / token。
data 为代练通登录接口返回的原始 JSON 对象(原样透传),含上游下发的登录态信息,字段由上游定义。
/api/dlt/user/info
累计调用 0 次
按 user_id + token 查询代练通用户信息。
选填:平台用户 ID(登录/注册后返回);不传则用后台「账号管理」的默认代练通账号
选填:平台登录令牌(代练通登录后返回);不传则用后台「账号管理」的默认代练通账号
data 为代练通用户信息接口返回的原始 JSON 对象(原样透传),字段由上游定义。
/api/dlt/user/set-contact
累计调用 0 次
设置 QQ 或手机号联系方式。
必填:QQ 号或手机号
选填:平台用户 ID(登录/注册后返回);不传则用后台「账号管理」的默认代练通账号
选填:平台登录令牌(代练通登录后返回);不传则用后台「账号管理」的默认代练通账号
data 为代练通用户信息更新接口返回的原始 JSON 对象(原样透传),字段由上游定义。
/api/dlt/user/set-mysign
累计调用 0 次
设置个性签名(无需 token)。
选填:平台用户 ID(登录/注册后返回);不传则用后台「账号管理」的默认代练通账号
执行结果由外层 code / msg 表达;data 为 null,不含业务数据。
/api/dlt/user/change-password
累计调用 0 次
修改代练通登录密码(需登录上下文与旧密码)。
必填:旧密码(为空表示未设置过密码,传空字符串)
选填:平台用户 ID(登录/注册后返回);不传则用后台「账号管理」的默认代练通账号
必填:登录返回的 login_id
选填:平台登录令牌(代练通登录后返回);不传则用后台「账号管理」的默认代练通账号
data 为代练通改密接口返回的原始 JSON 对象(原样透传),字段由上游定义。
/api/dlt/user/sign-in
累计调用 0 次
每日签到领取代练币。
选填:平台用户 ID(登录/注册后返回);不传则用后台「账号管理」的默认代练通账号
data 为上游签到接口 Result1 字段的内容(原样透传),字段由上游定义。
/api/dlt/user/real-name-info
累计调用 0 次
查询账号实名认证信息。
选填:平台用户 ID(登录/注册后返回);不传则用后台「账号管理」的默认代练通账号
data 为上游实名认证接口 Result 字段的内容(数组或对象,原样透传),字段由上游定义。
/api/dlt/user/balance
累计调用 0 次
查询代练通账号可用余额(= 总资金 − 冻结资金)。
选填:平台用户 ID(登录/注册后返回);不传则用后台「账号管理」的默认代练通账号
选填:平台登录令牌(代练通登录后返回);不传则用后台「账号管理」的默认代练通账号
data 为余额对象(单位:元)。
| 字段 | 类型 | 说明 |
|---|---|---|
| available | float | 可用余额(= 总资金 − 冻结资金) |
| sum | float | 总资金 |
| freeze | float | 冻结资金 |
/api/dlt/games
累计调用 0 次
列出当前有公开订单的游戏及各自的订单数量(按订单数降序)。
data 为游戏数组,按订单数从多到少排序;仅包含当前有公开订单的游戏,由上游游戏清单与各游戏订单数合并而成。
| 字段 | 类型 | 说明 |
|---|---|---|
| game_id | int | 游戏ID |
| game_name | string | 游戏名称 |
| order_count | int | 当前可接的公开订单数量 |
/api/dlt/games/orders
累计调用 0 次
按游戏ID查询该游戏的公开订单列表:支持分页与区服/订单类型/段位/价格/仲裁介入/结算时间/排序/关键词(指定英雄)等筛选。
必填:游戏ID;可由「获取全部游戏」接口取到
从 1 开始,默认 1
1-100,默认 20
按游戏区服筛选;默认 0=全部
按订单玩法类型筛选;默认不限
按订单要求的初始段位筛选;默认不限
按订单的目标段位筛选;默认不限
格式「最低_最高」,如 1_20;默认不限。常用值:1_20 / 21_50 / 51_100 / 101_300 / 301_10000
只显示发单者仲裁介入率不超过该百分比的订单;默认 0=不限
只显示结算时间不超过该小时数的发单者订单;默认 0=不限
是否只返回本账号可接手的订单;默认 1=只看可接手
结果排序方式;默认按平台推荐排序
关键词筛选。对王者荣耀等游戏,「指定英雄」即在此填英雄名,多个英雄用空格分隔(如「澜 镜」)
代练通账号ID(登录后返回)。与 token 一起传时按登录态筛选;不传则用后台「账号管理」的默认代练通账号;都没有=匿名
代练通登录令牌,与 user_id 配对。不传则用后台默认账号的令牌;都没有=匿名(匿名下仅关键词与区服筛选生效)
data 为分页对象;上游一次性返回全部匹配订单,本接口按 page/page_size 切片分页。items 内每个订单字段见下表(由上游定义)。
| 字段 | 类型 | 说明 |
|---|---|---|
| items | array | 订单数组,每项字段见下方 items[].* |
| items[].SerialNo | string | 订单编号 |
| items[].Title | string | 订单标题(代练要求摘要) |
| items[].Price | float | 订单金额(元) |
| items[].Ensure | float | 总保证金(元) |
| items[].Ensure1 | float | 安全保证金(元) |
| items[].Ensure2 | float | 效率保证金(元) |
| items[].TimeLimit | int | 代练时限(小时) |
| items[].Game | string | 游戏名称 |
| items[].Zone | string | 大区(如 苹果QQ / 苹果WX) |
| items[].Server | string | 服务器(如 默认服) |
| items[].ZoneServerID | string | 区服ID |
| items[].Create | string | 发单者昵称 |
| items[].IsPub | int | 是否公开订单(1=公开) |
| items[].InGoodPrice | int | 是否优选(好价)订单(1=是) |
| items[].OrderType | int | 上游订单类型标识(0=普通 等,由上游定义) |
| items[].SameCity | string | 同城信息,无则为空 |
| items[].Stamp | int | 上游时间标记(本接口通常为 0) |
| items[].PriPartner | int | 上游合作商标记(由上游定义) |
| items[].IsShare | int | 上游分享标记(由上游定义) |
| total | int | 筛选后的订单总数 |
| page | int | 当前页码 |
| page_size | int | 每页数量 |
| total_pages | int | 总页数 |
/api/dlt/search/orders
累计调用 0 次
按关键词搜索订单(如「马可波罗」「安琪拉」);参数对齐官网搜索页,上游大部分字段都可自定义。
必填:游戏ID;可由「获取全部游戏」取到
搜索关键词,如「马可波罗」「安琪拉」「巅峰赛」「五排」
上游订单池标识 IsPub;默认 9(对齐官网搜索页)
按区服筛选;官网搜索页默认 2=苹果
上游大区ID ZoneID,默认 0
上游服务器ID ServerID,默认 0
上游 LevelType2(订单玩法类型);默认不限
初始段位 STier;默认不限
目标段位 ETier;默认不限
格式「最低_最高」,如 1_20;默认不限
只显示发单者仲裁介入率不超过该百分比的订单;默认 0=不限
只显示结算时间不超过该小时数的发单者订单;默认 0=不限
1=只看本账号可接手的订单;官网搜索页默认 0
结果排序方式;默认按平台推荐排序
上游 Focused,默认 -1
上游 OrderType(与「订单类型 LevelType2」不同),默认 0
上游 PubRecommend,默认 0
上游评分筛选位 Score1,默认 0
上游评分筛选位 Score2,默认 0
从 1 开始,默认 1
1-100,默认 20
选填:平台用户 ID(登录/注册后返回);不传则用后台「账号管理」的默认代练通账号
选填:平台登录令牌(代练通登录后返回);不传则用后台「账号管理」的默认代练通账号
data 为分页对象;上游一次性返回全部匹配订单,本接口按 page/page_size 切片分页。默认口径对齐官网「搜索」页(优选订单池 IsPub=9)。
| 字段 | 类型 | 说明 |
|---|---|---|
| items | array | 订单数组,每项字段见下方 items[].* |
| items[].SerialNo | string | 订单编号 |
| items[].Title | string | 订单标题(代练要求摘要) |
| items[].Price | float | 订单金额(元) |
| items[].Ensure | float | 总保证金(元) |
| items[].Ensure1 | float | 安全保证金(元) |
| items[].Ensure2 | float | 效率保证金(元) |
| items[].TimeLimit | int | 代练时限(小时) |
| items[].Game | string | 游戏名称 |
| items[].Zone | string | 大区(如 苹果QQ / 苹果WX) |
| items[].Server | string | 服务器(如 默认服) |
| items[].ZoneServerID | string | 区服ID |
| items[].Create | string | 发单者昵称 |
| items[].IsPub | int | 是否公开订单(1=公开) |
| items[].InGoodPrice | int | 是否优选(好价)订单(1=是) |
| items[].OrderType | int | 上游订单类型标识(0=普通 等,由上游定义) |
| items[].SameCity | string | 同城信息,无则为空 |
| items[].Stamp | int | 上游时间标记(本接口通常为 0) |
| items[].PriPartner | int | 上游合作商标记(由上游定义) |
| items[].IsShare | int | 上游分享标记(由上游定义) |
| total | int | 筛选后的订单总数 |
| page | int | 当前页码 |
| page_size | int | 每页数量 |
| total_pages | int | 总页数 |
/api/dlt/search/hot-words
累计调用 0 次
获取某游戏的热门搜索词(官网搜索页的推荐词)。
必填:游戏ID
data 为 {words, tip}:words 为热门搜索词数组,tip 为一句说明文字。
| 字段 | 类型 | 说明 |
|---|---|---|
| words | array | 热门搜索词数组 |
| tip | string | 说明文字 |
/api/dlt/orders/receive
累计调用 0 次
接收(抢)一笔订单,需支付密码与 uid。
选填:平台登录令牌(代练通登录后返回);不传则用后台「账号管理」的默认代练通账号
选填:平台用户 ID(登录/注册后返回);不传则用后台「账号管理」的默认代练通账号
data 为代练通接收订单接口返回的原始 JSON 对象(原样透传),字段由上游定义。
/api/dlt/orders/receive-default
累计调用 0 次
接收(抢)一笔订单;免传支付密码与 UID,直接用后台默认代练通账号凭据。
data 为代练通接收订单接口返回的原始 JSON 对象(原样透传),字段由上游定义。
/api/dlt/orders/publish
累计调用 0 次
发布代练订单(自定义发布):填订单信息与游戏账号,服务端按官网发单参数提交。
当前已支持:王者荣耀 / 三角洲行动;选完会自动刷新该游戏的大区
如 安卓QQ / 苹果微信 / 官服;选完会自动刷新出该大区下的区服
游戏+大区+服务器(上游 ZoneServerID);一般留空由「游戏+大区」自动定位
必填:订单标题(建议含「指定单」字样)
必填:订单价格
必填:代练时限(小时)。默认用「时间表」下拉(2~24 小时,再接 48/72);需要特殊时长可切到「手动输入」自行填写,最低 2 小时
安全保证金(元),默认 0
效率保证金(元),默认 0
必填:号主联系方式
发单者联系方式(可选)
发单者 QQ(可选)
仅王者荣耀需要:铭文等级(如 150),默认 150;其它游戏没有该项,切到别的游戏会自动隐藏
必填:写入订单详情;建议写明「指定单,私接扣除全部保证金」等规则
支付密码(原密码);需要支付时填,服务端按 md5(md5(pwd)+uid) 处理
仅王者荣耀有(上游 OrderType:0=普通 / 1=全胜 / 2=限时);三角洲行动没有该项,切过去会自动隐藏
上游 Insurance(保险设置),默认 0
USR 开头(支付密码哈希用);不传则用后台默认账号
选填:平台用户 ID(登录/注册后返回);不传则用后台「账号管理」的默认代练通账号
选填:平台登录令牌(代练通登录后返回);不传则用后台「账号管理」的默认代练通账号
data 为上游 LevelOrderAdd 的返回(原样透传),字段由上游定义。
/api/dlt/orders/apply-cancel
累计调用 0 次
撤销订单(发单者不想让打手继续代练):按官网「申请撤销」提交撤销意愿、账号进度、补充描述与凭证图片(上游 LevelOrderCancel)。
必填:订单编号(上游 ODSerialNo,如 10717695025313439830)
必填:支付密码(原密码);服务端按 md5(md5(pwd)+uid) 处理
必填:账号 UID(USR 开头,如 USR2025112802644);支付密码哈希用
上游 Flag:0=申请撤销(默认)/ 1=取消撤销 / 2=同意撤销(对方申请后)/ 3=申请平台介入
撤销意愿(写入撤销说明):0=我愿意支付代练费(金额取 pay_level_bal)/ 1=我要求赔偿保证金(金额取 rep_ensure_bal)/ 2=仅要求退款(默认)
账号进度情况(写入撤销说明):有进度 / 无进度(默认)/ 负进度 / 未开始代练
补充描述(写入撤销说明,建议写清撤销原因,便于协商/仲裁)
撤销意愿=0(我愿意支付代练费)时下发的金额(元),默认 0
撤销意愿=1(我要求赔偿保证金)时下发的金额(元),默认 0
上游 RevokePrice(预计撤销金额,元),默认 0
可选:撤销凭证图片地址(先上传到图床再填 URL);撤销成功后自动以「撤销」留言上传
选填:平台用户 ID(登录/注册后返回);不传则用后台「账号管理」的默认代练通账号
选填:平台登录令牌(代练通登录后返回);不传则用后台「账号管理」的默认代练通账号
data 为上游 LevelOrderCancel 的返回(原样透传),字段由上游定义。
/api/dlt/orders/handle-cancel
累计调用 0 次
订单「撤销详情」页的处置动作:同意撤销 / 取消撤销 / 申请平台介入(接单者或发单者均可调用,按登录账号身份判定)。
必填:订单编号(上游 ODSerialNo)
页面「撤销详情」的处置方式,默认 同意撤销
agree / cancel 必填;arbitration 不需要。服务端按 md5(md5(pwd)+uid) 处理
agree / cancel 必填:账号 UID(USR 开头,如 USR2025111906640);支付密码哈希用
同意撤销时下发的支付代练费金额(元),默认 0;一般取对方申请时的金额
同意撤销时下发的赔偿保证金金额(元),默认 0;一般取对方申请时的金额
可选:撤销说明(上游 Comment),默认空
可选:凭证图片地址(先上传到图床再填 URL);操作成功后自动以「撤销」留言上传
选填:平台用户 ID(登录/注册后返回);不传则用后台「账号管理」的默认代练通账号
选填:平台登录令牌(代练通登录后返回);不传则用后台「账号管理」的默认代练通账号
data 为上游 LevelOrderCancel / LevelOrderRequestArbitration 的返回(原样透传),字段由上游定义。
/api/dlt/orders/delete
累计调用 0 次
删除自己的订单(默认原因“不用了”)。
选填:平台登录令牌(代练通登录后返回);不传则用后台「账号管理」的默认代练通账号
选填:平台用户 ID(登录/注册后返回);不传则用后台「账号管理」的默认代练通账号
data 为代练通删除订单接口返回的原始 JSON 对象(原样透传),字段由上游定义。
/api/dlt/orders/my
累计调用 0 次
查询我发布的 / 我接的订单,支持订单范围、进度、状态、游戏、关键词等筛选(服务端分页)。
选填:平台用户 ID(登录/注册后返回);不传则用后台「账号管理」的默认代练通账号
选填:平台登录令牌(代练通登录后返回);不传则用后台「账号管理」的默认代练通账号
查我发布还是我接的订单
进行中 / 已完成
上游订单状态位;0=不限(默认),具体取值由上游定义
上游撤单状态位;0=不限(默认),具体取值由上游定义
按游戏筛选;0=全部(默认)
按关键词筛选,默认空
按号主联系方式筛选,默认空
1=含托管(默认) / 0=不含
中文名一键筛选常用状态;等价于设置 status/cancel_status/over_days,显式传这三者时以其为准。对应上游:待付款=Status19、未接手=11、正在代练=12、等待验收=13、订单异常=14、锁定订单=15、申请撤销中=Status16+Cancel11、仲裁介入中=Cancel14、协商已处理=Cancel12、仲裁已处理=Cancel15、客服强制撤销=Cancel16、已结算=Status17;其中协商/仲裁/客服强制撤销/已结算 按已结束(OverDays=99),其余按进行中(OverDays=-99)
从 1 开始,默认 1
1-100,默认 20
data 为分页对象(上游服务端分页):items(订单数组,字段由上游定义,含 Status / CancelStatus / AcceptCount / LevelType2 等)/ total / page / page_size / total_pages。
| 字段 | 类型 | 说明 |
|---|---|---|
| items | array | 订单数组(字段由上游定义) |
| items[].SerialNo | string | 订单编号 |
| items[].Title | string | 订单标题 |
| items[].Status | int | 订单状态位(取值由上游定义) |
| items[].CancelStatus | int | 撤单状态位(取值由上游定义) |
| items[].Price | float | 订单金额(元) |
| items[].CreateDate | string | 发单时间 |
| items[].Game | string | 游戏名称 |
| items[].AcceptCount | string | 接单人数 |
| total | int | 订单总数 |
| page | int | 当前页码 |
| page_size | int | 每页数量 |
| total_pages | int | 总页数 |
/api/dlt/orders/detail
累计调用 0 次
按订单号获取订单详情(原样透传上游订单对象)。
0=接单方(默认,可取号主账号)/ 1=公开(取订单状态)
选填:平台用户 ID(登录/注册后返回);不传则用后台「账号管理」的默认代练通账号
选填:平台登录令牌(代练通登录后返回);不传则用后台「账号管理」的默认代练通账号
data 为上游订单详情对象(原样透传),字段由上游定义。
/api/dlt/orders/owner-info
累计调用 0 次
获取订单的号主信息(游戏名称 / 客户端 / 游戏账号 / 密码 / 角色名 / 号主联系方式 / 剩余时间)。
必填:订单号(SerialNo)
选填:平台用户 ID(登录/注册后返回);不传则用后台「账号管理」的默认代练通账号
选填:平台登录令牌(代练通登录后返回);不传则用后台「账号管理」的默认代练通账号
data 为号主信息对象(中文键)。
| 字段 | 类型 | 说明 |
|---|---|---|
| 游戏名称 | string | 游戏名称(如 王者荣耀) |
| 客户端 | string | 客户端 / 大区(如 安卓QQ、苹果微信) |
| 游戏账号 | string | 号主的游戏账号 |
| 密码 | string | 号主的游戏密码 |
| 角色名 | string | 游戏角色名 |
| 号主联系方式 | string | 号主联系方式(手机号) |
| 剩余时间 | string | 订单剩余时间 |
/api/dlt/orders/upload-image
累计调用 0 次
向订单留言上传图片(传图片 URL/路径)。
选填:平台登录令牌(代练通登录后返回);不传则用后台「账号管理」的默认代练通账号
选填:平台用户 ID(登录/注册后返回);不传则用后台「账号管理」的默认代练通账号
data 为代练通订单留言接口返回的原始 JSON 对象(原样透传),字段由上游定义。
/api/dlt/orders/upload-first-image
累计调用 0 次
上传订单首图(接单后须在规定时间内上传;王者荣耀一般 2 张:好友天梯图 + 物品图)。
必填:可访问的 http/https 图片链接(王者荣耀=好友天梯图)
选填:可访问的 http/https 图片链接(王者荣耀=物品图)
选填:平台用户 ID(登录/注册后返回);不传则用后台「账号管理」的默认代练通账号
选填:平台登录令牌(代练通登录后返回);不传则用后台「账号管理」的默认代练通账号
data 含 images(已成功挂到订单上的图片地址)与 results(每张挂单的上游返回)。
/api/dlt/orders/upload-end-image
累计调用 0 次
上传订单完单图并申请完单(接单方上传完成凭证后,订单进入「等待验收」)。
必填:可访问的 http/https 图片链接
选填:可访问的 http/https 图片链接
选填:平台用户 ID(登录/注册后返回);不传则用后台「账号管理」的默认代练通账号
选填:平台登录令牌(代练通登录后返回);不传则用后台「账号管理」的默认代练通账号
data 含 images(已成功挂到订单上的图片地址)、results(每张挂单的上游返回)与 over(申请完单的上游返回)。
/api/dlt/avatar/upload
累计调用 0 次
上传代练通头像(传图片 URL/路径,无需 token)。
选填:平台用户 ID(登录/注册后返回);不传则用后台「账号管理」的默认代练通账号
执行结果由外层 code / msg 表达;data 为 null,不含业务数据。