token有效性验证接口文档

说明： 本接口用于验证 步数助手要用的 Token 是否有效，免费，可随时调用。

基础信息

请求参数

参数名 类型 必填 说明
token string 是 token

请求示例

1. GET 请求

GET https://apiv1.yrain.top/sport/token.php?token=xxxxxxxxxxxxxxxx

2. POST 表单请求

POST https://apiv1.yrain.top/sport/token.php 
Content-Type: application/x-www-form-urlencoded

token=xxxxxxxxxxxxxxxx

3. POST JSON 请求

POST https://apiv1.yrain.top/sport/token.php 
Content-Type: application/json

{
    "token": "xxxxxxxxxxxxxxxx"
}

4. 通过请求头传递

GET https://apiv1.yrain.top/sport/token.php 
apptoken: xxxxxxxxxxxxxxxx

响应示例

1. Token 有效

{
    "code": 200,
    "msg": "token有效",
    "valid": true
}

2. Token 无效

{
    "code": 401,
    "msg": "token无效",
    "valid": false
}

3. 无法判断（网络异常）

{
    "code": 200,
    "msg": "无法判断（网络异常）",
    "valid": null
}

4. 缺少 token 参数

{
    "code": 400,
    "msg": "缺少token参数",
    "valid": false
}

5. 校验异常

{
    "code": 500,
    "msg": "网络请求失败: xxxx",
    "valid": null
}

状态码说明

状态码 valid 说明
200 true Token 有效
200 null 网络异常，暂时无法判断（可重试）
400 false 缺少 token 参数
401 false Token 无效
500 null 服务器内部错误或网络异常

返回字段说明

字段 类型 说明
code integer 状态码，200=成功，400=参数缺失，401=token无效，500=异常
msg string 描述
valid boolean / null token 是否有效：true=有效，false=无效，null=无法判断

使用限制

注意事项

技术支持

如有问题请联系: Q:zcsky122

版本信息