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