全部產品
Search
文件中心

Captcha:用戶端初始化報錯說明

更新時間:Jan 09, 2026

初始化介面錯誤碼

驗證碼初始化介面指的是帶有使用者身份標的擷取驗證碼資源的請求,請求網域名稱為xxxxx.captcha-open.aliyuncs.com,其中xxxxx為使用者的身份標,關於如何擷取身份標,請參考開通驗證碼服務。初始化請求成功之後的返回應如下圖所示:

image.png

如果初始化介面會返回失敗,下表為各個失敗返回結果的說明和對應的排查建議:

錯誤Code

原因說明及排查建議

IllegalUserTag

身份標(prefix)傳參不合法。參考開通驗證碼服務確認該參數是否正確傳入。

重要

IllegalUserTag僅適用Web和H5用戶端接入App用戶端接入,不適用微信小程式接入。

IllegalCertifyId

客戶自訂產生的certifyId(UserCertifyId)傳參格式不合法。請確認參數格式標準為:身份標(prefix)_10位隨機字串(包含大小寫字母和數字),程式碼範例詳見UserCertifyId參數程式碼範例

IllegalScene

情境ID(SceneId)傳參不合法。請確認傳入的情境ID參數是否正確,確保該情境ID為身份標(prefix)關聯的帳號下建立。

Forbidden.AccountAccessDenied

使用者帳號欠費。請確認帳號狀態是否正常。

Throttling

介面限流,超過產品支援QPS。如需更高業務容量,可購買擴容 QPS下單後不會立即生效,請至少提前2天聯絡客戶經理進行溝通和配置。

ThrottlingByStrategy

初始化請求限速,對攻擊者頻繁請求遍曆驗證碼題庫行為進行阻斷。

欄位

報錯內容

通用類型校正

傳入參數類型不合法,請參見參數說明傳入對應類型的值。

language

language參數傳入值不合法,請參見驗證碼2.0支援的語言

region

region參數傳入值不合法,請參見region參數說明檢查此參數是否符合要求。

mode

mode參數傳入值不合法,目前支援彈出式(popup)和嵌入式(embed)。請參見mode參數說明檢查此參數是否符合要求。

element/button

element/button參數傳入值不合法,請確保element/button元素在頁面中存在,且element/button參數和頁面上的element/button元素的ID選取器相匹配。