小影API 小影API

短信驗證

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

/api/sms_verify/

服務說明

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

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

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

響應格式

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

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

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

維護中 該服務當前處於「維護中」狀態，接口可能臨時不可用。以下文檔與調試僅供了解。

阿里雲短信驗證碼

阿里雲號碼認證服務（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 秒）後再試。
響應說明 外層統一格式
字段 類型 說明
biz_id string 阿里雲發送流水號
out_id string 外部流水號（透傳返回）
verify_code string 驗證碼，僅開啟返回時有值
返回示例 
{"biz_id": "9006197469364984400", "out_id": "", "verify_code": ""}
POST /api/sms_verify/aliyun/check 累計調用 0 次

核驗短信驗證碼

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

11 位手機號（必填）

手機收到的驗證碼（必填）

選填：默認 1（不區分大小寫）

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

選填：外部流水號（透傳返回）

  • 接口請求成功統一返回 code=10000；業務結果以 data.verify_result 判斷：
  • PASS=核驗成功，UNKNOWN=核驗失敗（驗證碼錯誤或已過期）。
響應說明 外層統一格式
字段 類型 說明
verify_result string 核驗結果：PASS/UNKNOWN
passed bool 是否核驗通過
out_id string 外部流水號（透傳返回）
返回示例 
{"verify_result": "PASS", "passed": true, "out_id": ""}
小影API · 通用 API 聚合服務