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

一、接口總覽

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

二、核心功能簡(jiǎn)述

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

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

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

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

5. 模板管理

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

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

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

下載語(yǔ)音通知API接口文檔