小影API 小影API

圖形驗證

阿里雲圖形驗證碼集成（滑塊/點選等），服務端下發配置並二次校驗，防機器流量。當前接入阿里雲線路。

/api/captcha_auth/

服務說明

圖形驗證服務集成阿里雲圖形驗證碼（滑塊、點選等行為驗證），用於在註冊、登錄、發短信等入口攔截機器流量：前端先用配置接口拿到 appId 初始化 SDK 並完成驗證，再把驗證參數交給業務後端調用核驗接口，確認本次驗證真實有效。

為避免被繞過，驗證結果必須在服務端二次核驗，不能只依賴前端回調。

該線路整體為開放接口，config 與 verify 均無需項目簽名，便於前端直接集成。

響應格式

所有接口返回同一個 JSON 信封，業務數據都在 data 裡： 

{
  "code": 10000,
  "msg": "成功",
  "data": { ... }
}
  • code：業務狀態碼，10000 表示成功；其餘為各類錯誤，完整清單見「錯誤碼」頁。
  • msg：給人看的提示文案，可直接展示給終端用戶，但不要用它做邏輯判斷。
  • data：業務數據；出錯時通常為 null。各接口 data 的具體字段見該接口的「響應說明」。

判斷成功與否請看 code，不要依賴 HTTP 狀態碼。 查看完整錯誤碼

阿里雲圖形認證

阿里雲圖形認證服務（滑塊/點選驗證） 開放 · 免簽名

兩步接入：先用 config 拿 appId 初始化前端 SDK，用戶驗證通過後再用 verify 做服務端二次校驗。

GET /api/captcha_auth/aliyun/config 累計調用 0 次

獲取圖形認證配置

返回圖形認證 appId（captchaId），供 H5 前端 SDK 初始化。公開接口，無需簽名。

  • 響應 data.app_id 即前端 initAlicom4({ captchaId: app_id, product: "bind" }, ...) 所需的 captchaId。
響應說明 外層統一格式
字段 類型 說明
app_id string 圖形認證 appId（captchaId）
返回示例 
{"app_id": "FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF"}
POST /api/captcha_auth/aliyun/verify 累計調用 0 次

二次校驗

上傳客戶端驗證參數，確認用戶本次圖形驗證有效（防繞過）。

必填：前端 SDK 驗證通過後回調返回的流水號，32 位小寫 hex

必填：前端 SDK 驗證通過後回調返回的 captchaOutput

必填：前端 SDK 驗證通過後回調返回的 passToken

必填：前端 SDK 驗證通過後回調返回的 genTime

  • 請求體為 application/x-www-form-urlencoded 表單；公開接口，無需項目簽名。
  • 接口請求成功統一返回 code=10000；業務結果以 data.result 判斷：
  • success=驗證有效，fail=驗證無效（pass_token 過期/流水號已用等），原因見 data.reason。
響應說明 外層統一格式
字段 類型 說明
result string 校驗結果：success/fail
passed bool 是否校驗通過
reason string 失敗原因（成功為空）
captcha_args object 驗證輸出參數（風控信息）
返回示例 
{"result": "success", "passed": true, "reason": "", "captcha_args": {}}
小影API · 通用 API 聚合服務