同步助手 API,支持步数修改与同步,适配 QQ、微信、支付宝平台,GET 请求、简单调用、高频稳定,快速自定义运动步数。
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| key | string | 是 | 接口调用密钥 | |
| user | string | 是 | 邮箱 | |
| pass | string | 是 | 密码 | |
| steps | string | 是 | 步数 |
[
{
"name": "key",
"type": "string",
"required": true,
"description": "接口调用密钥",
"example": ""
},
{
"name": "user",
"type": "string",
"required": true,
"description": "邮箱",
"example": ""
},
{
"name": "pass",
"type": "string",
"required": true,
"description": "密码",
"example": ""
},
{
"name": "steps",
"type": "string",
"required": true,
"description": "步数",
"example": ""
}
]
{
"openapi": "3.1.1",
"info": {
"title": "步数同步助手",
"description": "同步助手 API,支持步数修改与同步,适配 QQ、微信、支付宝平台,GET 请求、简单调用、高频稳定,快速自定义运动步数。",
"version": "1.0.0"
},
"paths": {
"\/apis\/sync": {
"get": {
"summary": "步数同步助手",
"description": "同步助手 API,支持步数修改与同步,适配 QQ、微信、支付宝平台,GET 请求、简单调用、高频稳定,快速自定义运动步数。",
"parameters": [
{
"name": "key",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "接口调用密钥"
},
{
"name": "user",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "邮箱"
},
{
"name": "pass",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "密码"
},
{
"name": "steps",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "步数"
}
],
"responses": {
"200": {
"description": "成功",
"content": {
"application\/json": {
"schema": {
"type": "object"
}
}
}
}
}
}
}
},
"servers": [
{
"url": "http:\/\/api.tmini.net",
"description": "当前访问入口(http)"
}
]
}
{
"code": 200,
"msg": "步数修改成功!",
"time": "2026-10-09 06:23:00",
"data": {
"user": "myiya@qq.com",
"steps": 23442,
"user_id": "",
"device_id": "add8f478ab585b08215be0f7af0df835"
},
"cached_time": "2026-10-09 06:23:00"
}
步数同步助手用于修改并同步运动步数,可对接 QQ、微信、支付宝等常见运动步数平台。通过简单的 GET 请求即可完成调用,适合需要快速自定义步数的用户与开发者使用。接口稳定、响应迅速,可满足高频调用场景。
https://api.tmini.net/apis/sync
GET
本接口必须携带密钥方可调用,通过 Query 参数传递:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | string | 是 | 接口调用密钥 |
密钥需拼接在请求地址的查询字符串中,形如 https://api.tmini.net/apis/sync?key=你的密钥。缺少或填写错误的密钥将无法完成调用。
请求方式为 GET,密钥通过 Query 参数 key=… 传递,即以 ?key=你的密钥 的形式附加在调用地址后。其余参数同样以 Query 形式传递。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | string | 是 | 接口调用密钥,通过 Query 传递 |
| user | string | 是 | 平台账号邮箱 |
| pass | string | 是 | 平台账号密码 |
| steps | string | 是 | 需要同步的步数 |
参数取值说明:
key:仅需在 Query 中以 key=… 形式传入一次,缺失或有误将无法调用接口。user:填写目标平台账号对应的邮箱,需与注册信息一致。pass:填写该账号的登录密码,需与账号匹配,否则同步无法完成。steps:填写要同步的步数值,为非负整数形式的字符串,步数上限受对应平台的展示规则约束。{
"code": 200,
"msg": "步数修改成功!",
"time": "2026-10-09 06:23:00",
"data": {
"user": "myiya@qq.com",
"steps": 23442,
"user_id": "",
"device_id": "add8f478ab585b08215be0f7af0df835"
},
"cached_time": "2026-10-09 06:23:00"
}
| 字段 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码,200 表示同步成功 |
| msg | string | 结果提示信息 |
| time | string | 服务器处理时间(北京时间,格式:YYYY-MM-DD HH:mm:ss) |
| data | object | 同步结果详情对象 |
| data.user | string | 同步的账号(邮箱) |
| data.steps | int | 同步完成后的步数 |
| data.user_id | string | 平台返回的用户标识,可能为空字符串 |
| data.device_id | string | 本次同步使用的设备标识 |
| cached_time | string | 结果生成时间(格式:YYYY-MM-DD HH:mm:ss) |
调用失败时返回如下结构,code 为 0 表示请求未成功,errcode 为具体业务错误码,msg 为可读的错误描述:
{
"code": 0,
"msg": "未提供调用密钥",
"errcode": 11001
}
积分余额不足时的返回示例:
{
"code": 0,
"msg": "积分余额不足",
"errcode": 11004
}
| errcode | 含义 |
|---|---|
| 11001 | 未提供调用密钥 |
| 11002 | 密钥错误 |
| 11003 | 密钥已禁用 |
| 11004 | 积分余额不足 |
| 11005 | 请求过于频繁(QPM 限制) |
| 11006 | 接口维护中 |
| 11007 | 接口已禁用 |
| 11008 | 接口不可用 |
| 11009 | 密钥校验暂不可用 |
| 11010 | 积分系统暂不可用 |
| 11011 | 收费接口须提供有效密钥 |
| 11012 | 鉴权方式错误 |
| 11013 | 接口不存在 |
| 11014 | ***地址无效 |
| 11015 | ***地址不允许 |
| 11016 | ***请求失败 |
| 11017 | 服务暂不可用 |
| 11018 | 请求方式不允许 |
| 11019 | 当前IP不在白名单内 |
| 11020 | 启用出口代理须提供有效密钥 |
| 11021 | 未配置可用出口代理 |
| 11022 | 出口代理不可用 |
| 11023 | 密钥已过期 |
| 11024 | 令牌分配积分不足 |
说明:
curl "https://api.tmini.net/apis/sync?key=你的密钥&user=myiya@qq.com&pass=账户密码&steps=23442"
// PHP 示例
$query = http_build_query([
'key' => '你的密钥',
'user' => 'myiya@qq.com',
'pass' => '账户密码',
'steps' => '23442',
]);
$response = file_get_contents('https://api.tmini.net/apis/sync?' . $query);
if ($response === false) {
exit("请求失败\n");
}
$result = json_decode($response, true);
echo $result['msg'], PHP_EOL;
echo $result['data']['steps'], PHP_EOL;
密钥安全保管:key 仅通过 Query 参数 key=… 传递,属于敏感凭证。请保存在服务端配置或环境变量中,严禁硬编码进前端页面、小程序包、App 客户端代码或公开代码仓库。凡是在浏览器、客户端可被查看到的请求地址,都会导致密钥泄露。
走服务端转发调用:本接口需要密钥且按次计费,建议由你自己的后端发起 GET 请求后再把结果返回给前端,避免密钥与账号口令暴露在终端用户侧。
账号凭证保护:user、pass 为运动平台的登录邮箱与密码,属于高敏感信息。请勿在日志、错误信息、埋点上报中明文记录或打印这两个参数,传输务必使用 HTTPS,避免明文链路被截获。
参数取值注意:四个参数均为必填,缺一将无法完成调用。steps 虽为字符串类型,但需填写合法的步数数值,请勿携带空格、小数点、非数字字符或超长内容;user 需为完整邮箱格式,pass 请原样传入,不要做额外的编码改写。
频率与用量控制:本服务为收费接口,按调用计费。请在业务侧设置合理的调用间隔与每日上限,避免短时间高频重试造成费用异常;网络超时后请采用指数退避重试,不要并发无节制刷新。
以返回状态判断结果:每次调用请先检查返回中的 code 与 msg,确认为成功后再使用 data 中的 steps、user_id、device_id 等字段,不要仅凭 HTTP 状态码判定业务成功。
时间字段说明:返回中的 time 与 cached_time 为服务端记录的时间,可用于核对同步记录;如需长期留存,请在你自己的系统中另行保存调用结果。
协议要求:调用地址请原样使用 https://api.tmini.net/apis/sync,保持 HTTPS 访问,不要降级为 HTTP,也不要自行拼写或替换域名。
curl -G "https://api.tmini.net/apis/sync" \
--data-urlencode "key=YOUR_API_KEY" \
--data-urlencode "user=myiya@qq.com" \
--data-urlencode "pass=123456" \
--data-urlencode "steps=8888"
# 换成自己的邮箱、密码与目标步数即可