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