接口文档 - API密钥管理系统

密钥验证接口

GET/POST api.php?action=verify&api_key=YOUR_KEY

验证API密钥是否有效，返回密钥信息和剩余天数

参数	类型	必填	说明
action	string	是	固定值 verify
api_key	string	是	API密钥

成功响应：

{
  "code": 200,
  "msg": "验证成功",
  "data": {
    "api_key": "Gui-02b349a5...",
    "email": "user@example.com",
    "vip_type": "month",
    "expire_time": "2026-05-05 23:25:11",
    "remaining_days": 17,
    "total_calls": 2355616
  }
}

GET/POST api.php?action=info&api_key=YOUR_KEY

查询密钥详细信息

GET/POST api.php?action=stats

获取系统统计数据

用户接口

POST user_api.php?action=register

用户注册，注册成功赠送10积分

参数	类型	必填	说明
username	string	是	用户名(3-20字符)
email	string	是	邮箱地址
password	string	是	密码(至少6字符)
confirm_password	string	是	确认密码

POST user_api.php?action=login

用户登录

参数	类型	必填	说明
username	string	是	用户名或邮箱
password	string	是	密码

GET user_api.php?action=user_info

获取当前登录用户信息和API密钥列表（需登录）

视频解析接口

GET/POST video_api.php?action=parse&video_id=123,456,789

解析视频，根据积分数量返回对应数量的解析结果，每个视频消耗1积分

参数	类型	必填	说明
action	string	是	固定值 parse
video_id	string	是	视频ID，多个用逗号分隔

积分规则：每次解析成功扣除1积分。如果积分不足，只返回积分允许数量的结果。

成功响应：

{
  "code": 200,
  "msg": "成功解析3个视频",
  "data": {
    "total_requested": 5,
    "parsed_count": 3,
    "failed_count": 0,
    "points_used": 3,
    "remaining_points": 7,
    "results": [
      {
        "video_id": "123",
        "status": "success",
        "data": { "play_url": "...", "title": "..." }
      }
    ],
    "unparsed_videos": ["456", "789"],
    "unparsed_reason": "积分不足"
  }
}

GET video_api.php?action=check_points

查询当前用户积分余额（需登录）

GET video_api.php?action=parse_status

查询解析历史记录（需登录）

价格查询接口

GET user_api.php?action=pricing&category=vip

获取价格配置，category可选：vip(会员)、points(积分)、留空(全部)

错误码说明

错误码	说明
200	成功
400	参数错误
401	未登录或认证失败
402	积分不足
403	权限不足/账户被禁用
404	资源不存在
409	资源冲突(如用户名已存在)
500	服务器内部错误