接口说明

短信混合发送

本文提供了调用短信混合发送(不同内容批量手机号)具体接口和参数说明。温馨提示:调用此服务API需登录智汇云官网进行开通,https://zyun.360.cn/manage

接口名

/v1/sms/multiSend

请求域名

sms.zyun.360.cn

通讯协议

支持通过HTTP协议进行请求通信

请求方式

支持post方式发送请求

请求参数

Header头中传递的参数

参数 参数名 参数描述
Authorization 鉴权信息 鉴权信息规则参见下方规则详细描述。
Auth-Time 当前时间 规则参见下方详细描述。
Rand-Num 随机数 规则参见下方详细描述。
Auth-Ver 版本号 固定值:1.0

header认证参数说明

参数名称 说明 用法
Authorization 认证字符串 第一步:将AK、auth_time、rand_num、param_sign 拼接成一个字符串、中间用”\n”分隔。 第二步:用SK对第一步生成的字符串做sha1加密,再base64编码 第三步:将AK和第二步生成的字符串用冒号(:)拼接得到最终的authorization
Auth-Ver 认证版本 1.0
Auth-Time 认证时间 表示此次操作的时间,unix系统时间戳(10位)(不能为空,如果请求中的Auth-Time时间和服务器的 时间差15分钟以上,服务器将拒绝该服务,并返回ERROR错误)
Rand-Num 随机正整数 表示一个随机正整数(rand生成即可)
Authorization生成规则
  1. PHP
  2. $auth_time = time();
  3. $auth_string = $ak . "\n" . $auth_time . "\n" . $rand_num . "\n" . $param_sign;
  4. $encrypt_string = base64_encode(hash_hmac("sha1", $auth_string, $sk, true));
  5. $authorization = $ak . ":" . $encrypt_string;
  6. GO
  7. authTime := strconv.FormatInt(time.Now().Unix(), 10)
  8. randNum := strconv.Itoa(rand.Intn(10000))
  9. authString := AK + "\n" + authTime + "\n" + randNum + "\n" + paramSign
  10. encryptAuth := utils.HmacSha1AndBase64(SK, authString)
  11. authorization := AK + ":" + encryptAuth

构造密码串

参数说明 参数名称 说明
auth_time unxi时间戳(10位)
ak Access Key 官网用户中心查看 https://zyun.360.cn/usercenter/user/accesskey
sk Secret Access Key 官网用户中心查看 https://zyun.360.cn/usercenter/user/accesskey
rand_num 随机正整数
param_sign 参数按键排序并加入随机因子 所有参数按key做升序排序后串成字符串$paramStr,然后 $paramStr的md5值连上$rand_num,然后再用md5计算得到的值为param_sign paramStr排序例子: 参数 { a1:v1, b1:v3, a2:v2 } 排序后的字符串为 a1=v1a2=v2b1=v3

body中传递的参数(post)

参数 类型 是否必填 描述
appid string 通道ID
request_id string 请求ID(用户自己保证唯一), 格式[0-9a-zA-Z_-]{1,64}
multimt string 混合内容: [{“mobile”:”137XXXXXXXX”,”content”:”test”},{“mobile”:”158XXXXXXXX”,”content”:”test3”}] 注意:手机号是字符串(便于扩展用(+86))
timestamp string 请求unix时间戳

返回结果说明

返回结果说明

参数名称 必选 类型 参数说明
errcode true int 错误码
errmsg true string 错误描述
data true json 响应结构体

data结构

参数名称 必选 类型 参数说明
taskid true string 任务ID
request_id true string 用户传入请求ID

响应示例

  1. {
  2. "errcode": 0,
  3. "errmsg": "ok",
  4. "data": {
  5. "taskid": "2020052068727000000001",
  6. "request_id":"202005201758358081"
  7. }
  8. }

错误码说明

错误码 说明
0 正常
400001 未知错误
400002 系统内部错误
400003 签名错误
400004 参数错误
401000 任务队列满
401001 任务执行超时
410000 超过系统负载
410001 手机号码格式错误
410002 批量手机号
410003 短信内容非法
410004 短信内容超过限制
410005 业务类型错误
410006 request_id错误
410007 multimt参数错误
410008 时间戳格式错误
410888 用户欠费
410889 发送失败
即刻开始使用

只需完成注册与实名认证,即可体验我们的贴心服务