手把手教你使用阿里云短信服務API發送短信驗證碼

在當今的互聯網應用中，短信驗證碼是驗證用戶身份、保障賬戶安全的關鍵環節。阿里云短信服務（Dysmsapi）以其高可用性、高并發能力和完善的管理控制臺，成為眾多開發者的首選。本文將帶你從零開始，一步步完成阿里云短信接口的配置與調用，實現短信驗證碼的發送。

第一步：前期準備與賬號配置

注冊與實名認證：訪問阿里云官網（aliyun.com）完成賬號注冊，并進行個人或企業實名認證。這是使用所有云服務的基礎。
開通短信服務：在阿里云控制臺，搜索并進入“短信服務”產品頁面，閱讀協議后開通服務。
獲取訪問密鑰：鼠標懸停在控制臺右上角頭像，進入“AccessKey管理”頁面。強烈建議創建并使用子用戶AccessKey（RAM用戶），并為其分配管理短信服務的權限（如AliyunDysmsFullAccess），這比直接使用主賬號密鑰更安全。請妥善保管你的AccessKey ID和AccessKey Secret。
申請簽名與模板：

簽名：在短信服務控制臺的“國內消息”或“國際/港澳臺消息”中，申請“簽名”。簽名是顯示在短信開頭【】中的標識，用于標識發送方。例如【你的APP名】。根據用途（如驗證碼、通知、推廣）提供相應的資質證明（如網站備案截圖、APP下載頁截圖等）進行審核。

* 模板：申請“模板”。短信模板是發送內容的具體格式，其中驗證碼部分用變量${code}表示。例如：“您的驗證碼為${code}，該驗證碼5分鐘內有效，請勿泄露。” 模板同樣需要審核。
審核通過后，記錄下你的簽名名稱和模板CODE。

第二步：核心代碼實現（以Python為例）

阿里云提供了多種語言的SDK，這里以Python為例。你可以通過pip安裝核心庫：pip install alibabacloud_dysmsapi20170525。

`python # 發送短信驗證碼示例

from alibabaclouddysmsapi20170525.client import Client
from alibabaclouddysmsapi20170525 import models
from alibabacloudteaopenapi import models as openapimodels
from alibabacloudteautil import models as utilmodels
from alibabacloudtea_util.client import Client as UtilClient
import random

def sendsms(phonenumber, code):
"""
發送短信驗證碼
:param phone_number: 接收手機號，國內號碼需帶國家代碼86，如 8613800138000
:param code: 6位隨機數字驗證碼
:return: 發送結果
"""
# 1. 配置訪問密鑰（請替換為你的真實密鑰）

config = openapimodels.Config(
accesskeyid='youraccesskeyid', # 你的AccessKey ID
accesskeysecret='youraccesskeysecret' # 你的AccessKey Secret
)
config.endpoint = 'dysmsapi.aliyuncs.com' # 服務接入點

2. 初始化客戶端

client = Client(config)

3. 構建請求參數

sendrequest = models.SendSmsRequest(
phonenumbers=phonenumber, # 接收方手機號
signname='你的簽名名稱', # 控制臺審核通過的簽名
templatecode='SMS123456789', # 控制臺審核通過的模板CODE
template_param=f'{{"code":"{code}"}}' # 模板變量JSON字符串，對應模板中的${code}
)

try:
# 4. 發起調用

response = client.sendsms(sendrequest)
# 5. 處理響應

if response.body.code == 'OK':
print(f"短信發送成功！請求ID: {response.body.request_id}")
return True
else:
print(f"短信發送失敗！錯誤碼: {response.body.code}, 錯誤信息: {response.body.message}")
return False
except Exception as e:
print(f"調用接口時發生異常: {e}")
return False

使用示例：生成6位隨機驗證碼并發送

def main():
phone = '8613800138000' # 示例手機號
verificationcode = ''.join(random.choices('0123456789', k=6)) # 生成6位隨機數
print(f"生成的驗證碼是: {verificationcode}")
success = sendsms(phone, verificationcode)
if success:
# 在實際應用中，這里應將驗證碼與手機號、時間戳關聯并存入緩存（如Redis），設置5分鐘過期

print("驗證碼已發送，請提醒用戶查收。")
else:
print("發送失敗，請檢查配置或重試。")

if name == 'main':
main()
`

第三步：關鍵要點與最佳實踐

安全存儲密鑰：切勿將AccessKey硬編碼在客戶端或公開的代碼倉庫中。在服務器端應用中，應通過環境變量或配置中心讀取。
驗證碼管理：發送成功后，務必在服務端將驗證碼（或哈希值）與手機號、發送時間綁定，存儲于Redis等高速緩存中，并設置合理的過期時間（如5分鐘）。用戶提交驗證碼時，進行比對驗證。
頻率限制與防刷：在業務邏輯層對同一手機號的發送頻率做嚴格限制（如60秒內只能發送一次，24小時內不超過10次），防止惡意刷短信導致資損和騷擾用戶。
錯誤處理：關注響應中的Code字段。常見的錯誤如isv.BUSINESS<em>LIMIT</em>CONTROL（業務限流）、isv.MOBILE<em>NUMBER</em>ILLEGAL（非法手機號）等，需要在前端或日志中給出友好提示。
監控與告警：在阿里云控制臺關注短信發送成功率、失敗明細，并可以設置閾值告警，以便及時發現問題。