GET
/api/v1/health
健康检查，无需鉴权。用于探活与确认存储后端。
API 调用说明
由当前服务自动生成可复制示例，支持在线试调
当前环境
Base URL
—
演示 API Key（受限）
cg-demo-34423884c0a6df03
鉴权 Header
X-API-Key: <your-key>
插件地址
—
演示 Key 仅供本站文档/演示页测试（独立全局限流，重启自动轮换）。生产接入请在管理后台创建自己的 API Key。
系统
滑动拼图
POST
/api/v1/captcha/slider/generate
生成滑动拼图。返回 token、background、puzzle、puzzle_y（块 top，已减 pad）。
POST
/api/v1/captcha/slider/verify
校验滑动结果。需上报轨迹与耗时以通过行为检测。
| 字段 | 类型 | 说明 |
|---|---|---|
token | string | 生成接口返回 |
offset_x | number | 拼图块左上角 x（原图像素） |
duration_ms | number | 滑动耗时（毫秒） |
track | array | [{x, t}, ...] 轨迹采样 |
点选验证
POST
/api/v1/captcha/click/generate
生成点选图。返回 image、chars（需按序点击）、prompt、token。
POST
/api/v1/captcha/click/verify
校验点击坐标。坐标为原图像素；容差约 28px。
| 字段 | 类型 | 说明 |
|---|---|---|
token | string | 生成接口返回 |
points | array | [{x, y}, ...] 与 chars 顺序一致 |
timings | array | 各次点击相对毫秒 |
前端插件
CaptchaSDK · 一行接入弹窗验证
自动注入样式与弹窗，内置轨迹/时序采集。成功返回 pass_token。
管理接口
POST
/api/v1/admin/login
管理员登录，返回 JWT。后续管理接口使用 Authorization: Bearer <jwt>。