API接口-普通短信發送

Api Interface

API接口

博彩担保评级短信API接口是麵向有一定技術開發能力的企業用戶而單獨研發的短信(sms)接口,可以方便的對接到企業用戶公司內部係統中。本接口采用了通用的HTTP協議,可以支持各種操作係統和開發語言,同時博彩担保评级在接口文檔中為您提供了各種開發語言的例子代碼。在您購買了API版短信平台並通過簡單的測試後,即可把短信接口嵌入到您公司自己的係統中,快速擁有短信發送應用,完善您的企業服務。

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

短信提交地址

URL地址為:http://web.fopqxl.com/asmx/smsservice.aspx

參數定義

序號 參數 說明
1 name (必填參數)用戶賬號
2 pwd (必填參數)web平台:基本資料中的接口密碼
3 content (必填參數)發送內容(1-500 個漢字)UTF-8編碼
4 mobiles (必填參數)手機號碼。多個以英文逗號隔開
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 係統異常

短信發送例子

http://web.fopqxl.com/asmx/smsservice.aspx?name=test&pwd=112345&content=testmsg&mobiles=13512345678,13811112222&stime=2013-04-11 8:20:23&sign=testsign&type=pt&extno=

短信API接口demo下載