短信驗證

短信驗證碼能力:阿里雲號碼認證發送與核驗,服務端生成/校驗驗證碼,防短信轟炸。當前接入阿里雲線路。

/api/sms_verify/

服務說明

短信驗證服務基於阿里雲號碼認證能力,由服務端完成驗證碼的生成、下發與核驗:先調發送接口向手機號下發驗證碼,用戶輸入後再調核驗接口判斷是否正確或已過期。

接入方可自定義驗證碼長度、有效時長、重複發送策略與頻控間隔(默認 60 秒),用於防止短信被刷;核驗在阿里雲側完成,調用方無需自己存儲和比對驗證碼。

全部接口需項目簽名,且請求體為 application/x-www-form-urlencoded 表單,不使用 JSON body。

阿里雲短信驗證碼

阿里雲號碼認證服務(Dypnsapi) 需簽名

發送驗證碼由阿里雲系統動態生成並完成核驗;全部接口需接入項目簽名,防短信被濫用。

POST /api/sms_verify/aliyun/send 累計調用 0 次

發送短信驗證碼

向指定手機號發送短信驗證碼;驗證碼有效期、頻控間隔等可配。

11 位手機號(必填)

選填:4-8,默認 4

選填:驗證碼有效時長,默認 300 秒(5 分鐘)

選填:默認 1(覆蓋舊碼)

選填:頻控間隔,默認 60 秒(防短信轟炸)

選填:1-7(1=純數字),默認 1

選填:僅測試場景建議開啟 true,便於直接取碼核驗

選填:留空使用阿里雲默認方案

選填:外部流水號(透傳返回)

  • 請求體為 application/x-www-form-urlencoded 表單;本服務需項目簽名(app_id/timestamp/nonce/sign)。
  • 發送成功即返回 code=10000;頻控觸發時提示等待(interval 秒)後再試。
POST /api/sms_verify/aliyun/check 累計調用 0 次

核驗短信驗證碼

核驗用戶輸入的驗證碼是否正確/是否過期。

11 位手機號(必填)

手機收到的驗證碼(必填)

選填:默認 1(不區分大小寫)

選填:須與發送驗證碼時一致,留空使用默認方案

選填:外部流水號(透傳返回)

  • 接口請求成功統一返回 code=10000;業務結果以 data.verify_result 判斷:
  • PASS=核驗成功,UNKNOWN=核驗失敗(驗證碼錯誤或已過期)。
小影API · 通用 API 聚合服務