全部產品
Search
文件中心

Captcha:用戶端V3架構返回資料說明

更新時間:Jan 06, 2026

驗證碼2.0用戶端V3架構中的行為驗證中,驗證碼服務端會在驗證答案是否正確以及判斷是否為機器請求後,將驗證碼Code和其他參數返回給業務用戶端,您可以通過瀏覽器的Network功能查看返回資料。

名稱

類型

描述

HTTP Status Code

Integer

HTTP狀態代碼。更多資訊,請參見返回參數說明

HTTP Body

RequestId

String

請求ID。

Success

Boolean

請求是否成功。

  • true:表示請求成功。

  • false:表示請求失敗。

Code

String

返回碼。更多資訊,請參見返回參數說明

Message

String

返回詳細資料。更多資訊,請參見返回參數說明

Result

VerifyResult

Boolean

驗證結果。

  • true:表示驗證通過。

  • false:表示驗證不通過。

VerifyCode

String

T001

用戶端校正通過。

T005

控制台開啟測試模式,且配置了驗證通過。如有疑問,請登入驗證碼2.0控制台查看對應情境的策略狀態的配置。具體操作請參見接入指引

T006

命中白名單策略校正通過。若有疑問,請登入驗證碼2.0控制台查看對應白名單策略配置詳情。

F001

疑似攻擊請求,風險策略不通過。如有疑問,您可以提交工單進行排查。

F004

控制台開啟測試模式,且配置了驗證不通過。如有疑問,請登入驗證碼2.0控制台查看對應情境的策略狀態配置。具體操作請參見情境管理

F008

驗證資料重複提交。同一筆驗證碼請求只允許提交一次。

F009

檢測到虛擬設備環境,請檢查是否使用vmware、virtualbox、hyper-v、parallels等虛擬機器,avd、blue stacks、vbox/hyper-v等模擬器,案頭瀏覽器類比行動裝置等。如不需要攔截,請登入驗證碼2.0控制台自訂策略中關閉,具體操作請參見設定自訂策略

F010

同IP訪問頻率超出限制。如果需要自訂頻率閾值,請登入驗證碼2.0控制台自訂策略進行配置,具體操作請參見設定自訂策略

F011

同裝置訪問頻率超出限制。如果需要自訂頻率閾值,請登入驗證碼2.0控制台自訂策略進行配置,具體操作請參見設定自訂策略

F014

無初始化記錄,可能存在兩種原因:

  • 驗證請求和初始化請求間隔超出20分鐘時間,後端會刪除初始化記錄,請重新發起初始化請求進行嘗試。

  • 不存在初始化記錄,疑似攻擊請求,或者接入異常,發起驗證請求前需先發起用戶端初始化請求。

F015

驗證互動不通過。例如拼圖沒有滑動到正確位置,可以重新整理驗證碼重新完成互動。

F016

控制台自訂策略配置URL驗證導致不通過,請登入驗證碼2.0控制台自訂策略中URL驗證策略進行調整,具體操作請參見設定自訂策略

F017

疑似攻擊請求,協議或參數異常不通過。

F022

V3架構加密模式校正失敗(如:用戶端資源盜刷攔截,或者用戶端未正確接入)。加密模式接入可參考V3架構加密模式接入引導

F024

檢測到自動化指令碼類比點擊、滑動等操作行為。若當前為引入 touch-emulator 以在案頭端類比觸摸事件的 Vue 應用,或其他存在合法類比點擊情境的業務,請勿啟用攔截。如無需攔截此類行為,請在自定义策略中關閉拦截模拟点击行为,具體操作請參見設定自訂策略

返回參數HTTP Status CodeCodeMessage的詳細說明,如下表所示。

HTTP Status Code

Code

Message

200

Success

成功。

400

MissingParameter

缺少必須參數。

401

InvalidParameter

參數不合法。

403

Forbidden.AccountAccessDenied

無許可權,可能是未開通服務,或已欠費。

403

Forbidden.RAMUserAccessDenied

RAM使用者無許可權,請授權 AliyunYundunAFSFullAccess。具體操作,請參見管理RAM角色的許可權

500

InternalError

系統內部錯誤,建議重試。如果仍然報錯,請提交工單聯絡我們。