統一咨詢熱線:400-6889-015
普通短信發送 個性短信發送 狀态報告發送 上行回複 餘額查詢

AIP接口

Api Interface

短信提交方式

用戶通過HTTP的POST方式提交短信發送請求。編碼采用UTF-8編碼。

短信提交地址

URL地址爲:http://xxx:port/sms/apiSend/addGx

參數定義
序号 參數 說明
1 account (必填參數)用戶賬号
2 password (必填參數)接口密碼:web平台中的接口密碼
3 content (必填參數)發送内容,需要進行UTF-8編碼,建議每次1000個 格式:格式:内容!@!号碼!@@!内容!@!号碼,例如content=内容1!@!13566677777!@@!内容2!@!18655555555
4 sendTime 可選參數。發送時間,填寫時按照此時間發送,不填時爲當前時間發送(格式:yyyy-MM-dd HH:mm:ss)
5 productId (必填參數)産品編碼
短信提交響應

用戶短信通過http請求提交到服務器後,服務器返回響應碼,響應碼的格式如下:

result: {
"ok": true,
"message": "ok",
"result": {
"blackCount": 1, // 黑名單号碼數
"batchNo": "201908261135000000465", // 批次号
"balance": 2, // 餘額
"normalCount": 1, // 正常号碼數
"unidentifiedCount": 0, // 不能識别運營商号碼數
} }

1.1.1 格式說明

短信提交後的響應結果爲JSON串數據,ok爲true時表示提交成功,爲false時表示提交失敗,message爲具體原因。接口方式提交建議每次請求提交的号碼量不超過兩萬, 請求成功後服務端成功接收到該批号碼和内容信息,并返回一個唯一批次号,當用戶提交失敗時,ok爲false,服務端無批次号信息返回。

1.1.2響應狀态值說明

參數 說明
ok true 表示接收成功;false 表示接收失敗
message 服務端接收成功時爲OK,接收失敗時爲具體失敗原因
blackCount 黑名單号碼數
batchNo 批次号,每次請求成功接口都會返回一 個唯一的批次号
balance 此産品的餘額
unidentifiedCount 不能識别運營商号碼數
normalCount 正常号碼數量
普通短信發送 個性短信發送 狀态報告 上行回複 餘額查詢