← 返回工具箱首页

API 接口文档

工具箱 App 后端接口 · 全部 HTTPS · 带「试一下」的可直接在线调用

GET/?a=ping

延迟测试。返回 204 无内容,App 端通过计时得到 RTT。

GET/?a=speed&mb=10

下载测速。输出随机字节流(不可被压缩),mb 参数 1-50,Content-Length 精确等于 mb×1048576 字节。

不提供在线试(避免浪费流量),App 内网速测试即调用此接口。

POST/?a=upload

上传测速。请求体为任意字节,返回服务端实际接收的字节数。

HTTP 200
{"code":0,"received":4194304}

GET/?a=ip

返回请求方出口 IP 与归属地(服务端缓存 1 小时)。

{
  "code": 0,
  "ip": "154.219.117.200",
  "country": "香港",
  "region": "Kowloon",
  "city": "香港",
  "isp": "cognetcloud INC"
}

GET/?a=config

版本 / 公告 / APK 地址下发。App「检查更新」调用,后台「网站设置」可改。

POST/?a=short_create

生成短链接。请求体 JSON {"url":"https://..."},同链接自动复用已有短码,同 IP 每分钟限 10 条。

HTTP 200
{"code":0,"code_id":"c50IVB","short":"https://djyao.cn/s/c50IVB"}

302/s/{code}

短链跳转。命中则 302 到目标 URL 并计数,未命中返回 404。

示例:djyao.cn/s/daoue → daoue.com

POST/?a=speed_log

测速结果上报。请求体 JSON {"down":238.6,"up":56.2},后台「测速日志」可见。

HTTP 200
{"code":0}