登 錄 注冊試用
4000-111-502
網站公告:五一鉅惠季,充值送大禮!
API接口 您當前所在位置:首頁 > API接口

API接口說明:

1.我們提供基于http和cmpp的接口文檔,支持Php、.net、Java、c+等語言類接口;

2. 如要技術對接的請聯系客服qq:27371688



一、發送模板短信

1. 接口地址

請求類型

請求url

http請求方式:POST(請使用http協議)

http://api.duanxinke.com/msg/template

post數據請求示例

 {

  "uid":"123",

      "account":"賬號",

"pwd":"密碼",

      "mobile":"XXXXXXXXXXX,XXXXXXXXXXX",

"company":"短信客"  //簽名

      "tpl_id":"111"  //您申請的短信模板ID

"tpl_value":"XXXX,XXXX"  //變量值

  }

2. 發送短信接口參數說明

參數名稱

說明

uid

企業id

account

用戶帳號,由系統管理員提供

pwd

賬號對應的密碼

mobile

手機號(多個手機號請用英文,隔開-例如:XXXXXXXXXXX,XXXXXXXXXXX),最多50000個號碼

company

短信簽名

tpl_id

短信模板id(將您需要的模板發給系統管理員,模板格式示例:您的驗證碼{#var},該驗證碼{#var}分鐘內有效,請勿泄漏于他人!,{#var}為變量)

tpl_value

變量值多個變量按照先后順序用英文,隔開-例如:XXXXXXXXXXX,XXXXXXXXXXX)

 

3. 發送短信響應包參數說明

失敗返回數據:

{"status":0,"message":"提交失敗","respCode":"失敗id","respMsg":"失敗原因","msgid":"","successCounts":0}

成功返回數據:

{"status":1,"message":"提交成功""respCode":"0","respMsg":"提交成功","msgid":"msgid號","successCounts":"提交成功的短信數"}

4. 返回值參數說明

respCode返回值

含義

0

提交成功

1

uidpwdaccount為空或錯誤

2

手機號為空

3

內容超過250個字

4

手機號錯誤

5

余額不足

6

手機號數量超過50000個

7

未設置簽名

8

短信模板不合法

9

變量填寫錯誤

10

其他錯誤

注意:A、系統會自動過濾不合法的手機號

注意:B、 同樣的內容對同一個號碼發多條,系統會自動去重,這樣做是為了避免因重復發送造成的投訴。

 

二、查詢余額

1. 查詢余額

請求類型

請求url

http請求方式:POST(請使用http協議)

http://api.duanxinke.com/msg/balance

post數據請求示例

 {

      "uid":"123",

      "account":"賬號",

"pwd":"密碼"

  }

2. 查詢余額接口參數說明

接收值

意義

uid

企業id

account

用戶帳號,由系統管理員提供

pwd

賬號對應的密碼

3. 查詢余額響應包參數說明

失敗返回數據:

{"status":0,"message":"查詢失敗","respCode":"失敗id","respMsg":"失敗原因"}

成功返回數據:

{"status":1,"message":"查詢成功""respCode":"0","respMsg":"余額"}

4.返回值參數說明

respCode返回值

含義

0

查詢成功(respMsg顯示賬戶剩余短信數

1

uidpwdaccount為空或錯誤

 

 

 

三、短信狀態報告

1. 查詢短信狀態

請求類型

請求url

http請求方式:POST(請使用http協議)

http://api.duanxinke.com/msg/status

post數據請求示例

 {

    "uid":"123",

      "account":"賬號",

"pwd":"密碼"

  }

2. 查詢短信狀態接口參數說明

接收值

意義

uid

企業id

account

用戶帳號,由系統管理員提供

pwd

賬號對應的密碼

3. 查詢短信狀態響應包參數說明

失敗返回數據:

{"status":0,"message":"查詢失敗","respCode":"失敗id","respMsg":"失敗原因"}

成功返回數據:

{

"status":1,

"message":"查詢成功",

"respCode":0,

"respMsg":

[{"mobile":"XXXXXXXXXXX","msgid":50,"msgstatus":10,"receivetime":"2018-05-18 14:00:00"},

{"mobile":"XXXXXXXXXXX","msgid":51,"msgstatus":20,"receivetime":""}]

}

4.返回值參數說明

respCode返回值

含義

說明

0

查詢成功

mobile:對應的手機號碼

msgid:同一批短信任務id

msgstatus10發送成功  20發送失敗

receivetime:接收時間

1

uidpwdaccount為空或錯誤

2

暫無記錄

四、上行接口

1. 上行接口

請求類型

請求url

http請求方式:POST(請使用http協議)

http://api.duanxinke.com/msg/query

post數據請求示例

 {

    "uid":"123",

      "account":"賬號",

"pwd":"密碼"

  }

2. 上行接口參數說明

接收值

意義

uid

企業id

account

用戶帳號,由系統管理員提供

pwd

賬號對應的密碼

3. 上行接口響應包參數說明

失敗返回數據:

{"status":0,"message":"查詢失敗","respCode":"失敗id","respMsg":"失敗原因"}

成功返回數據:

{

"status":1,

"message":"查詢成功",

"respCode":0,

"respMsg":

[{"mobile":"XXXXXXXXXXX","msgid":50,"content":"XXXXXXXXXXX","receivetime":"2018-05-18 14:00:00"},

{"mobile":"XXXXXXXXXXX","msgid":51,"content":"XXXXXXXXXXX","receivetime":""}]

}

4.返回值參數說明

respCode返回值

含義

說明

0

查詢成功

mobile:對應的手機號碼

msgid:短信任務id

content上行內容

receivetime:接收時間

1

uidpwdaccount為空或錯誤

2

暫無記錄



接口文檔下載:{點擊下圖即可下載文檔}


在線咨詢客服

短信咨詢點這里


小工具

欧美AV亚洲AV国产AV综合区