密钥商城密钥检测克隆密钥CID 识别API 接入充值/客服

API 接入说明

程序接入与页面同价同规则。所有接口调用与用户名绑定：凭用户名（+密码）调用，余额、购买记录、留档密钥都记在你的用户名下。

认证方式

请求头X-Api-Token: 你的用户名（已设密码的用户额外带 X-Api-Pass: 密码）
计价单位余额/价格均为元，支持小数；购买/CID 按次从余额扣除
返回格式成功 200 返回 JSON；失败返回 {"detail": "原因"}，配合 HTTP 状态码 4xx/5xx
还没有账号？去 密钥检测 或 商城 页面，操作时按提示注册即可（约 30 秒）。注册后用户名即 API 调用凭证。
防滥用规则
· 所有 API 调用与用户名一一绑定：余额扣减、购买记录、密钥留档、调用日志均可追溯到用户名，滥用将封禁该账号；
· 接口限频：每用户每分钟最多 60 次调用，超出返回 429（请稍后重试）；无用户名的公共接口按来源 IP 限频；
· 恶意刷接口、绕过限频、盗用他人用户名的行为将被管理员封号，余额不退。

接口示例（地址自动跟随当前站点）

① 注册账号（POST /api/register，是否开放由管理员设置；密码可省略=免密）
curl -X POST "http://服务器IP:8787/api/register" -H "Content-Type: application/json" -d "{\"name\":\"我的用户名\",\"password\":\"可选密码\"}"
② 查询商品列表与余额（GET /api/shop，游客可浏览）
curl "http://服务器IP:8787/api/shop" -H "X-Api-Token: 用户名"
③ 检测密钥（POST /api/check，免费；有效密钥自动留档到你的名下）
curl -X POST "http://服务器IP:8787/api/check" -H "X-Api-Token: 用户名" -H "Content-Type: application/json" -d "{\"keys\":[\"XXXXX-XXXXX-XXXXX-XXXXX-XXXXX\"]}"

Retail 仅离线识别产品与类型；MAK 自动在线查询剩余次数。检测结果归档到该用户名下（后台可查）。

③b 游客检测（POST /api/check/guest，免登录，按 IP 限频）
curl -X POST "http://服务器IP:8787/api/check/guest" -H "Content-Type: application/json" -d "{\"keys\":[\"XXXXX-XXXXX-XXXXX-XXXXX-XXXXX\"]}"

与 /api/check 同参数同结果，无需用户名；记录归档在「guest」名下，受每分钟 60 次 API 限频（按来源 IP 计数）。网页版检测页游客直接可用，程序接入也可调用此接口临时验证。

④ 购买密钥（POST /api/shop/buy，按分类购买，同事务扣费出库）
curl -X POST "http://服务器IP:8787/api/shop/buy" -H "X-Api-Token: 用户名" -H "Content-Type: application/json" -d "{\"category\":\"401\",\"count\":1}"

category 即商品编号（见商城分类，如 401 = Windows 10/11 专业零售版）；count 1-50。

⑤ 识别确认 ID（POST /api/cid，0.2 元/次，失败不扣费）
curl -X POST "http://服务器IP:8787/api/cid" -H "X-Api-Token: 用户名" -H "Content-Type: application/json" -d "{\"iid\":\"123456 123456 ...（54位或63位）\"}"

iid 支持 9 组 6 位（54 位）或 9 组 7 位（63 位）数字，分组/横线/空格均可，自动提取；成功返回 {"iid":"...","cid":"48位确认ID","cost":0.2,"balance_left":余额}。

⑥ 其他接口
GET  /api/status       站点状态（注册开关/CID单价/限频/客服QQ，游客可访问）
GET  /api/me           我的余额/配额/克隆开关/CID单价
GET  /api/orders       购买记录
POST /api/draw           {"category":"401"} 从密钥池提取一枚
POST /api/clone          {"key":"母钥","count":1-50} 克隆（需开通）
GET  /api/clone/records  克隆记录（独立页 /clone）