AIP接口
Api Interface
API接口是面向有一定技術開發能力的企業用戶而單獨研 發的短信(sms)接口,可以方便的對接到企業用 戶公司內部系 統中。本接口采用了通用的HTTP協議,可以支持各種操作系統和 開發語言,同時我們在接口文檔中為 您提供了各種開發語言的例 子代碼。在您購買了API版短信平臺并通過簡單的測試后,即可把 短信接口嵌入到您公司 自己的系統中,快速擁有短信發送應用, 完善您的企業服務。
用戶通過HTTP的POST方式提交短信發送請求。編碼采用UTF-8編碼。
序號 | 參數 | 說明 |
---|---|---|
1 | name | (必填參數)用戶賬號 |
2 | pwd | (必填參數)web平臺:基本資料中的接口密碼 |
3 | content | (必填參數)發送內容(1-500 個漢字)UTF-8編碼 |
4 | mobile | (必填參數)手機號碼。多個以英文逗號隔開 |
5 | stime | (可選參數)發送時間,填寫時已填寫的時間發送,不填時為當前時間發送 |
6 | sign | (必填參數)用戶簽名 |
7 | type | (必填參數)固定值pt |
8 | extno | (可選參數)擴展碼,用戶定義擴展碼,只能為數字 |
用戶短信通過http請求提交到服務器后,服務器返回響應碼,響應碼的格式如下:
code,sendid,invalidcount,successcount,blackcount,msg
1.1.1 格式說明
短信提交響應為英文逗號隔開的一行數據,狀態,發送編號,無效號碼數,成功提交數,黑名單數和消息,無 論發送的 號碼是多少,一個發送請求只返回一個sendid,如果響應的狀態不是“0”,則只有狀態和 消息。
1.1.2 示例
提交成功
0, 20130821110353234137876543,0,500,0,提交成功
20130821110353234137876543為返回的sendid,這個工狀態報告匹配時使用。
提交失敗
1、含有敏感詞匯
本示例表明用戶提交失敗,返回錯誤碼為1,服務器端并未返回sendid等。
1.1.3 響應狀態值說明
代碼 | 說明 |
---|---|
0 | 提交成功 |
1 | 含有敏感詞匯 |
2 | 余額不足 |
3 | 沒有號碼 |
4 | 含有spl語句 |
10 | 賬戶不存在 |
11 | 賬號注銷 |
12 | 賬戶停用 |
13 | IP鑒權失敗 |
14 | 格式錯誤 |
-1 | 系統異常 |