图形验证码 / 滑块验证码(人机识别)服务。为登录、注册、短信、查询等场景提供防机器人的能力。
| 类型 | 说明 | 有效期 |
|---|---|---|
| 图形验证码 | 扭曲字符 + 干扰线,4 位字符 | 120 秒,一次有效 |
| 滑块验证码 | 背景图缺口 + 拼图块,拖拽对齐 | 180 秒,一次有效 |
服务端只保存答案与过期时间,不采集、不存储任何用户身份信息;日志仅记录调用结果码与耗时。
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /api/v1/health | 健康检查 |
| GET | /api/v1/captcha/image | 生成图形验证码,返回 JSON(base64 PNG) |
| GET | /api/v1/captcha/<id>.png | 直接取图片 |
| POST | /api/v1/captcha/verify | 校验图形验证码 |
| GET | /api/v1/captcha/slider | 生成滑块验证码,返回背景图 + 拼图块 |
| POST | /api/v1/captcha/slider/verify | 校验滑块位置 |
POST /api/v1/captcha/verify
{"captcha_id": "img_xxx", "answer": "a3k9"}
→ {"ok": true, "message": "验证通过"}