AIP接口
Api Interface
短信提交方式
用戶通過HTTP的POST方式提交短信發(fā)送請求。編碼采用UTF-8編碼。
短信提交地址
參數(shù)定義
| 序號 | 參數(shù) | 說明 |
|---|---|---|
| 1 | account | （必填參數(shù)）用戶賬號 |
| 2 | password | （必填參數(shù)）接口密碼：web平臺中的接口密碼 |
| 3 | content | （必填參數(shù)）發(fā)送內(nèi)容，需要進(jìn)行UTF-8編碼，建議每次1000個(gè) 格式：格式：內(nèi)容!@!號碼!@@!內(nèi)容!@!號碼，例如content=內(nèi)容1!@!13566677777!@@!內(nèi)容2!@!18655555555 |
| 4 | sendTime | 可選參數(shù)。發(fā)送時(shí)間，填寫時(shí)按照此時(shí)間發(fā)送，不填時(shí)為當(dāng)前時(shí)間發(fā)送（格式：yyyy-MM-dd HH:mm:ss） |
| 5 | productId | （必填參數(shù)）產(chǎn)品編碼 |
短信提交響應(yīng)
用戶短信通過http請求提交到服務(wù)器后，服務(wù)器返回響應(yīng)碼，響應(yīng)碼的格式如下：
result： {
"ok": true,
"message": "ok",
"result": {
"blackCount": 1, // 黑名單號碼數(shù)
"batchNo": "201908261135000000465", // 批次號
"balance": 2, // 余額
"normalCount": 1, // 正常號碼數(shù)
"unidentifiedCount": 0, // 不能識別運(yùn)營商號碼數(shù)
} }
1.1.1 格式說明
短信提交后的響應(yīng)結(jié)果為JSON串?dāng)?shù)據(jù)，ok為true時(shí)表示提交成功，為false時(shí)表示提交失敗，message為具體原因。接口方式提交建議每次請求提交的號碼量不超過兩萬， 請求成功后服務(wù)端成功接收到該批號碼和內(nèi)容信息，并返回一個(gè)唯一批次號，當(dāng)用戶提交失敗時(shí)，ok為false，服務(wù)端無批次號信息返回。
1.1.2響應(yīng)狀態(tài)值說明
| 參數(shù) | 說明 |
|---|---|
| ok | true 表示接收成功；false 表示接收失敗 |
| message | 服務(wù)端接收成功時(shí)為OK，接收失敗時(shí)為具體失敗原因 |
| blackCount | 黑名單號碼數(shù) |
| batchNo | 批次號，每次請求成功接口都會返回一 個(gè)唯一的批次號 |
| balance | 此產(chǎn)品的余額 |
| unidentifiedCount | 不能識別運(yùn)營商號碼數(shù) |
| normalCount | 正常號碼數(shù)量 |
普通短信發(fā)送
個(gè)性短信發(fā)送
狀態(tài)報(bào)告
上行回復(fù)
余額查詢
皖公網(wǎng)安備 34019202000774號