短信下行
1. 請求
（1） 請求地址：
https://u.smsyun.cc/sms-partner/access/{用戶帳號}/sendsms
注意：為了確保數(shù)據(jù)隱私和安全，用戶需要通過Https Post方式請求，消息格式：json表達式。
（2） Https標準包頭字段：
Accept:application/json;
Content-Type:application/json;charset=utf-8;
（3） 請求包體：
屬性 | 類型 | 約束 | 說明 |
clientid | String | 必選 | 帳號，6位， 如：a00012,b00012 |
password | String | 必選 | 密碼，8－12位，MD5加密后32位，小寫， 如：1bbd886460827015e5d605ed44252251 |
mobile | String | 必選 | 發(fā)送手機號碼， 國內短信不要加前綴，國際短信號碼前須帶相應的國家區(qū)號，如日本：0081， 支持多號碼，號碼之間用英文逗號隔開，最多100個。 國內手機號碼如：18612341234 國際號碼如：0085265656565 |
smstype | String | 必選 | 短信類型， "0"：通知短信，"4"：驗證碼短信，"5"：營銷短信 |
content | String | 必選 | 【簽名】+ 短信內容，UTF-8編碼， 短信內容最長500個字（包括英文字母），其中簽名2-12個字（包括英文字母） |
sendtime | String | 可選 | 定時發(fā)送時間， 為空表示立即發(fā)送，定時發(fā)送格式2016-11-11 09:00:00 （未生效） |
extend① | String | 可選 | 自擴展端口， 1－4位，只能為數(shù)字，可以為空 (注：請先詢問配置的通道是否支持自擴展端口，如果不支持，請?zhí)羁? |
uid② | String | 可選 | 用戶透傳ID， 隨狀態(tài)報告返回，最長60位 |
注：
① extend字段用于客戶傳送由客戶自行分配給子客戶的擴展端口，用于上行短信回來與之對應。
如：某客戶下有A、B、C三個子客戶，并且該客戶獲得某通道兩位自擴展，分別對其子客戶自行分配的擴展端口依次為子客戶A：01，子客戶B：02，子客戶C:03。
若子客戶A在發(fā)送下行短信時將該擴展端口01填入此字段即可，上行短信將會把此字段的擴展端口01發(fā)給客戶，用于客戶區(qū)分哪個子客戶的上行短信，子客戶A可根據(jù)上行短信中的電話號碼對應之前的下行手機號碼；
② uid字段用戶在單、群發(fā)短信時，由用戶生成并下發(fā)到平臺的序列號（最長不超過60位），該uid將在應答、狀態(tài)報告中返回給客戶，用于客戶區(qū)分或對應單、群發(fā)短信的批次。
群發(fā)一次最多100個號碼（目前不支持多內容組發(fā)）。
（4） JSON請求示例：
{
"clientid":"test",
"password":"6918d0046aab6a1ee290f751e02bd0b2",
"mobile":"13800138000,13800138001,19800138002,19800138003",
"smstype":"4",
"content":"【云通訊】您的驗證碼為：1234",
"sendtime":"2016-11-11 09:00:00",
"extend":"00",
"uid":"00"
}
包頭/包體 | 實例 | 備注 |
Header | POST /sms-partner/access/test/sendsms HTTP/1.1 Accept-Encoding:identity Content-Length:191 Host:172.16.5.20:9999 Accept:application/json Content-Type:application/json;charset=utf-8 | 藍色字體為可變部分， 保證路徑正確,采用HTTPS的POST方式發(fā)送； |
Body | {"clientid":"test","password":"6918d0046aab6a1ee290f751e02bd0b2","mobile":"13800138000,13800138001,19800138002,19800138003","smstype":"4","content":"【云通訊】您的驗證碼為1234","sendtime":"2016-11-11 09:00:00","extend":"00","uid":"00"} | 藍色字體為可變部分 |
2. 響應
（1） 響應包體：
屬性 | 類型 | 約束 | 說明 |
total_fee | Int | 必選 | 短信發(fā)送的計費總條數(shù) |
data | 每個手機號發(fā)送的詳細情況 | ||
code | Int | 必選 | 短信請求響應返回碼，參考“請求響應返回碼”定義的返回碼 （詳見第九章第1節(jié)） |
msg | String | 必選 | 短信請求響應返回中文描述，參考“請求響應返回碼”定義的中文描述（詳見第九章第1節(jié)） |
fee | Int | 必選 | 成功發(fā)送的短信計費條數(shù)，計費規(guī)則如下：70個字一條，超出70個字時按每67字一條計費（英文按字母個數(shù)計算） |
mobile | String | 必選 | 接收短信的手機號碼 |
sid | String | 必選 | 短信標識符（用于匹配狀態(tài)報告），一個手機號對應一個sid |
uid | String | 可選 | 用戶透傳ID，隨狀態(tài)報告返回 |
注：
① total_fee表示單（群）發(fā)短（長）短信總共計費的條數(shù)，該條數(shù)等于data域中各個fee字段數(shù)量之和；
② fee表示每個短信接收的手機號碼收到短信的計費條數(shù)（長短信按照短信計費規(guī)則進行計費，長短信拆分最大不超過10條）；
③ sid是短信平臺產生的唯一標示，與后面返回的狀態(tài)報告中的sid一一對應，用于下發(fā)短息與狀態(tài)報告相對應；
④ uid字段返回內容和第一章第1節(jié)請求中的“用戶透傳ID”一致，用于客戶區(qū)分或對應單、群發(fā)短信的批次；
（2） JSON響應示例
{
"total_fee":2,
"data":[
{
"code":0,
"msg":"發(fā)送成功",
"fee":1,
"mobile":"13800138000",
"sid":"08faf6-5728-438d-95ed-e0e0cec4fd37",
"uid":"1234"
},
{
"code":0,
"msg":"發(fā)送成功",
"fee":1,
"mobile":"13800138001",
"sid":"09faf6-5728-838d-95ed-e0e0cec4fd39",
"uid":"1234"
},
{
"code":-7,
"msg":"手機號碼格式錯誤"
"fee":0,
"mobile":"19800138002",
"sid":"753af6-5728-838d-95ed-e0e0cec4fd39",
"uid":"1234"
},
{
"code":-7,
"msg":"手機號碼格式錯誤"
"fee":0,
"mobile":"19800138003",
"sid":"95sw6-5728-838d-95ed-e0e0cec4fd39",
"uid":"1234"
}
]
}
包頭/包體 | 實例 | 備注 |
Header | HTTP/1.1 200 OK Accept-Encoding:identity Content-Length:424 Host:172.16.5.21:45302 Accept:application/json Content-Type:application/json;charset=utf-8 | 藍色字體為可變部分 |
Body | {"total_fee":2,"data":[{"code":0,"msg":"發(fā)送成功","fee":1,"mobile":"13800138000","sid":"08faf6-5728-438d-95ed-e0e0cec4fd37"},{"code":0,"msg":"發(fā)送成功","fee":1,"mobile":"13800138001","sid":"09faf6-5728-838d-95ed-e0e0cec4fd39"},{"code":-7,"msg":"手機號碼格式錯誤","fee":0, "mobile":"19800138002", "sid":"753af6-5728-838d-95ed-e0e0cec4fd39"}, {"code":-7,"msg":"手機號碼格式錯誤"，"fee":0, "mobile":"19800138003","sid":"95sw6-5728-838d-95ed-e0e0cec4fd39","uid":"1234"}]} | 藍色字體為可變部分 |
