🛡️ 100% 只扣成功 (失败/死链/风控熔断秒级自动退回) 🎫 支持 CDK 卡密直连 🔑 支持固定 API Key 总额度池 + 自助发卡分发 🕵️ 纯黑盒防泄密输出

📘 SheerID 全渠道开放 API & 通用卡密 (CDKey) 对接中心

无论您是直接拿卡密去发卡网零售、在脚本中直接传入 CDK 调用，还是开通固定 API Key 总额度池并在自己的网站/机器人中自由生成和分发您自己的卡密，本平台均提供原生级支持。

🎓 打开零代码网页核销台 (首页) ↗ 📊 查看 VIP 实时通过率 (/pass) ↗ 📥 下载 Markdown 接口文档 (.md)

🌐 当前网关接口根地址 (Base URL)： https://www.geminipass.si

💡 统一鉴权：支持请求头 X-API-Key、X-CDKey、Authorization: Bearer 或 JSON Body 传 apiKey / cdkey

零代码 · 即买即卖适合发卡网 / 闲鱼 / 社群零售

🟢 模式一：免开发网页自助核销

无需编写任何一行代码！您只需把生成的 CDK 卡密 连同本系统的纯白标无痕核销网址发给买家，买家打开网页即可自助验证并查询进度。

🔹 核销页地址：/redeem
🔹 带参免填卡直达：/redeem?cdkey=VIP1-XXXX
🔹 纯白标无痕：无任何上游品牌、无客服号、不泄露任何底层信息
🔹 只扣成功：验证未过秒退回原卡密，买家可换新链接继续用

          免开户 · 卡密即 Token
          适合脚本 / 轻量核销站
        
🎫 模式二：通用卡密 (CDK) 直连 API

          无需向管理员申请固定账号！您从发卡网或后台提取的任意面值 CDK 卡密（1次卡 / 5次卡 / 100次批发卡）本身就是 API Key，直接传卡密即可调用。
        
🔹 提交验证：POST /api/v1/cdkey/verify
🔹 轮询结果：GET /api/v1/cdkey/status/{taskId}
🔹 查卡密余量/账单：POST /api/v1/cdkey/query
🔹 通道优先级：100% 直通 👑 VIP 王牌池高优队列

大客户专属 · 阶梯批发优惠适合独立站 / TG与QQ机器人 / 批量批发商

🔑 模式三：独享 API Key 总额度池

专为走量大客户定制（设有最低起充门槛，量小请直接使用模式一/二 CDK 卡密）。开通独享密钥 sk_api_xxxxxx 享大客户阶梯批发价，您可在自己网站或机器人里自由生成、分发您自己的卡密，后端统一扣减总额度池！

🔹 申请与充值：联系官方电报客服 @jdkdai (https://t.me/jdkdai) ↗ 洽谈阶梯报价与直充
🔹 提交验证：POST /api/open/v1/verify
🔹 轮询结果：GET /api/open/v1/status/{taskId}
🔹 查总额度与今日战绩：GET /api/open/v1/balance

⚡ 在线交互式 API 调试沙盒 (Live Playground)

直接在网页中填入您的 CDK 卡密 或 sk_api_... 开发者密钥，一键发起真实请求并查看返回的 JSON 数据包

🎫 您的通用卡密 (cdkey) 或 API Key：

🔗 SheerID 验证链接或 24位 verificationId（提单必填）：

🔎 任务号 taskId（查单必填）/ 充值卡密 code：

等待发起请求...

// 点击上方按钮即可在线发送真实 API 请求，返回结果将在此处实时格式化展示

📑 核心 REST API 接口完整规范

所有接口均返回标准 UTF-8 JSON（code: 0 代表请求成功），且 /api/open/v1/* 接口自动向下兼容直接传入 CDK 卡密

POST /api/v1/cdkey/verify

模式二 · CDK 卡密直连提单

使用通用卡密直接提交单条或批量 SheerID 验证链接。每次有效提单原子预冻 1 次 卡密可用额度；验证通过 (SUCCESS) 实扣 1 次；若验证失败 (FAILED) 或风控保护中止 (ABORTED_SAFE)，系统 100% 自动将 1 次额度退回原卡密。

参数名	位置	类型	必填	说明
`cdkey`	Body / Header (`X-CDKey`)	string	✅ 必填	您的通用卡密（如 `"VIP1-8A9F-3C2D"`，大小写自动兼容）
`url`	Body (JSON)	string	二选一	单条完整 SheerID 验证链接，或直接传 24 位十六进制 `verificationId`
`urls`	Body (JSON)	array<string>	二选一	批量提交多条验证链接数组（按实际有效条数预冻卡密额度）
`webhookUrl`	Body (JSON)	string	选填	任务进入终态后系统自动 `POST` 回调通知的 URL 地址

📤 请求 JSON Body 示例：

{
  "cdkey": "VIP1-8A9F-3C2D",
  "url": "https://services.sheerid.com/verify/67c8c14f5f17a83b745e3f82/?verificationId=69a0123456789abcdef01234",
  "webhookUrl": "https://your-site.com/webhook/sheerid"
}

📥 成功响应示例 (200 OK)：

{
  "code": 0,
  "message": "任务已提交（只扣成功，失败/死链/风控熔断 100% 自动退回原卡密）",
  "data": {
    "cdkey": "VIP1-8A9F-3C2D",
    "taskId": "tsk_9f8e7d6c5b4a",
    "verificationId": "69a0123456789abcdef01234",
    "status": "QUEUED",
    "creditDeducted": 1,
    "creditsRemaining": 4,
    "submittedCount": 1,
    "taskIds": ["tsk_9f8e7d6c5b4a"]
  }
}

GET / POST /api/v1/cdkey/status/{taskId}

模式二 · 轮询任务结果与领取链接

轮询查询任务执行状态与官方过审跳转链接 redirectUrl。同时支持通过 POST /api/v1/cdkey/status 传入 JSON Body {"cdkey": "...", "taskId": "tsk_..."} 查询（建议每 3 秒 轮询一次）。

📥 响应示例 A：验证通过 (SUCCESS · 实扣 1 次)

{
  "code": 0,
  "data": {
    "taskId": "tsk_9f8e7d6c5b4a",
    "verificationId": "69a0123456789abcdef01234",
    "cdkey": "VIP1-8A9F-3C2D",
    "status": "SUCCESS",
    "redirectUrl": "https://services.sheerid.com/redirect/...",
    "message": "✅ 学生身份资格认证已通过 (Verification Approved)",
    "creditDeducted": 1,
    "creditRefunded": 0,
    "netCreditsCost": 1,
    "creditsRemaining": 4,
    "elapsedSeconds": 24.6
  }
}

📥 响应示例 B：未通过或熔断 (FAILED / ABORTED_SAFE · 自动退回 1 次)

{
  "code": 0,
  "data": {
    "taskId": "tsk_9f8e7d6c5b4a",
    "verificationId": "69a0123456789abcdef01234",
    "cdkey": "VIP1-8A9F-3C2D",
    "status": "FAILED",
    "redirectUrl": "",
    "message": "❌ 本次验证未通过（只扣成功保护：1 次额度已自动退回原卡密）",
    "creditDeducted": 1,
    "creditRefunded": 1,
    "netCreditsCost": 0,
    "refundReason": "只扣成功保护：本次验证未通过·已自动退回1次卡密额度",
    "creditsRemaining": 5,
    "elapsedSeconds": 21.3
  }
}

POST / GET /api/v1/cdkey/query

模式二 · 查卡密余量与核销明细

查询指定通用卡密的总面值 (totalCredits)、已成功核销次数 (usedCredits)、处理中冻结次数 (frozenCredits)、当前剩余可用次数 (creditsRemaining) 及最近 50 条历史核销记录。

📤 请求方式（POST JSON 或 GET Query）：

// POST /api/v1/cdkey/query
{
  "cdkey": "VIP1-8A9F-3C2D"
}

// 或 GET /api/v1/cdkey/query?cdkey=VIP1-8A9F-3C2D

📥 成功响应示例：

{
  "code": 0,
  "data": {
    "cdkey": "VIP1-8A9F-3C2D",
    "cardStatus": "ACTIVE",
    "cardStatusLabel": "🟢 有效可用",
    "enabled": true,
    "totalCredits": 5,
    "usedCredits": 1,
    "frozenCredits": 0,
    "creditsRemaining": 4,
    "recentTasks": [ ... ]
  }
}

POST /api/open/v1/verify

模式三 · 固定 API Key 总额度池提单

专为自建核销网站、Telegram/Discord/QQ 机器人与二级发卡平台设计的 B2B 提单接口。您在自己的前端向客户校验您自己发行的卡密后，后端统一携带 X-API-Key: sk_api_xxxxxx 调用此接口，任务直接进入【API 供应商专属共享高并发池】执行，且严格遵循只扣成功（失败/死链/熔断 100% 自动退回您的 API Key 余额）。

参数名	位置	类型	必填	说明
`X-API-Key`	Header / Body (`apiKey`)	string	✅ 必填	您的固定开发者密钥 `sk_api_xxxxxx`（也向下兼容直接传 `CDK` 卡密）
`url`	Body (JSON)	string	二选一	单条 SheerID 验证链接，或 24 位 `verificationId`
`urls`	Body (JSON)	array<string>	二选一	批量提交多条验证链接（支持数组或换行分隔的多行文本）
`webhookUrl`	Body (JSON)	string	选填	异步回调地址（不传则使用您在后台绑定的默认 Webhook 地址）

📤 请求 Header & Body 示例：

POST /api/open/v1/verify
X-API-Key: sk_api_8X9mK2pQ7vR4nL5wT3
Content-Type: application/json

{
  "url": "https://services.sheerid.com/verify/67c8c14f5f17a83b745e3f82/?verificationId=69a0123456789abcdef01234",
  "webhookUrl": "https://your-bot.com/api/sheerid/callback"
}

📥 成功响应示例 (200 OK)：

{
  "code": 0,
  "message": "提交成功（只扣成功，失败/死链/零损耗熔断 100% 自动退回额度）",
  "data": {
    "taskId": "tsk_3a4b5c6d7e8f",
    "verificationId": "69a0123456789abcdef01234",
    "status": "QUEUED",
    "creditDeducted": 1,
    "creditsRemaining": 499,
    "submittedCount": 1,
    "taskIds": ["tsk_3a4b5c6d7e8f"],
    "apiPoolRunning": 2,
    "apiPoolConcurrency": 10
  }
}

GET / POST /api/open/v1/status/{taskId}

模式三 · 查询任务进度与领取链接

查询单条或多条任务（逗号分隔 tsk_1,tsk_2）的实时状态、过审领取链接 redirectUrl、扣退费明细以及当前 API Key 剩余总额度 creditsRemaining。同时支持 POST /api/open/v1/status 通过 JSON Body {"apiKey": "sk_api_...", "taskId": "tsk_..."} 查单。

📤 请求示例：

GET /api/open/v1/status/tsk_3a4b5c6d7e8f
X-API-Key: sk_api_8X9mK2pQ7vR4nL5wT3

📥 成功响应示例：

{
  "code": 0,
  "data": {
    "taskId": "tsk_3a4b5c6d7e8f",
    "verificationId": "69a0123456789abcdef01234",
    "status": "SUCCESS",
    "redirectUrl": "https://services.sheerid.com/redirect/...",
    "message": "✅ 学生身份认证已通过 (Approved)",
    "creditDeducted": 1,
    "creditRefunded": 0,
    "netCreditsCost": 1,
    "creditsRemaining": 499,
    "elapsedSeconds": 22.4
  }
}

GET / POST /api/open/v1/balance

模式三 · 查询 API Key 总额度池与今日统计

实时查询您的固定 API Key 当前剩余可用额度、今日提单数、今日成功数、今日自动退回数、净通过率以及共享并发池水位（别名：/api/open/v1/me）。

{
  "code": 0,
  "data": {
    "resellerId": "rsl_7a8b9c0d",
    "name": "极速核销独立站",
    "enabled": true,
    "creditsRemaining": 499,
    "todaySubmits": 58,
    "todaySuccess": 51,
    "todayFailed": 5,
    "todayAbortedSafe": 2,
    "todayRefunded": 7,
    "todayCreditsUsed": 51,
    "todayPassRate": 91.1,
    "totalRecharged": 1000,
    "totalUsed": 501,
    "apiPoolRunning": 2,
    "apiPoolConcurrency": 10,
    "billingRule": "SUCCESS_ONLY (只扣成功，失败/死链/熔断 100% 自动退回额度)"
  }
}

POST /api/open/v1/redeem

模式三 · 用 CDK 卡密给自己的 API Key 自助充值

当您的 sk_api_... 总额度池余额不足时，您可以直接在发卡网购买任意面值的 CDK 卡密，调用此接口将卡密内的次数 100% 自动充入您的固定 API Key 账户，24 小时无需人工值守！

📤 请求 JSON Body 示例：

{
  "apiKey": "sk_api_8X9mK2pQ7vR4nL5wT3",
  "code": "VIP100-9A8B-7C6D"
}

📥 成功响应示例：

{
  "code": 0,
  "message": "✅ CDK 卡密核销成功！已为 API Key【极速核销独立站】充入 +100 次额度，当前剩余 599 次",
  "data": {
    "code": "VIP100-9A8B-7C6D",
    "resellerId": "rsl_7a8b9c0d",
    "name": "极速核销独立站",
    "addedCredits": 100,
    "creditsRemaining": 599
  }
}

💻 多语言快速对接代码模板（复制即用）

以下示例代码同时兼容传入 固定开发者密钥 sk_api_... 或 通用卡密 VIP1-...

📊 任务状态枚举 (data.status) 速查表

状态值	终态	扣费结果	说明与建议动作
`QUEUED`	否	预冻结 1 次	正在高优队列等待空闲并发窗口，继续每 3 秒轮询
`PROCESSING`	否	预冻结 1 次	正在自动上传凭证与官方审核中，继续每 3 秒轮询
`SUCCESS`	✅ 是	实扣 1 次	认证通过！提取 `redirectUrl` 展示给客户领取权益
`ABORTED_SAFE`	✅ 是	退回 1 次 (净扣0)	通道风控保护中止，原验证链接 100% 完好，可直接用原链接重试
`FAILED`	✅ 是	退回 1 次 (净扣0)	验证未通过，1 次额度已自动退回账户，请换新验证链接重试

🔔 Webhook 异步回调通知格式

当提单时传入了 webhookUrl，任务进入终态（SUCCESS / FAILED / ABORTED_SAFE）后系统将主动发起 HTTP POST JSON 回调：

{
  "event": "verification.completed",
  "taskId": "tsk_3a4b5c6d7e8f",
  "verificationId": "69a0123456789abcdef01234",
  "status": "SUCCESS",
  "redirectUrl": "https://services.sheerid.com/redirect/...",
  "creditRefunded": 0,
  "refundReason": "",
  "completedAt": 1775000122
}