微信截圖_17363901826052.png)
API 設(shè)計原理:從理論到實踐
在移動互聯(lián)網(wǎng)與企業(yè)級應(yīng)用場景中,騰訊云短信服務(wù)(Tencent Cloud SMS API)憑借其電信級穩(wěn)定性、超高并發(fā)能力和全球覆蓋優(yōu)勢,成為多行業(yè)短信通知、驗證碼和營銷觸達(dá)的首選解決方案。
TencentCloudSMSFullAccess
)。{1}
、{2}
。接口描述:單條或批量發(fā)送國內(nèi)及國際/港澳臺短信。
關(guān)鍵參數(shù):
參數(shù) | 含義 |
---|---|
PhoneNumberSet |
接收者號碼數(shù)組,國內(nèi)不需要加區(qū)號,國際需加“+國家碼” |
SmsSdkAppId |
應(yīng)用 ID,在控制臺應(yīng)用管理中獲取 |
SignName |
簽名,與控制臺審核后簽名一致 |
TemplateId |
模板 ID,與控制臺模板管理中一致 |
TemplateParamSet |
模板變量數(shù)組,如驗證碼 ["123456"] |
SessionContext |
用戶側(cè)透傳信息,可用于接收回執(zhí)時關(guān)聯(lián) |
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" 表示調(diào)用成功,并已發(fā)往運營商
> SEO提示:在示例代碼注釋和段落中增加“SendSms Python 示例”、“騰訊云 SMS Java SDK 使用” 等關(guān)鍵詞。
接口描述:查詢短信投遞狀態(tài)、運營商回執(zhí)結(jié)果和用戶上行內(nèi)容。
調(diào)用示例:
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"
表示短信投遞并被終端設(shè)備接收> 長尾關(guān)鍵詞提示:結(jié)合“QuerySendDetails 接口文檔”、“短信投遞狀態(tài)查詢”進(jìn)行自然鋪排。
RequestLimitExceeded
錯誤并自動重試。SmsReport
主題,實時消費回執(zhí) JSON:{
"phone": "+8613800000000",
"reportStatus": "SUCCESS",
"errMsg": "",
"nationCode": "86",
"userReceiveTime": "2025-07-09T10:15:23Z",
"sessionContext": "user-defined"
}
errMsg
,剔除空號、停機(jī)號碼,減少無效調(diào)用。┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ 應(yīng)用服務(wù) │ ──> │ 短信網(wǎng)關(guān) │ ──> │ 騰訊云 SMS API │
└─────────────┘ └─────────────┘ └─────────────┘
│ │
│ < ───────── MNS 回調(diào)/HTTP 回調(diào) ───────────┘
sendVerification()
、sendNotification()
方法,入?yún)⑹謾C(jī)號、模板變量。通過本文,你已系統(tǒng)掌握 騰訊云短信服務(wù)(Tencent Cloud SMS API):
原文引自YouTube視頻:https://www.youtube.com/watch?v=JdXfRTYlVR4