請(qǐng)求地址
| 名稱 | 是否必須 | 示例值 | 說明 |
|---|---|---|---|
| 請(qǐng)求地址 | UTF-8 | http://dc.28inter.com/sms.aspx | 如果服務(wù)器不支持解析，請(qǐng)聯(lián)系技術(shù)人員進(jìn)行協(xié)助處理！ |
| 名稱 | 是否必須 | 示例值 | 描述 |
|---|---|---|---|
| action | 必須 | 固定設(shè)置為：send | 任務(wù)命令為：發(fā)送任務(wù)命令 |
| account | 必須 | 28inter | 注冊(cè)或者系統(tǒng)管理員分配獲取；登陸賬號(hào) |
| password | 必須 | 123456 | 注冊(cè)或者系統(tǒng)管理員分配獲取；登陸密碼 |
| userid | 必須 | 1001 | 注冊(cè)或者系統(tǒng)管理員分配獲取，賬戶ID |
| mobile | 必須 | 13000000000,13000000001 | 短信接收號(hào)碼。支持單個(gè)或多個(gè)手機(jī)號(hào)碼，傳入號(hào)碼為11位手機(jī)號(hào)碼，不能加0或+86。群發(fā)短信需傳入多個(gè)號(hào)碼，以英文逗號(hào)分隔，示例：13000000000,13000000001 |
| content | 必須 | 【創(chuàng)信信息】您的驗(yàn)證碼是：123456 | 發(fā)送短信的內(nèi)容，整體做urlencode.短信簽名的格式為：【簽名】放在內(nèi)容的最前方。 示范：【創(chuàng)信信息】您本次注冊(cè)的驗(yàn)證碼是：888888， 其中簽名可根據(jù)自己公司的名稱或簡(jiǎn)稱自定義，字?jǐn)?shù)為2-8字，不可以是純數(shù)字、電話號(hào)碼或者網(wǎng)址，不可以是無意義的簽名，比如【大家好】，【哈哈哈】，【提示】，【測(cè)試】等 正確示例：【創(chuàng)信信息】、【京東】、【百度】、【工商銀行】 錯(cuò)誤示例：【你好】、【通知】、【測(cè)試一下】、【哈哈哈】、【123123】 |
| rt | 可選 | json | 返回值格式，默認(rèn)為xml |
例如：http://dc.28inter.com/sms.aspx?action=send&userid=12&account=acc&password=pass&mobile=13568813957&content=【創(chuàng)信信息】驗(yàn)證碼：123（utf8 urlencode編碼）
響應(yīng)實(shí)例
| 響應(yīng)實(shí)例-xml |
|---|
<xml version="1.0" encoding="utf-8"> <returnsms> <returnstatus>status</returnstatus> ---------- 返回狀態(tài)值：成功返回Success 失敗返回：Faild <message>message</message> ---------- 返回信息 <remainpoint> remainpoint</remainpoint> ---------- 返回余額 <taskID>taskID</taskID> ----------- 返回本次任務(wù)的序列ID <successCounts>successCounts</successCounts> --成功短信數(shù)：當(dāng)成功后返回提交成功短信數(shù) </returnsms> |
| 響應(yīng)實(shí)例-json |
|---|
| {"ReturnStatus":"success","Message":"ok","RemainPoint":0,"TaskID":0,"SuccessCounts":0} |
響應(yīng)參數(shù)
| 名稱 | 含義 | 示例值 | 描述 |
|---|---|---|---|
| returnstatus | 調(diào)用結(jié)果 | success | 調(diào)用結(jié)果:success為成功，faild為失敗 |
| message | 調(diào)用信息 | OK | 調(diào)用成功返回OK，失敗顯示失敗原因，具體原因見下表 |
| remainpoint | 賬戶余額 | 100 | 賬戶余額 |
| taskID | 任務(wù)序號(hào) | 100001 | 每次任務(wù)對(duì)應(yīng)唯一的任務(wù)id |
| successCounts | 號(hào)碼個(gè)數(shù) | 1 | 發(fā)送號(hào)碼的個(gè)數(shù) |
返回信息
| 示例值 | 描述 |
|---|---|
| OK | 提交成功 |
| 用戶名或密碼不能為空 | 提交的用戶名或密碼為空 |
| 發(fā)送內(nèi)容包含sql注入字符 | 包含sql注入字符 |
| 用戶名或密碼錯(cuò)誤 | 用戶名或密碼錯(cuò)誤 |
| 余額不足 | 短信余額不足 |
