7*24小时人工服务
400-00-52360
本文提供了调用短信混合发送(不同内容批量手机号)具体接口和参数说明。温馨提示:调用此服务API需登录智汇云官网进行开通,https://zyun.360.cn/manage
/v1/sms/multiSend
sms.zyun.360.cn
支持通过HTTP协议进行请求通信
支持post方式发送请求
参数 | 参数名 | 参数描述 |
---|---|---|
Authorization | 鉴权信息 | 鉴权信息规则参见下方规则详细描述。 |
Auth-Time | 当前时间 | 规则参见下方详细描述。 |
Rand-Num | 随机数 | 规则参见下方详细描述。 |
Auth-Ver | 版本号 | 固定值:1.0 |
参数名称 | 说明 | 用法 |
---|---|---|
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生成即可) |
PHP
$auth_time = time();
$auth_string = $ak . "\n" . $auth_time . "\n" . $rand_num . "\n" . $param_sign;
$encrypt_string = base64_encode(hash_hmac("sha1", $auth_string, $sk, true));
$authorization = $ak . ":" . $encrypt_string;
GO
authTime := strconv.FormatInt(time.Now().Unix(), 10)
randNum := strconv.Itoa(rand.Intn(10000))
authString := AK + "\n" + authTime + "\n" + randNum + "\n" + paramSign
encryptAuth := utils.HmacSha1AndBase64(SK, authString)
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 |
参数 | 类型 | 是否必填 | 描述 |
---|---|---|---|
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 |
{
"errcode": 0,
"errmsg": "ok",
"data": {
"taskid": "2020052068727000000001",
"request_id":"202005201758358081"
}
}
错误码 | 说明 |
---|---|
0 | 正常 |
400001 | 未知错误 |
400002 | 系统内部错误 |
400003 | 签名错误 |
400004 | 参数错误 |
401000 | 任务队列满 |
401001 | 任务执行超时 |
410000 | 超过系统负载 |
410001 | 手机号码格式错误 |
410002 | 批量手机号 |
410003 | 短信内容非法 |
410004 | 短信内容超过限制 |
410005 | 业务类型错误 |
410006 | request_id错误 |
410007 | multimt参数错误 |
410008 | 时间戳格式错误 |
410888 | 用户欠费 |
410889 | 发送失败 |
只需完成注册与实名认证,即可体验我们的贴心服务
4000052360
试用小安,请确保该账户已通过智汇云实名认证 前往认证中心>>