优步 API 文档

概述

优步 API 是一套完全独立部署的 Zepp Life（原华米）刷步接口，无需依赖任何第三方服务。

刷步提交

支持指定步数/随机步数

批量刷步

多账号并发执行

绑定检测

微信/支付宝/手环

虚拟手环

自动绑定虚拟设备

API Key

多用户计费管理

Token缓存

智能缓存减少登录

Base URL：http://api.doubaoy.cn

响应格式：JSON

认证方式

所有接口均需认证，支持以下两种方式（二选一）：

方式一：API Token（管理员）

在请求头中携带 Authorization：

Authorization: Bearer <your-api-token>

方式二：API Key（第三方用户）

在请求参数中携带 apikey：

{
  "username": "xxx@qq.com",
  "password": "xxx",
  "apikey": "your-api-key"
}

API Key 由管理员在后台创建，每次请求扣除对应余额

GET 刷步 / 仅登录

/api/step

通过 GET 方式提交请求。传 step 时执行刷步，不传 step 时仅登录并在服务端缓存 token。

请求参数

参数名	类型	必填	说明
`username`	string	必填	Zepp Life 账号（手机号/邮箱）
`password`	string	必填	Zepp Life 密码
`step`	string	选填	步数（1-99999），传入则执行刷步，不传则仅登录并在服务端缓存 token
`apikey`	string	选填	API Key（不传则需 Header 认证）
`display_name`	string	选填	自定义虚拟设备名称

请求示例

GET /api/step?username=xxx@qq.com&password=xxx&step=20000&apikey=your-key

GET /api/step?username=xxx@qq.com&password=xxx&apikey=your-key

响应示例

{
  "code": 200,
  "time": "2026-05-08 09:00:00",
  "user": "xxx****.com",
  "step": 20000,
  "status": "success",
  "msg": "修改步数（20000）[success]",
  "wechat_bound": true,
  "alipay_bound": false,
  "band_bound": true
}

POST 刷步 / 随机步数 / 仅登录

/api/step

通过 POST 方式提交请求。传 step 时执行指定步数刷步；传 min_step/max_step 时执行随机刷步；三者都不传时仅登录并在服务端缓存 token。

请求参数

参数名	类型	必填	说明
`username`	string	必填	Zepp Life 账号（手机号/邮箱），别名 `user`
`password`	string	必填	Zepp Life 密码，别名 `pwd`
`step`	int	选填	指定步数（1-99999），传入则执行指定步数刷步
`min_step`	int	选填	随机步数最小值，需与 `max_step` 配合使用
`max_step`	int	选填	随机步数最大值，需与 `min_step` 配合使用
`apikey`	string	选填	API Key，别名 `api_key`
`display_name`	string	选填	自定义虚拟设备名称

请求示例

{
  "username": "xxx@qq.com",
  "password": "xxx",
  "min_step": 18000,
  "max_step": 25000,
  "apikey": "your-api-key"
}

{
  "username": "xxx@qq.com",
  "password": "xxx",
  "apikey": "your-api-key"
}

响应参数

参数名	类型	说明
`code`	int	响应码，200=成功
`time`	string	服务器时间
`user`	string	脱敏用户名
`step`	int	实际提交步数，仅刷步模式返回
`status`	string	success / error / failed
`msg`	string	详细结果信息
`wechat_bound`	bool/null	微信运动绑定状态（true=已绑定, false=未绑定, null=未知）
`alipay_bound`	bool/null	支付宝运动绑定状态
`band_bound`	bool	虚拟手环绑定状态
`wechat_qr`	string/null	微信绑定二维码链接（仅微信未绑定时返回）

POST 批量刷步

/api/step/batch

对多个账号并发执行刷步任务，支持指定账号或全部启用账号。

请求参数

参数名	类型	必填	说明
`apikey`	string	选填	API Key（不传则需 Header 认证）
`account_ids`	array	选填	指定账号 ID 列表，为空则全部启用账号
`min_step`	int	选填	覆盖最小步数
`max_step`	int	选填	覆盖最大步数

请求示例

{
  "account_ids": [1, 2, 3],
  "min_step": 20000,
  "max_step": 28000
}

响应示例

{
  "code": 0,
  "message": "已提交 3 个任务",
  "data": {
    "task_ids": [101, 102, 103],
    "count": 3
  }
}

GET POST 绑定检测

/api/bindcheck

检测账号的微信运动、支付宝运动、虚拟手环绑定状态。若微信未绑定，返回绑定二维码链接。

请求参数

参数名	类型	必填	说明
`username`	string	必填	Zepp Life 账号，别名 `user`
`password`	string	必填	Zepp Life 密码，别名 `pwd`
`apikey`	string	选填	API Key，别名 `api_key`

响应参数

参数名	类型	说明
`code`	int	0=成功
`userid`	string	华米用户 ID
`wechat_bound`	bool/null	微信运动绑定状态
`alipay_bound`	bool/null	支付宝运动绑定状态
`band_bound`	bool	虚拟手环绑定状态
`wechat_qr`	string/null	微信绑定二维码链接（仅微信未绑定时返回）
`wechat_status`	string	已绑定 / 未绑定 / 未知
`alipay_status`	string	已绑定 / 未绑定 / 未知
`band_status`	string	已绑定 / 未绑定
`account_info`	object	账号信息（nickname, email, third_id）

响应示例

{
  "code": 0,
  "time": "2026-05-08 09:00:00",
  "user": "xxx****.com",
  "userid": "1198348613",
  "wechat_bound": true,
  "alipay_bound": false,
  "band_bound": true,
  "wechat_qr": null,
  "wechat_status": "已绑定",
  "alipay_status": "未绑定",
  "band_status": "已绑定",
  "account_info": {}
}

GET 任务查询

/api/task/{task_id}

查询单个批量任务的执行状态。

路径参数

参数名	类型	说明
`task_id`	int	任务 ID（批量刷步返回的 task_ids 中的值）

响应示例

{
  "code": 0,
  "data": {
    "id": 101,
    "account_user": "xxx@qq.com",
    "step": 0,
    "status": "success",
    "result": "修改步数（22156）[success]",
    "created_at": "2026-05-08 09:00:00",
    "finished_at": "2026-05-08 09:00:05"
  }
}

GET 任务列表

/api/tasks

分页查询任务列表，支持按状态筛选。

请求参数

参数名	类型	必填	说明
`page`	int	选填	页码，默认 1
`per_page`	int	选填	每页条数，默认 20
`status`	string	选填	状态筛选：pending / running / success / failed

响应示例

{
  "code": 0,
  "data": {
    "tasks": [...],
    "total": 50,
    "page": 1,
    "per_page": 20
  }
}

GET 健康检查

/api/health

检查服务运行状态，无需认证。

响应示例

{
  "code": 0,
  "data": {
    "status": "ok",
    "uptime": "2d 5h 30m",
    "version": "1.0.0"
  }
}

错误码说明

HTTP 状态码	code	说明
200	200	刷步成功
400	400	请求参数错误（缺少用户名/密码/步数等）
401	401	认证失败（API Token 或 API Key 无效）
402	402	API Key 余额不足
429	429	请求过于频繁，请稍后重试
500	500	服务器内部错误（登录失败、Token 失效等）
503	503	服务暂不可用（并发锁等待超时）

刷步失败常见原因

msg 内容	原因	解决方式
账号或密码错误	Zepp Life 账号密码不正确	检查账号密码
请求过于频繁	华米 API 限流（429）	等待后重试或启用代理
Token已失效	缓存的 Token 过期且刷新失败	系统自动重新登录
登陆失败	登录过程异常	检查网络或账号状态