短信通知API接口文檔用于指導(dǎo)開發(fā)者通過 HTTP 協(xié)議調(diào)用互億無線的短信服務(wù)接口，實現(xiàn)短信通知發(fā)送、余額查詢、回執(zhí)推送等功能。

一、接口總覽

• 接口類型：短信單條發(fā)送、批量發(fā)送、余額查詢、回執(zhí)推送、上行回復(fù)推送、模板提交與刪除。
• 請求方式：支持 GET 和 POST 提交，建議使用 HTTPS。
• 加密方式：采用 MD5 動態(tài)簽名 + HTTPS 協(xié)議保障數(shù)據(jù)安全。
• 身份認(rèn)證：需使用平臺獲取的 API ID 和 API KEY。

二、核心功能簡述

1. 短信發(fā)送
單條發(fā)送接口：支持 POST/GET 請求，支持自定義短信內(nèi)容與簽名，發(fā)送結(jié)果實時返回。
批量發(fā)送接口：支持最多 5000 個手機(jī)號一次提交，可選擇模板或變量內(nèi)容自動匹配。

2. 余額查詢
提供短信條數(shù)查詢接口，可實時獲取賬戶剩余短信量，支持 XML 或 JSON 格式響應(yīng)。

3. 回執(zhí)推送
支持回執(zhí)狀態(tài)自動推送，用戶需提供接收地址，接收成功需返回 "success" 字符。

4. 上行回復(fù)推送
支持接收用戶回復(fù)的短信內(nèi)容，用于互動場景，推送方式同回執(zhí)。

5. 模板管理

• 提交模板：可通過接口提交短信模板，需指定內(nèi)容、類型和使用場景，提交后等待審核。
• 刪除模板：支持通過模板 ID 刪除已提交模板。
• 審核狀態(tài)推送：模板審核結(jié)果會以 POST 推送方式通知開發(fā)者。

三、模板與簽名規(guī)范

• 短信模板：必須使用平臺審核通過的格式，變量部分用【變量】標(biāo)識。
• 短信簽名：每條短信內(nèi)容必須包含簽名（如【互億無線】），未認(rèn)證賬號僅限使用默認(rèn)簽名。

下載語音通知API接口文檔