首頁 > 開發(fā)者中心 > HTTPS API > 驗(yàn)證碼通知短信接口
驗(yàn)證碼通知短信接口
- 請求地址:
- http://客戶端地址/sms.aspx?action=send
- 請求方式:
- POST
- 編碼格式:
- UTF-8 gbk
- 響應(yīng)格式:
- JSON，XML
- 請求包頭:
- Content-type:application/x-www-form-urlencoded
請求參數(shù)說明
| 參數(shù)名稱 | 類型 | 約束 | 說明 |
|---|---|---|---|
| Userid | String | 必選 | 企業(yè)ID（ACCOUNT SID）。由32個(gè)英文字母和阿拉伯?dāng)?shù)字組成的開發(fā)者賬號(hào)唯一標(biāo)識(shí)符。 |
| action | String | 必選 | 設(shè)置為固定的:send |
| account | String | 必選 | 用戶帳號(hào)，由系統(tǒng)管理員發(fā)放。 |
| password | String | 必選 | 用戶賬號(hào)對(duì)應(yīng)的密碼 |
| Content | String | 必選 | 短信內(nèi)容。（短信簽名+短信內(nèi)容。如【今信科技】您的驗(yàn)證碼是345678，30分鐘輸入有效。） |
| mobile | String | 必選 | 短信接收端手機(jī)號(hào)碼集合。用英文逗號(hào)分開，每批發(fā)送的手機(jī)號(hào)數(shù)量不得超過100個(gè)。 |
| extno | String | 可選 | 平臺(tái)分配給開發(fā)者的端口號(hào)。 |
| sendtime | String | 必選 | 時(shí)間戳。當(dāng)前系統(tǒng)時(shí)間（24小時(shí)制），格式"yyyyMMddHHmmss"。時(shí)間戳有效時(shí)間為5分鐘。 |
請求實(shí)例
url：
http://客戶端地址/sms.aspx?action=send
post數(shù)據(jù)：
action=send&userid=12&account=賬號(hào)&password=密碼&mobile=15023239810,13527576163&content=內(nèi)容&sendTime=&extno=
返回參數(shù)說明
| 參數(shù)名稱 | 類型 | 約束 | 說明 |
|---|---|---|---|
| respCode | String | 必選 | 請求狀態(tài)碼，取值00000（成功： 此步響應(yīng)只表明客戶的短信請求發(fā)送成功，不表明短信通道已經(jīng)發(fā)送短信成功。） 具體可參照《附：返回狀態(tài)碼列表》 |
| failCount | String | 必選 | 表示驗(yàn)證碼通知短信發(fā)送失敗的條數(shù)。 |
| failList | String | 可選 | 失敗列表，包含失敗號(hào)碼、失敗原因。 |
| smsId | String | 必選 | 短信標(biāo)識(shí)符。一個(gè)由32個(gè)字符組成的短信唯一標(biāo)識(shí)符。 |
返回示例
XML返回包體：
<?xml version="1.0" encoding="utf-8"?>
<returnsms>
<returnsms>status</returnsms>
<message>message;/message;
<remainpoint>remainpoint</remainpoint>
<successCounts>successCounts</successCounts>
<taskID>
<phone>13896543210 </phone>
<returnsms>00111 </returnsms>
</taskID>
</returnsms>
