小影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 聚合服務