{
  "name": "wjkc-api",
  "endpoints": {
    "GET /sub": {
      "desc": "订阅端点：返回有效订阅内容（vless:// 明文）。自动维护账号池——无有效账号时自动注册并记录",
      "query": {
        "format": "可选，'base64' 返回 base64 编码的订阅内容（兼容其他客户端）",
        "refresh": "可选，=1 跳过内容缓存强制重新拉取"
      },
      "note": "v2ray 客户端可直接把本地址当订阅链接使用；响应带 subscription-userinfo 头（流量/到期）"
    },
    "POST /api/register": {
      "desc": "手动注册（创建临时邮箱 → 收验证码 → 注册 → 兑换券），结果自动写入 KV 账号池",
      "body": {
        "domain": "可选，临时邮箱域名（不传随机分配）",
        "coupon": "可选，体验券码，默认 vpsknow，传 '' 跳过",
        "deadline": "可选，收码超时秒数，默认 30（免费计划墙钟上限约 30s）",
        "resume": "可选，上次超时返回的 { email, tempMailJwt }，用于续传"
      }
    },
    "GET /api/query": {
      "desc": "查询套餐流量",
      "query": {
        "token": "注册接口返回的 token"
      }
    },
    "GET /api/accounts": {
      "desc": "账号池列表（所有已记录账号与流量状态）",
      "query": {
        "full": "可选，=1 返回密码/token 等敏感字段"
      }
    },
    "POST /api/replenish": {
      "desc": "手动补号：池内无'未来 6h 内仍有效'的账号时注册一个新号（互斥锁防并发）",
      "body": {
        "force": "可选，=1 忽略 6h 预备阈值，无条件注册一个新号"
      },
      "note": "Cron 自动补号默认关闭（AUTO_REPLENISH=0 且无 triggers），需要时手动调用本端点"
    }
  },
  "auth": "设置 API_KEY 后，请求需带 x-api-key 头或 ?api_key= 参数"
}