億百天技術(shù)短信V6接口說(shuō)明（用于普通短信及驗(yàn)證碼發(fā)送等）
使用說(shuō)明：
1、以下短信接口開(kāi)發(fā)資料供開(kāi)發(fā)技術(shù)人員參考
2、短信接口開(kāi)發(fā)技術(shù)支持請(qǐng)發(fā)郵件至：support@ebaitian.cn
3、由于安全問(wèn)題，我們強(qiáng)烈建議使用V6開(kāi)發(fā)接入相關(guān)應(yīng)用
一、協(xié)議說(shuō)明
| 協(xié)議 | HTTP POST/GET |
| 編碼格式 | UTF8 |
| URL | http://yun.ebaitian.cn/yun/sms/v6/tlssmssvr/json |
| 參數(shù) | appid={appid}&module={module}&stamp={stamp}&sign={sign}&mobile={mobile}&content={content}&signsms={signsms} |
| 使用場(chǎng)景 | 文字短信的單發(fā)、文字短信的群發(fā) |
| 接口說(shuō)明 | 給用戶發(fā)短信驗(yàn)證碼、短信通知，營(yíng)銷短信（內(nèi)容長(zhǎng)度不超過(guò)450字）。 備注：為了數(shù)據(jù)傳輸?shù)陌踩?，建議使用 HTTP POST 協(xié)議開(kāi)發(fā)接入應(yīng)用。 |
二、參數(shù)說(shuō)明
| appid | 必須參數(shù)：授權(quán)接口的AppID（請(qǐng)?zhí)顚?xiě)您在官網(wǎng)上申請(qǐng)到的 AppID） |
| module | 必須參數(shù)：請(qǐng)求模塊（文字短信發(fā)送賦值：sendsms） |
| stamp | 必須參數(shù)：請(qǐng)求時(shí)間戳（五分鐘內(nèi)有效） |
| sign | 必須參數(shù)：簽名，即請(qǐng)求憑證（簽名校驗(yàn)，計(jì)算公式見(jiàn)下面的其他說(shuō)明） |
| mobile | 必須參數(shù)：發(fā)送短信的目標(biāo)手機(jī)號(hào)碼（群發(fā)見(jiàn)下面的其他說(shuō)明） |
| content | 必須參數(shù)：短信內(nèi)容（短信內(nèi)容不能包含簽名，即不能包含：【xxxx】） |
| signsms | 可選參數(shù)：短信簽名（為空時(shí)，將使用默認(rèn)簽名，不能包含“【”、“】”；格式：簽名） |
其他說(shuō)明：
1、sign 簽名根據(jù)公式 $sign=sha256(appid={appid}&content={content}&mobile={mobile}&module={module}&signsms={signsms}&stamp={stamp}&appkey={appkey}) 生成；
2、簽名計(jì)算中：appkey 為授權(quán)接口的 AppKey，請(qǐng)?zhí)顚?xiě)您在官網(wǎng)上申請(qǐng)到的 AppKey ；
3、簽名計(jì)算注意：簽名字符串拼接時(shí)，除 appid 、appkey 外的字段使用字典順序排序拼接，appid 位于最開(kāi)始，appkey 位于結(jié)尾，最終拼接完后進(jìn)行 sha256 的計(jì)算得到簽名值
4、mobile 賦值：若為單條短信發(fā)送，填寫(xiě)一個(gè)手機(jī)號(hào)即可；若為多條短信群發(fā)，多個(gè)手機(jī)號(hào)間使用英文“,”分隔，如：13088888888,13188888888,……
請(qǐng)求示例：
1、數(shù)據(jù)包體：
{
"appid": "100000xx",
"module": "sendsms",
"stamp": "1618316540",
"sign": "7db931e3486cbf20ac7b46d2d7a2b26ea7397e53f03e4a449117a0c60034f8aa",
"mobile": "13088888888,13188888888",
"content": "您的電子發(fā)票申請(qǐng)已受理成功，請(qǐng)點(diǎn)擊查看：http://u10.ink/jX2bT7",
"signsms": "億百天技術(shù)"
}
2、請(qǐng)求地址：http://yun.ebaitian.cn/yun/sms/v6/tlssmssvr/json
三、返回?cái)?shù)據(jù)包體
| JSON 數(shù)據(jù) | 成功返回： { "result":1, "description":"TRUE", "flag":"手機(jī)短信群發(fā)成功", "data":{ "count":2, "sms_num":2, "sms_info":{ "mobile":[ "13088888888", "13188888888" ], "content":"您的電子發(fā)票申請(qǐng)已受理成功，請(qǐng)點(diǎn)擊查看：http://u10.ink/jX2bT7", "signsms":"億百天技術(shù)" } } } 失敗返回： { "result":0, "description":"FALSE", "flag":"[stamp]公共參數(shù)錯(cuò)誤或已過(guò)期" } |
參數(shù)說(shuō)明：
| result | 0-失?。?-成功 |
| description | 請(qǐng)求結(jié)果描述；成功返回 TRUE ，失敗返回 FALSE |
| flag | 返回詳細(xì)信息 |
| data | 僅請(qǐng)求成功時(shí)才會(huì)返回此參數(shù) data 參數(shù)說(shuō)明： count：手機(jī)號(hào)數(shù)量 sms_num：發(fā)送短信條數(shù) sms_info：短信發(fā)送請(qǐng)求數(shù)據(jù) sms_info 參數(shù)說(shuō)明： mobile：手機(jī)號(hào)（單發(fā)為一個(gè)，群發(fā)為多個(gè)） content：短信內(nèi)容 signsms：短信簽名 |
四、示例SDK與演示DEMO
我們?yōu)殚_(kāi)發(fā)者封裝了多個(gè)平臺(tái)的 API 供開(kāi)發(fā)者直接使用，以節(jié)省開(kāi)發(fā)時(shí)間。
點(diǎn)擊下載SDK：http://down.ebaitian.cn/?dir=ebaitian/sdk/
打開(kāi)演示DEMO：http://yun.ebaitian.cn/yun/demo/v6/
本文為「本站原創(chuàng)」，未經(jīng)我們?cè)S可，嚴(yán)謹(jǐn)任何人或單位以任何形式轉(zhuǎn)載或刊載本文章，我們保留依法追究侵權(quán)的權(quán)力！
微信聯(lián)系我們
使用微信掃一掃
昵稱：億百天技術(shù)
公司：湖北億百天信息技術(shù)有限公司
電話：027-88773336
手機(jī)：15342213852
郵箱：serviceebaitian.cn
相關(guān)欄目
加載中...
我來(lái)說(shuō)兩句