Token获取接口文档

说明： 本接口用于获取登录 Token 及其设备信息用于步数助手。

基础信息

请求参数

参数名 类型 必填 说明
apikey string 是 付费密钥，套餐见下方价格表
user string 是 账号（手机号 / 邮箱）
pass string 是 账号密码
force string 否 传 force=1 强制刷新，跳过缓存重新登录（会扣费）
提示： 不带 force=1 时优先读取缓存；命中缓存不扣费，未命中缓存会走真实登录并扣费。

请求示例

1. 获取 Token（优先走缓存）

GET https://apiv1.yrain.top/sport/api.php?apikey=您的密钥&user=your_account@qq.com&pass=your_password

2. 强制刷新 Token（跳过缓存）

GET https://apiv1.yrain.top/sport/api.php?apikey=您的密钥&user=your_account@qq.com&pass=your_password&force=1

响应示例

成功响应（缓存获取）

{
    "code": 200,
    "msg": "缓存获取数据成功",
    "token": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "userid": "1234567890",
    "device_id": "abcdef1234567890",
    "device_mac": "AA:BB:CC:DD:EE:FF",
    "time": "2026-09-26 15:12:00"
}

成功响应（登录获取）

{
    "code": 200,
    "msg": "登录获取数据成功",
    "token": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "userid": "1234567890",
    "device_id": "abcdef1234567890",
    "device_mac": "AA:BB:CC:DD:EE:FF",
    "time": "2026-09-26 12:00:00"
}

错误响应

{
    "code": 401,
    "msg": "缺少apikey参数",
    "time": "2026-09-26 12:00:00"
}
        
{
    "code": 400,
    "msg": "缺少user和pass参数",
    "time": "2026-09-26 12:00:00"
}
        
{
    "code": 403,
    "msg": "密钥不存在",
    "time": "2026-09-26 12:00:00"
}
        
{
    "code": 403,
    "msg": "密钥次数已用完",
    "time": "2026-09-26 12:00:00"
}
        
{
    "code": 403,
    "msg": "密钥已过期",
    "time": "2026-09-26 12:00:00"
}
        
{
    "code": 401,
    "msg": "账号或密码错误",
    "time": "2026-09-26 12:00:00"
}
        
{
    "code": 500,
    "msg": "服务器繁忙，请稍后重试",
    "time": "2026-09-26 12:00:00"
}

套餐价格表

说明： 以下为付费密钥套餐，购买后获得对应请求次数。缓存命中不扣费，真实登录每次扣 1 次。
套餐 价格 次数
试验包 1元 500次
体验包 20 元 18,888 次
小包 35 元 34,000 次
中包 50 元 50,000 次
大包 69.99 元 72,000 次
超值包 99.99 元 110,000 次

扣费规则

）
场景 是否扣费
缓存命中（直接返回 token） 否
缓存缺设备，补设备成功 否
缓存未命中，登录成功 是（扣 1 次）
缓存未命中，登录失败（用户名或密码错误 是（扣 1 次）
apikey 无效 / 过期 / 次数用完 否

状态码说明

状态码 说明
200 请求成功
400 参数错误或缺失
401 缺少 apikey，或账号密码错误
403 密钥验证失败（不存在 / 次数用完 / 已过期）
500 服务器内部错误或网络异常

返回字段说明

字段 类型 说明
code integer 状态码
msg string 提示信息
token string 登录 Token
userid string 用户 ID
device_id string 设备 ID
device_mac string 设备 MAC 地址
time string 服务器返回时间

使用限制

注意事项

技术支持

如有问题请联系: Q:zcsky122

版本信息