亿百天技术短信V6接口说明(用于普通短信及验证码发送等)

使用说明:
1、以下短信接口开发资料供开发技术人员参考
2、短信接口开发技术支持请发邮件至:support@ebaitian.cn
3、由于安全问题,我们强烈建议使用V6开发接入相关应用

一、协议说明

协议HTTP POST/GET
编码格式UTF8
URLhttp://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]公共参数错误或已过期"
}

参数说明:

result0-失败;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/

点赞 0 分享
本文为「本站原创」,未经我们许可,严谨任何人或单位以任何形式转载或刊载本文章,我们保留依法追究侵权的权力!

微信联系我们

亿百天技术客户服务

使用微信扫一扫

昵称:亿百天技术

公司:湖北亿百天信息技术有限公司

电话:027-88773336

手机:15342213852

邮箱:serviceebaitian.cn

相关栏目

加载中...

成为会员立享特权

立即注册亿百天公司会员,在线联系客服立即享受会员特权,还有丰厚礼品赠送;签约时可以享受特低折扣优惠,期待您的加入!

客服热线:400-840-3336

我们为您提供个性化的售前咨询服务,及全面的技术售后服务。