站点 Logo 4399公益账号领取站|4399小号获取|小号机
API Docs

API 接入文档

本站支持自助开通 API:注册账号 → 每日打卡赚额度 → 自动获得 API Key。同一个 API Key 拥有两套额度:账号额度和 Cookies 额度,二者分开计数;用户 API 默认共享每秒 3 次请求限速。如需人工协助或合作接入,请登录站点反馈工单

合理使用条款:请勿高频滥用、批量转售、绕过限制或将账号用于任何非法用途。

自助开通流程

无需联系管理员,注册账号即可免费开通 API:

  1. 注册账号:仅支持 5-12 位数字 QQ号@qq.com,QQ等级需大于 15 级。
  2. 发送邮箱验证码前需要完成滑块验证;提交注册时还需要再次完成滑块验证,并填写邮箱收到的 6 位验证码。
  3. 注册成功后自动验证邮箱,并获得 10 账号额度 + 10 Cookies 额度。
  4. 进入个人中心点击「免费开通 API」生成专属 Key。
  5. 每日打卡:固定 +15 账号额度 +15 Cookies 额度;连续打卡每满 7 天额外 +50 账号额度 +50 Cookies 额度。
  6. 邀请好友注册成功:填写邀请码的用户和邀请人双方各获得 50 账号额度 + 50 Cookies 额度。
  7. 额度不足时调用接口会返回 429,前往个人中心打卡即可恢复。

管理员也可在后台为指定用户调整额度或重置 Key。

用户 API Key 说明

  • 用户 API Key 以 aku_ 开头,在个人中心免费生成。
  • 获取账号接口消耗账号额度;转 Cookies 接口只在转换成功时消耗 Cookies 额度。
  • 账号额度和 Cookies 额度独立计算,不能互相替代;每次成功调用消耗 1 点对应额度。
  • 用户 Key 默认限速为每秒 3 次,领取账号和转 Cookies 共用同一个限速窗口;账号被封禁或 Key 被停用后会立即失效。

鉴权方式

支持 GET 参数、POST 参数、X-API-Key 请求头或 Bearer 请求头。直接使用 GET 参数时:

?key=aku_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

每个 API Key 有独立总限速,默认每秒 3 次,超过会返回 429 rate limit exceeded。响应会带有 Retry-AfterX-RateLimit-LimitX-RateLimit-RemainingX-RateLimit-Reset,请按提示退避重试。

建议接入方缓存结果、做失败重试退避,并遵守本站提供的合理使用条款。

API 1:获取账号

GET /claim_by_key.php

使用 API Key 免验证码领取一条可用账号。消耗账号额度,不消耗 Cookies 额度;超过账号额度会返回 429。禁止将账号用于非法用途、恶意刷量、攻击、骚扰或其他违反法律法规的行为。

请求示例

https://api.4399pc.cc/claim_by_key.php?key=aku_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

成功返回

{
  "code": 1,
  "msg": "ok",
  "username": "账号",
  "password": "密码",
  "quota_limit": 10,
  "used_count": 1,
  "remaining": 9
}

常见错误

401 invalid api key
200 code=0, msg=库存已空
429 api key quota exceeded
429 rate limit exceeded

API 2:转 Cookies

GET /convert_cookies_by_key.php

使用 API Key 将用户名密码提交给本站后端,由本站服务器请求转换服务。消耗 Cookies 额度,不消耗账号额度。浏览器/调用方不会直接连接转换服务。请勿用于非法用途或高频滥用。

参数

参数必填说明
username用户名
password密码
usepc 或 pe,默认 pc。pc = 方式1稳定;pe = 方式2不稳定。

请求示例

https://api.4399pc.cc/convert_cookies_by_key.php?key=aku_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&username=账号&password=密码&use=pc

成功返回

{
  "code": 1,
  "msg": "ok",
  "http_code": 200,
  "use": "pc",
  "charged": true,
  "cookies_quota_limit": 10,
  "cookies_used_count": 1,
  "cookies_remaining": 9,
  "data": "转换服务原始返回内容"
}

常见错误

401 invalid api key
429 cookies quota exceeded
429 rate limit exceeded
502 转换服务请求失败,请稍后重试

联系方式

API 接入、赞助合作、额度调整请登录站点反馈工单