亿百天技术短信V6接口说明(用于普通短信及验证码发送等)
使用说明:
1、以下短信接口开发资料供开发技术人员参考
2、短信接口开发技术支持请发邮件至:support@ebaitian.cn
3、由于安全问题,我们强烈建议使用V6开发接入相关应用
一、协议说明
协议 | HTTP POST/GET |
编码格式 | UTF8 |
URL | http://yun.ebaitian.cn/yun/sms/v6/tlssmssvr/json |
参数 | appid={appid}&module={module}&stamp={stamp}&sign={sign}&mobile={mobile}&content={content}&signsms={signsms} |
使用场景 | 文字短信的单发、文字短信的群发 |
接口说明 | 给用户发短信验证码、短信通知,营销短信(内容长度不超过450字)。 备注:为了数据传输的安全,建议使用 HTTP POST 协议开发接入应用。 |
二、参数说明
appid | 必须参数:授权接口的AppID(请填写您在官网上申请到的 AppID) |
module | 必须参数:请求模块(文字短信发送赋值:sendsms) |
stamp | 必须参数:请求时间戳(五分钟内有效) |
sign | 必须参数:签名,即请求凭证(签名校验,计算公式见下面的其他说明) |
mobile | 必须参数:发送短信的目标手机号码(群发见下面的其他说明) |
content | 必须参数:短信内容(短信内容不能包含签名,即不能包含:【xxxx】) |
signsms | 可选参数:短信签名(为空时,将使用默认签名,不能包含“【”、“】”;格式:签名) |
其他说明:
1、sign 签名根据公式 $sign=sha256(appid={appid}&content={content}&mobile={mobile}&module={module}&signsms={signsms}&stamp={stamp}&appkey={appkey}) 生成;
2、签名计算中:appkey 为授权接口的 AppKey,请填写您在官网上申请到的 AppKey ;
3、签名计算注意:签名字符串拼接时,除 appid 、appkey 外的字段使用字典顺序排序拼接,appid 位于最开始,appkey 位于结尾,最终拼接完后进行 sha256 的计算得到签名值
4、mobile 赋值:若为单条短信发送,填写一个手机号即可;若为多条短信群发,多个手机号间使用英文“,”分隔,如:13088888888,13188888888,……
请求示例:
1、数据包体:
{
"appid": "100000xx",
"module": "sendsms",
"stamp": "1618316540",
"sign": "7db931e3486cbf20ac7b46d2d7a2b26ea7397e53f03e4a449117a0c60034f8aa",
"mobile": "13088888888,13188888888",
"content": "您的电子发票申请已受理成功,请点击查看:http://u10.ink/jX2bT7",
"signsms": "亿百天技术"
}
2、请求地址:http://yun.ebaitian.cn/yun/sms/v6/tlssmssvr/json
三、返回数据包体
JSON 数据 | 成功返回: { "result":1, "description":"TRUE", "flag":"手机短信群发成功", "data":{ "count":2, "sms_num":2, "sms_info":{ "mobile":[ "13088888888", "13188888888" ], "content":"您的电子发票申请已受理成功,请点击查看:http://u10.ink/jX2bT7", "signsms":"亿百天技术" } } } 失败返回: { "result":0, "description":"FALSE", "flag":"[stamp]公共参数错误或已过期" } |
参数说明:
result | 0-失败;1-成功 |
description | 请求结果描述;成功返回 TRUE ,失败返回 FALSE |
flag | 返回详细信息 |
data | 仅请求成功时才会返回此参数 data 参数说明: count:手机号数量 sms_num:发送短信条数 sms_info:短信发送请求数据 sms_info 参数说明: mobile:手机号(单发为一个,群发为多个) content:短信内容 signsms:短信签名 |
四、示例SDK与演示DEMO
我们为开发者封装了多个平台的 API 供开发者直接使用,以节省开发时间。
点击下载SDK:http://down.ebaitian.cn/?dir=ebaitian/sdk/
打开演示DEMO:http://yun.ebaitian.cn/yun/demo/v6/
本文为「本站原创」,未经我们许可,严谨任何人或单位以任何形式转载或刊载本文章,我们保留依法追究侵权的权力!
微信联系我们
使用微信扫一扫
昵称:亿百天技术
公司:星空体育·(StarSky Sports)官方网站
电话:027-88773336
手机:15342213852
邮箱:serviceebaitian.cn
我来说两句