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