短信群發

小獅子網站logo

客戶接口說明

客戶接口說明................................................................................................................... 1
第一章  發送接口..................................................................................................... 2
1.1 請求地址..................................................................................................... 2
1.2參數說明...................................................................................................... 2
1.3返回值.......................................................................................................... 2
第二章 余額及已發送量查詢接口.............................................................................. 3
2.1 請求地址..................................................................................................... 3
2.2參數說明...................................................................................................... 3
2.3返回值.......................................................................................................... 3
第三章 非法關鍵詞查詢............................................................................................ 4
3.1 請求地址..................................................................................................... 4
3.2參數說明...................................................................................................... 4
3.3返回值.......................................................................................................... 4
第四章 狀態報告接口............................................................................................... 5
4.1 請求地址..................................................................................................... 5
4.2參數說明...................................................................................................... 5
4.3返回值.......................................................................................................... 5
4.4錯誤返回值——狀態報告請求錯誤返回格式及對應值.................................... 6
第五章 上行接口...................................................................................................... 6
5.1 請求地址..................................................................................................... 6
5.2參數說明...................................................................................................... 6
5.3返回值.......................................................................................................... 7
5.4錯誤返回值——回復請求錯誤返回格式及對應值........................................... 7
 
 
 
 
接口說明:客戶接口部分提供http url方式的接口,根據客戶需求可以提供相應接口,接口編碼方式采用統一的UTF-8

第一章  發送接口

1.1 請求地址

請求地址是客戶接口程序調用時請求的url地址,采用的是http post 接口,地址是
http://*****:port/sms.aspx 對應UTF-8
http://*****:port/smsGBK.aspx 對應GB2312
入口地址一般不會發生變化,當發生變化的時候,會通知接口用戶   

1.2參數說明

http://*****:port/sms.aspx
http://*****:port/smsGBK.aspx
 

參數名稱 含義 說明
userid 企業id 企業ID
account 發送用戶帳號 用戶帳號,由系統管理員
password 發送帳號密碼 用戶賬號對應的密碼
mobile 全部被叫號碼 發信發送的目的號碼.多個號碼之間用半角逗號隔開
content 發送內容 短信的內容,內容需要UTF-8編碼
sendTime 定時發送時間 為空表示立即發送,定時發送格式2010-10-24 09:08:10
action 發送任務命令 設置為固定的:send
extno 擴展子號 請先詢問配置的通道是否支持擴展子號,如果不支持,請填空。子號只能為數字,且最多5位數。
例如:
action=send&userid=12&account=賬號&password=密碼&mobile=15023239810,13527576163&content=內容&sendTime=&extno=

1.3返回值

在接收到客戶端發送的http請求后,返回以xml的方式返回處理結果。格式為:
 
<?xml version="1.0" encoding="utf-8" ?>
<returnsms>
<returnstatus>status</returnstatus> ---------- 返回狀態值:成功返回Success 失敗返回:Faild
<message>message</message> ---------- 返回信息:見下表
<remainpoint> remainpoint</remainpoint> ---------- 返回余額
 
<taskID>taskID</taskID>  -----------  返回本次任務的序列ID
<successCounts>successCounts</successCounts> --成功短信數:當成功后返回提交成功短信數
</returnsms>
 

返回信息提示 說明
ok 提交成功
用戶名或密碼不能為空 提交的用戶名或密碼為空
發送內容包含sql注入字符 包含sql注入字符
用戶名或密碼錯誤 表示用戶名或密碼錯誤
短信號碼不能為空 提交的被叫號碼為空
短信內容不能為空 發送內容為空
包含非法字符: 表示檢查到不允許發送的非法字符
對不起,您當前要發送的量大于您當前余額 當支付方式為預付費是,檢查到賬戶余額不足
其他錯誤 其他數據庫操作方面的錯誤
 

第二章 余額及已發送量查詢接口

2.1 請求地址

請求地址是客戶接口程序調用的時候請求的url地址,采用的是http post接口,地址是
http://*****:port/sms.aspx
http://*****:port/smsGBK.aspx
入口地址一般不會發生變化,當發生變化的時候,會通知接口用戶   

2.2參數說明

參數名稱 含義 說明
userid 企業id 企業ID
account 用戶帳號 用戶帳號,由系統管理員
password 帳號密碼 用戶賬號對應的密碼
action 任務名稱 設置為固定的:overage
例如:
action=overage&userid=12&account=賬號&password=密碼

2.3返回值

<?xml version="1.0" encoding="utf-8" ?>
<returnsms>
<returnstatus>status</returnstatus>-------返回狀態值:成功返回Success 失敗返回:Faild
<message>message</message>--------------返回信息提示:見下表
<payinfo>payinfo</payinfo>--------------返回支付方式  后付費,預付費
<overage>overage</overage>-------------返回余額
<sendTotal>sendTotal</sendTotal>----返回總點數  當支付方式為預付費是返回總充值點數
</returnsms>
 

返回信息提示 說明
返回空 查詢成功
將返回相應的支付方式、賬戶使用條數、總充值點數
用戶名或密碼不能為空 提交的用戶名或密碼為空
用戶名或密碼錯誤 表示用戶名或密碼錯誤
 
 

第三章 非法關鍵詞查詢

3.1 請求地址

請求地址是客戶接口程序調用的時候請求的url地址,采用的是http post接口,地址是
http://*****:port/sms.aspx
http://*****:port/smsGBK.aspx
入口地址一般不會發生變化,當發生變化的時候,會通知接口用戶   

3.2參數說明

參數名稱 含義 說明
userid 企業id 企業ID
account 用戶帳號 用戶帳號,由系統管理員
password 帳號密碼 用戶賬號對應的密碼
action 任務名稱 設置為固定的:checkkeyword
content 檢測發送內容 需要發送的內容
例如:
action=checkkeyword&userid=12&account=賬號&password=密碼&content=內容

3.3返回值

<?xml version="1.0" encoding="utf-8" ?>
<returnsms>
<message>message</message>--------------返回信息提示:見下表
</returnsms>
 

返回信息提示 說明
用戶名或密碼不能為空 提交的用戶名或密碼為空
用戶名或密碼錯誤 表示用戶名或密碼錯誤
包含非法字符 檢查出來包含非法關鍵詞
未包含非法字符 未檢查出非法關鍵詞
 
 
 

第四章 狀態報告接口

4.1 請求地址

請求地址是客戶接口程序調用的時候請求的url地址,采用的是http post接口,地址是
http://*****:port/statusApi.aspx
入口地址一般不會發生變化,當發生變化的時候,會通知接口用戶   

4.2參數說明

參數名稱 含義 說明
userid 企業id 企業ID
account 用戶帳號 用戶帳號,由系統管理員
password 帳號密碼 用戶賬號對應的密碼
action 任務名稱 設置為固定的:query
例如:
action=query&userid=12&account=賬號&password=密碼

4.3返回值

<?xml version="1.0" encoding="utf-8" ?>
<returnsms>
<statusbox>
<mobile>15023239810</mobile>-------------對應的手機號碼
<taskid>1212</taskid>-------------同一批任務ID
<status>10</status>---------狀態報告----10:發送成功,20:發送失敗
<receivetime>2011-12-02 22:12:11</receivetime>-------------接收時間
<errorcode>DELIVRD</errorcode>-上級網關返回值,不同網關返回值不同,僅作為參考
</statusbox>
<statusbox>
<mobile>15023239811</mobile>
<taskid>1212</taskid>
<status>20</status>
<receivetime>2011-12-02 22:12:11</receivetime>
<errorcode>2</errorcode>
</statusbox>
</returnsms>

4.4錯誤返回值——狀態報告請求錯誤返回格式及對應值

<?xml version="1.0" encoding="utf-8" ?>
<returnsms>
<errorstatus>
<error>1</error>-------------錯誤碼
<remark>用戶名或密碼不能為空</remark>-------------錯誤描述
</errorstatus>
</returnsms>
1:用戶名或密碼不能為空
2:用戶名或密碼錯誤
3:該用戶不允許查看狀態報告
4:參數不正確

第五章 上行接口

5.1 請求地址

請求地址是客戶接口程序調用的時候請求的url地址,采用的是http post接口,地址是
http://*****:port/callApi.aspx
入口地址一般不會發生變化,當發生變化的時候,會通知接口用戶   

5.2參數說明

參數名稱 含義 說明
userid 企業id 企業ID
account 用戶帳號 用戶帳號,由系統管理員
password 帳號密碼 用戶賬號對應的密碼
action 任務名稱 設置為固定的:query
例如:
action=query&userid=12&account=賬號&password=密碼

5.3返回值

<?xml version="1.0" encoding="utf-8" ?>
<returnsms>
<callbox>
<mobile>15023239810</mobile>-------------對應的手機號碼
<taskid>1212</taskid>-------------同一批任務ID
<content>你好,我不需要</content>---------上行內容
<receivetime>2011-12-02 22:12:11</receivetime>-------------接收時間
</callbox>
<callbox>
<mobile>15023239811</mobile>
<taskid>1212</taskid>
<content>你好,本次活動路線是怎么的</content>
<receivetime>2011-12-02 22:12:11</receivetime>
</callbox>
</returnsms>

5.4錯誤返回值——回復請求錯誤返回格式及對應值

<?xml version="1.0" encoding="utf-8" ?>
<returnsms>
<errorstatus>
<error>1</error>-------------錯誤碼
<remark>用戶名或密碼不能為空</remark>-------------錯誤描述
</errorstatus>
</returnsms>
1:用戶名或密碼不能為空
2:用戶名或密碼錯誤
3:該用戶不允許查看狀態報告
4:參數不正確
 
 
 
 

分支機構
  • 馬來西亞
  • 菲律賓
  • 澳大利亞
  • 新西蘭
  • 法國
  • 泰國
快速導航
免費咨詢電話:
  • 13381158046
掃一掃:

?北京小獅子網絡技術有限公司專業為客戶提供短信群發,短信群發平臺,群發短信等服務,是中國領先的移動聯通電信三網商務服務商:010-57302052

北京小獅子網絡技術有限公司 客服電話:13381158046 EMAIL:[email protected] 京ICP備14053319號-1

篮球比分牌