
API 設計原理:從理論到實踐
在移動互聯網與企業級應用場景中,騰訊云短信服務(Tencent Cloud SMS API)憑借其電信級穩定性、超高并發能力和全球覆蓋優勢,成為多行業短信通知、驗證碼和營銷觸達的首選解決方案。
TencentCloudSMSFullAccess
)。{1}
、{2}
。接口描述:單條或批量發送國內及國際/港澳臺短信。
關鍵參數:
參數 | 含義 |
---|---|
PhoneNumberSet |
接收者號碼數組,國內不需要加區號,國際需加“+國家碼” |
SmsSdkAppId |
應用 ID,在控制臺應用管理中獲取 |
SignName |
簽名,與控制臺審核后簽名一致 |
TemplateId |
模板 ID,與控制臺模板管理中一致 |
TemplateParamSet |
模板變量數組,如驗證碼 ["123456"] |
SessionContext |
用戶側透傳信息,可用于接收回執時關聯 |
from tencentcloud.sms.v20190711 import sms_client, models
client = sms_client.SmsClient(cred, "ap-guangzhou")
req = models.SendSmsRequest(
PhoneNumberSet=["+8613800000000"],
SmsSdkAppId="1400000123",
SignName="騰訊云",
TemplateId="123456",
TemplateParamSet=["654321"]
)
resp = client.SendSms(req)
print(resp.SendStatusSet[0].Code) # "Ok" 表示調用成功,并已發往運營商
> SEO提示:在示例代碼注釋和段落中增加“SendSms Python 示例”、“騰訊云 SMS Java SDK 使用” 等關鍵詞。
接口描述:查詢短信投遞狀態、運營商回執結果和用戶上行內容。
調用示例:
from tencentcloud.sms.v20190711 import sms_client, models
client = sms_client.SmsClient(cred, "ap-guangzhou")
req = models.PullSmsSendStatusRequest(
Limit=10,
SmsSdkAppId="1400000123",
SendDate=20250709 # YYYYMMDD
)
resp = client.PullSmsSendStatus(req)
for status in resp.PullSmsSendStatusSet:
print(status.PhoneNumber, status.UserReceiveTime, status.Code)
Code == "SUCCESS"
表示短信投遞并被終端設備接收> 長尾關鍵詞提示:結合“QuerySendDetails 接口文檔”、“短信投遞狀態查詢”進行自然鋪排。
RequestLimitExceeded
錯誤并自動重試。SmsReport
主題,實時消費回執 JSON:{
"phone": "+8613800000000",
"reportStatus": "SUCCESS",
"errMsg": "",
"nationCode": "86",
"userReceiveTime": "2025-07-09T10:15:23Z",
"sessionContext": "user-defined"
}
errMsg
,剔除空號、停機號碼,減少無效調用。┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ 應用服務 │ ──> │ 短信網關 │ ──> │ 騰訊云 SMS API │
└─────────────┘ └─────────────┘ └─────────────┘
│ │
│ < ───────── MNS 回調/HTTP 回調 ───────────┘
sendVerification()
、sendNotification()
方法,入參手機號、模板變量。通過本文,你已系統掌握 騰訊云短信服務(Tencent Cloud SMS API):
原文引自YouTube視頻:https://www.youtube.com/watch?v=JdXfRTYlVR4