定時(shí)短信下行
1. 請(qǐng)求
（1） 請(qǐng)求地址：
https://u.smsyun.cc/sms-partner/access/{用戶(hù)帳號(hào)}/sendsms
注意：為了確保數(shù)據(jù)隱私和安全，用戶(hù)需要通過(guò)Https Post方式請(qǐng)求，消息格式：json表達(dá)式。
（2） Https標(biāo)準(zhǔn)包頭字段：
Accept:application/json;
Content-Type:application/json;charset=utf-8;
（3） 請(qǐng)求包體：
屬性 | 類(lèi)型 | 約束 | 說(shuō)明 |
clientid | String | 必選 | 帳號(hào)，6位， 如：a00012,b00012 |
password | String | 必選 | 密碼，8－12位，MD5加密后32位，小寫(xiě)， 如：1bbd886460827015e5d605ed44252251 |
mobilelist | String | 必選 | 發(fā)送手機(jī)號(hào)碼， 國(guó)內(nèi)短信不要加前綴，國(guó)際短信號(hào)碼前須帶相應(yīng)的國(guó)家區(qū)號(hào)，如日本：0081， 支持多號(hào)碼，號(hào)碼之間用英文逗號(hào)隔開(kāi)，最多10萬(wàn)個(gè)。 國(guó)內(nèi)手機(jī)號(hào)碼如：18612341234 國(guó)際號(hào)碼如：0085265656565 拼接起來(lái)以后用compress_type中指定的壓縮類(lèi)型壓縮，然后用base64編碼壓縮后的數(shù)據(jù) |
smstype | String | 必選 | 短信類(lèi)型， "0"：通知短信，"4"：驗(yàn)證碼短信，"5"：營(yíng)銷(xiāo)短信 |
content | String | 必選 | 【簽名】+ 短信內(nèi)容，UTF-8編碼， 短信內(nèi)容最長(zhǎng)500個(gè)字（包括英文字母），其中簽名2-12個(gè)字（包括英文字母） |
sendtime | String | 必選 | 定時(shí)發(fā)送時(shí)間， 定時(shí)發(fā)送格式2016-11-11 09:00:00， 定時(shí)發(fā)送時(shí)間距當(dāng)前時(shí)間應(yīng)該大于5分鐘以上 |
extend① | String | 可選 | 自擴(kuò)展端口， 1－4位，只能為數(shù)字，可以為空 (注：請(qǐng)先詢(xún)問(wèn)配置的通道是否支持自擴(kuò)展端口，如果不支持，請(qǐng)?zhí)羁? |
uid② | String | 可選 | 用戶(hù)透傳ID， 隨狀態(tài)報(bào)告返回，最長(zhǎng)60位 |
compress_type | String | 可選 | 默認(rèn)為gzip壓縮 "0": gzip壓縮 |
注：
① extend字段用于客戶(hù)傳送由客戶(hù)自行分配給子客戶(hù)的擴(kuò)展端口，用于上行短信回來(lái)與之對(duì)應(yīng)。
如：某客戶(hù)下有A、B、C三個(gè)子客戶(hù)，并且該客戶(hù)獲得某通道兩位自擴(kuò)展，分別對(duì)其子客戶(hù)自行分配的擴(kuò)展端口依次為子客戶(hù)A：01，子客戶(hù)B：02，子客戶(hù)C:03。
若子客戶(hù)A在發(fā)送下行短信時(shí)將該擴(kuò)展端口01填入此字段即可，上行短信將會(huì)把此字段的擴(kuò)展端口01發(fā)給客戶(hù)，用于客戶(hù)區(qū)分哪個(gè)子客戶(hù)的上行短信，子客戶(hù)A可根據(jù)上行短信中的電話(huà)號(hào)碼對(duì)應(yīng)之前的下行手機(jī)號(hào)碼；
② uid字段用戶(hù)在單、群發(fā)短信時(shí)，由用戶(hù)生成并下發(fā)到平臺(tái)的序列號(hào)（最長(zhǎng)不超過(guò)60位），該uid將在應(yīng)答、狀態(tài)報(bào)告中返回給客戶(hù)，用于客戶(hù)區(qū)分或?qū)?yīng)單、群發(fā)短信的批次。
定時(shí)短信一次最多設(shè)置10萬(wàn)個(gè)號(hào)碼（目前不支持多內(nèi)容組發(fā)）。
（4） JSON請(qǐng)求示例：
{
"clientid":"test",
"password":"6918d0046aab6a1ee290f751e02bd0b2",
"mobilelist":"H4sICGUEPloAA3Bob25lLmxpc3QATdo7bmNJEEXBDbUxWZW/2v/GmmxgwJCjpPD0rncMIuK/fz….",
"smstype":"4",
"content":"【云通訊】您的驗(yàn)證碼為：1234",
"sendtime":"2018-11-11 09:00:00",
"extend":"00",
"uid":"00",
"compress_type":"0"
}
2. 響應(yīng)
（1） 響應(yīng)包體：
屬性 | 類(lèi)型 | 約束 | 說(shuō)明 |
total_fee① | Int | 必選 | 短信發(fā)送的計(jì)費(fèi)總條數(shù) |
sid2 | String | 必選 | 短信標(biāo)識(shí)符（sid + 手機(jī)號(hào)用于匹配狀態(tài)報(bào)告）， 一批定時(shí)短信手機(jī)號(hào)對(duì)應(yīng)一個(gè)sid |
uid3 | String | 可選 | 用戶(hù)透傳ID， 隨狀態(tài)報(bào)告返回 |
comporess_type | String | 可選 | 返回號(hào)碼列表使用的壓縮算法。 默認(rèn)gzip: 0: gzip |
data | 發(fā)送的詳細(xì)情況 | ||
code | Int | 必選 | 短信請(qǐng)求響應(yīng)返回碼， 參考“請(qǐng)求響應(yīng)返回碼”定義的返回碼 （詳見(jiàn)第九章第1節(jié)） |
msg | String | 必選 | 短信請(qǐng)求響應(yīng)返回中文描述， 參考“請(qǐng)求響應(yīng)返回碼”定義的中文描述 （詳見(jiàn)第九章第1節(jié)） |
mobilelist | String | 可選 | 當(dāng)code=-7或code=-30時(shí)存在，表示code對(duì)應(yīng)的號(hào)碼列表(同樣使用compress_type指定類(lèi)型壓縮+base64編碼)； code為其它時(shí)無(wú)此域 |
mobilecnt | Int | 可選 | 當(dāng)code=0或code=-7或code=-30時(shí)存在，表示code對(duì)應(yīng)的號(hào)碼個(gè)數(shù)； code為其它時(shí)無(wú)此域 |
注：
① total_fee表示單（群）發(fā)短（長(zhǎng)）短信總共計(jì)費(fèi)的條數(shù)，該條數(shù)等于單條短信計(jì)費(fèi)條數(shù)X所有成功返回的號(hào)碼數(shù)；
② sid是短信平臺(tái)產(chǎn)生的唯一標(biāo)示，與后面返回的狀態(tài)報(bào)告中的sid+手機(jī)號(hào)一一對(duì)應(yīng)，用于下發(fā)短息與狀態(tài)報(bào)告相對(duì)應(yīng)；
③ uid字段返回內(nèi)容和第一章第1節(jié)請(qǐng)求中的“用戶(hù)透傳ID”一致，用于客戶(hù)區(qū)分或?qū)?yīng)單、群發(fā)短信的批次；
（2） JSON響應(yīng)示例
{
"total_fee":200,
"sid":"08faf6-5728-438d-95ed-e0e0cec4fd37",
"uid":"1234",
"data":[
{
"code":0,
"msg":"發(fā)送成功",
"mobilecnt":200
},
{
"code":-7,
"msg":"手機(jī)號(hào)碼格式錯(cuò)誤",
"mobilelist":"H4sICGUEPloAA3Bob25lLmxp….",
"mobilecnt":4
}
]
}
包頭/包體 | 實(shí)例 | 備注 |
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 | 藍(lán)色字體為可變部分 |
Body | {"total_fee":200,"sid":"08faf6-5728-438d-95ed-e0e0cec4fd37"，"uid":"1234",data":[{"code":0,"msg":"發(fā)送成功", "mobilecnt":200},{"code":-7,"msg": "手機(jī)號(hào)碼格式錯(cuò)誤","fee":0,"mobilelist":"1843123454,1843123454,22344433,21822222","mobilecnt":4]} | 藍(lán)色字體為可變部分 |
