LiuQi 验证码服务 API 文档

版本：v1.0  ·  更新日期：2026-10-07  ·  接口地址：https://cookie.lqay.cn/api/

1. 简介

本服务用于请求本站API 最终返回获取到的账号信息及平台统计数据。

服务特点：

• 基于 Authorization 请求头进行 Key 鉴权
• 每次调用均记录日志（操作者、时间、IP、获取结果）
• 返回结果自动合并平台统计数据（今日 / 总量 / 可用）

2. 快速开始

2.1 请求方式

GET https://cookie.lqay.cn/api/

2.2 最小请求

curl -H "Authorization: LiuQi-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" \
     "https://cookie.lqay.cn/api/"

2.3 成功响应

{"account":"LAkaoLrFizd5","password":"T3os0HFk58Dz","cookie":null,"Sauth":"{\"sauth_json\":\"{\\\"aim_info\\\": \\\"{\\\\\\\"aim\\\\\\\": \\\\\\\"127.0.0.1\\\\\\\", \\\\\\\"country\\\\\\\": \\\\\\\"CN\\\\\\\", \\\\\\\"tz\\\\\\\": \\\\\\\"+0800\\\\\\\", \\\\\\\"tzid\\\\\\\": \\\\\\\"\\\\\\\"}\\\", \\\"realname\\\": \\\"{\\\\\\\"realname_type\\\\\\\": 2}\\\", \\\"app_channel\\\": \\\"4399com\\\", \\\"platform\\\": \\\"ad\\\", \\\"client_login_sn\\\": \\\"MxR9S3D5X2\\\", \\\"gameid\\\": \\\"x19\\\", \\\"login_channel\\\": \\\"4399com\\\", \\\"sdk_version\\\": \\\"3.12.2\\\", \\\"sdkuid\\\": \\\"1355481735\\\", \\\"sessionid\\\": \\\"1355481735|79842bac37ebc8eaa4f3cf1e7ac43834|44770||efb0ca6a3c43053ade138171f8e16e99|8efb866cc2620203c95f240827860b49|1792636205|4399\\\", \\\"udid\\\": \\\"cf0d429ebac27825\\\", \\\"deviceid\\\": \\\"2967464fcf7c4697\\\"}\"}\n","today":97,"total":1604853,"available":1492648}

3. 鉴权说明

3.1 鉴权方式

所有请求必须在 HTTP 请求头中携带 Authorization 字段，值为分配给你的 Key。

Authorization: LiuQi-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

也兼容 Bearer 前缀写法：

Authorization: Bearer LiuQi-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

3.2 Key 说明

• 每个用户拥有独立的 Key，互不影响
• Key 由管理员分配，格式为 LiuQi-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
• Key 与用户身份（QQ）绑定，服务端会记录每次调用的归属
• 请勿泄露 Key，如泄露请立即联系管理员更换

📌 如何获取 Key？
请加入官方 QQ 群，联系群主 QQ 1458619045 领取你的专属 Key。
管理员会核对身份后分配，请勿相信任何非群主渠道的售卖信息。

3.3 鉴权失败

未携带 Key 或 Key 无效时，统一返回：

HTTP/1.1 401 Unauthorized
Content-Type: application/json

{"error":"Unauthorized"}

服务端不会区分「未携带」和「Key 错误」，均返回 401，避免被枚举探测。

4. 接口详情

4.1 获取账号 GET

获取一个账号及密码，并附带平台统计数据。

请求地址

GET https://cookie.lqay.cn/api/

请求头

请求示例

curl -H "Authorization: LiuQi-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" \
     "https://cookie.lqay.cn/api/"

成功响应（200）

{"account":"LAkaoLrFizd5","password":"T3os0HFk58Dz","cookie":null,"Sauth":"{\"sauth_json\":\"{\\\"aim_info\\\": \\\"{\\\\\\\"aim\\\\\\\": \\\\\\\"127.0.0.1\\\\\\\", \\\\\\\"country\\\\\\\": \\\\\\\"CN\\\\\\\", \\\\\\\"tz\\\\\\\": \\\\\\\"+0800\\\\\\\", \\\\\\\"tzid\\\\\\\": \\\\\\\"\\\\\\\"}\\\", \\\"realname\\\": \\\"{\\\\\\\"realname_type\\\\\\\": 2}\\\", \\\"app_channel\\\": \\\"4399com\\\", \\\"platform\\\": \\\"ad\\\", \\\"client_login_sn\\\": \\\"MxR9S3D5X2\\\", \\\"gameid\\\": \\\"x19\\\", \\\"login_channel\\\": \\\"4399com\\\", \\\"sdk_version\\\": \\\"3.12.2\\\", \\\"sdkuid\\\": \\\"1355481735\\\", \\\"sessionid\\\": \\\"1355481735|79842bac37ebc8eaa4f3cf1e7ac43834|44770||efb0ca6a3c43053ade138171f8e16e99|8efb866cc2620203c95f240827860b49|1792636205|4399\\\", \\\"udid\\\": \\\"cf0d429ebac27825\\\", \\\"deviceid\\\": \\\"2967464fcf7c4697\\\"}\"}\n","today":97,"total":1604853,"available":1492648}

失败响应（502）

{
  "error": "获取失败"
}

5. 返回字段说明

5.1 主流程字段

5.2 统计字段说明

若统计接口拉取失败，today / total / available 会返回 null，并附带 stats_error 字段，不影响主流程返回的 account / password。

6. 错误码

7. 使用示例

7.1 cURL

curl -H "Authorization: LiuQi-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" \
     "https://cookie.lqay.cn/api/"

7.2 Python

import requests

url = "https://cookie.lqay.cn/api/"
headers = {
    "Authorization": "LiuQi-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

resp = requests.get(url, headers=headers, timeout=120)
print(resp.status_code)
print(resp.json())

7.3 PHP

<?php
$ch = curl_init('https://cookie.lqay.cn/api/');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: LiuQi-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx',
    ],
    CURLOPT_TIMEOUT        => 120,
]);
$body = curl_exec($ch);
curl_close($ch);
echo $body;

7.4 JavaScript (Node.js)

const res = await fetch("https://cookie.lqay.cn/api/", {
  headers: {
    "Authorization": "LiuQi-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  }
});
const data = await res.json();
console.log(data);

7.5 JavaScript (浏览器)

由于需要自定义 Authorization 请求头，浏览器端需服务端允许 CORS 头 Authorization， 且不建议在前端直接暴露 Key。

fetch("https://cookie.lqay.cn/api/", {
  headers: {
    "Authorization": "LiuQi-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  }
})
.then(r => r.json())
.then(console.log);

8. 日志与统计

8.1 日志记录

服务端会为每次成功调用记录一条日志，内容包括：

日志格式为每行一条 JSON：

{"time":"2026-10-07 12:00:00","key":"LiuQi-xxxxxxxx-...","qq":"1458619045","ip":"1.2.3.4","status":200,"account":"example@mail.com","password":"abc123456"}

日志仅管理员可见，普通用户无法通过接口读取。

9. 常见问题

Q1：返回 401 Unauthorized？

• 检查是否携带 Authorization 请求头
• 检查 Key 是否拼写正确（区分大小写）
• 检查 Key 是否已被管理员禁用
• 若使用 Nginx，确认 Authorization 头已透传给 PHP

Nginx 配置示例

location ~ \.php$ {
    fastcgi_pass unix:/run/php/php-fpm.sock;
    fastcgi_param HTTP_AUTHORIZATION $http_authorization;
    include fastcgi_params;
}

Q2：返回 502 获取失败？

返回了非 JSON 内容，通常是：

• 服务临时不可用
• 求解结果被拒绝
• 网络波动导致响应被截断

建议稍后重试。

Q3：返回 500 验证码求解失败？

滑块识别失败。服务端已自动重试 3 次，若仍失败说明：

• 风控加强
• 图片识别精度不足
• 网络异常

可稍后重试或联系管理员。

Q4：today / total / available 返回 null？

统计接口拉取失败，但不影响 account / password 的获取。可忽略，或稍后重试。

Q5：请求超时？

服务端设置了 set_time_limit(120)，即最长 120 秒。若经常超时，可能是：

• 网络不稳定
• 滑块识别耗时过长

建议客户端超时设置为 120 秒以上。

Q6：一个 Key 可以多人共用吗？

技术上可以，但不建议。每个 Key 与一个 QQ 绑定，共用会导致日志归属混乱。请为每位用户分配独立 Key。

Q7：如何获取 API Key？

请加入官方 QQ 群，联系群主 QQ 1458619045 领取。管理员会核对身份后为你分配专属 Key。请勿从其他渠道购买，谨防受骗。

10. 注意事项

1. Key 属于敏感凭证，请勿硬编码在前端页面、公开仓库或客户端中。
2. 请使用 HTTPS 访问，避免 Key 在传输过程中被窃听。
3. 请勿高频调用，每次请求都会实际完成一次验证码求解，存在资源开销。
4. 服务端会记录每次调用的 Key、QQ、IP、账号、密码，请知悉。
5. 本服务仅供学习与内部使用，请勿用于非法用途。
6. 如 Key 泄露，请立即联系管理员更换。
7. 获取 Key 请进群联系群主 QQ 1458619045，请勿相信非官方渠道。

附录：请求流程图

LiuQi 验证码服务 API 文档 · v1.0 · 2026-10-07