小影API 小影API

自研图形验证码

自研图形验证码（字符图片 / 算术），Pillow 本地绘制、无第三方依赖，答案一次性校验。

/api/captcha_self/

服务说明

自研图形验证码不依赖任何第三方服务，由平台用 Pillow 在本地绘制字符图片或算术题，适合对数据外发敏感、或希望零成本自建验证码的场景。

接入为两步：先调用生成接口拿到 captcha_id 与 base64 图片（带有效期），用户作答后调用校验接口提交答案。答案是「一次性」的——无论校验成功还是失败都会立即失效，失败后需重新生成再试。

该线路为开放接口，无需项目签名；生产环境建议同时限制单 IP、单账号的校验频率。

自研验证码

SpiderServices/Captcha 自研生成引擎（Pillow 绘制） 开放 · 免签名

两步接入：先 generate 拿 captcha_id 与图片（base64），用户作答后 POST verify 校验；答案一次性，校验后无论对错立即失效，需配合前端换新图。

GET /api/captcha_self/generate 累计调用 28 次

生成验证码

生成一张验证码，返回 captcha_id、base64 图片与有效期。

选填：char=字符图片（数字+大写字母）；arithmetic=算术加减法

选填：仅 kind=char 生效，取值 4-6（默认 4）

  • 请求方式 GET，参数放 query string；公开接口，无需项目签名。
  • 返回 data.captcha_id 必须与答案一起回传给 verify；data.image 为 base64 data URI，可直接用于 <img src>；data.expire_in 为有效期（秒，默认 300）。
POST /api/captcha_self/verify 累计调用 3 次

校验验证码

提交用户答案校验，一次性消费（校验后立即失效）。

必填：生成接口返回的 captcha_id（UUID）

必填：用户填写的答案（字符不区分大小写；算术填计算结果）

  • 请求体为 application/x-www-form-urlencoded 表单；开放接口，无需项目签名。
  • 校验通过：code=10000 且 data.passed=true；
  • 未通过（答案错误 / 已过期 / 已使用 / 不存在）：code=20003 且 data.passed=false，原因见 msg；
  • captcha_id 非 UUID 时返回 code=20002，参数缺失时返回 code=20001。
  • 答案一次性：同一条验证码重复提交只会成功一次，失败后需重新调用 generate。
小影API · 通用 API 聚合服务