億百天技術短信V6接口說明（用于普通短信及驗證碼發(fā)送等）
使用說明：
1、以下短信接口開發(fā)資料供開發(fā)技術人員參考
2、短信接口開發(fā)技術支持請發(fā)郵件至：support@ebaitian.cn
3、由于安全問題，我們強烈建議使用V6開發(fā)接入相關應用
一、協(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ā)短信驗證碼、短信通知，營銷短信（內容長度不超過450字）。 備注：為了數(shù)據(jù)傳輸?shù)陌踩?，建議使用 HTTP POST 協(xié)議開發(fā)接入應用。 |
二、參數(shù)說明
| appid | 必須參數(shù)：授權接口的AppID（請?zhí)顚懩诠倬W(wǎng)上申請到的 AppID） |
| module | 必須參數(shù)：請求模塊（文字短信發(fā)送賦值：sendsms） |
| stamp | 必須參數(shù)：請求時間戳（五分鐘內有效） |
| sign | 必須參數(shù)：簽名，即請求憑證（簽名校驗，計算公式見下面的其他說明） |
| mobile | 必須參數(shù)：發(fā)送短信的目標手機號碼（群發(fā)見下面的其他說明） |
| content | 必須參數(shù)：短信內容（短信內容不能包含簽名，即不能包含：【xxxx】） |
| signsms | 可選參數(shù)：短信簽名（為空時，將使用默認簽名，不能包含“【”、“】”；格式：簽名） |
其他說明：
1、sign 簽名根據(jù)公式 $sign=sha256(appid={appid}&content={content}&mobile={mobile}&module={module}&signsms={signsms}&stamp={stamp}&appkey={appkey}) 生成；
2、簽名計算中：appkey 為授權接口的 AppKey，請?zhí)顚懩诠倬W(wǎng)上申請到的 AppKey ；
3、簽名計算注意：簽名字符串拼接時，除 appid 、appkey 外的字段使用字典順序排序拼接，appid 位于最開始，appkey 位于結尾，最終拼接完后進行 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": "億百天技術"
}
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":"億百天技術" } } } 失敗返回： { "result":0, "description":"FALSE", "flag":"[stamp]公共參數(shù)錯誤或已過期" } |
參數(shù)說明：
| result | 0-失敗；1-成功 |
| description | 請求結果描述；成功返回 TRUE ，失敗返回 FALSE |
| flag | 返回詳細信息 |
| data | 僅請求成功時才會返回此參數(shù) data 參數(shù)說明： count：手機號數(shù)量 sms_num：發(fā)送短信條數(shù) sms_info：短信發(fā)送請求數(shù)據(jù) sms_info 參數(shù)說明： mobile：手機號（單發(fā)為一個，群發(fā)為多個） content：短信內容 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)我們許可，嚴謹任何人或單位以任何形式轉載或刊載本文章，我們保留依法追究侵權的權力！
微信聯(lián)系我們
使用微信掃一掃
昵稱：億百天技術
公司：湖北億百天信息技術有限公司
電話：027-88773336
手機：15342213852
郵箱：serviceebaitian.cn
相關欄目
加載中...
我來說兩句