智汇云-企业数智化核心引擎

首页> 开发者中心>云短信>接口文档>单发短信

**接口说明**
---
短信单条发送
---
本文提供了调用短信单条发送具体接口和参数说明。温馨提示：调用此服务API需登录智汇云官网进行开通，https://zyun.360.cn/manage
### 接口名
/v1/sms/singleSend
### 请求域名
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生成规则
``` 
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
####body中传递的参数（post）
参数|	类型|	是否必填|	描述
---|---|---|---
appid|	    string|	是|	通道ID
request_id|	string|	是|	请求ID（用户自己保证唯一）
mobile|     string|	是|	手机号（暂只支持国内）
content|	string|	是|	短信内容（512字符内）
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| 发送失败

AI大模型

AI平台

AI应用

视频

物联网

数据上云

IoT设备

账号体系

智慧城市

电商视频解决方案

教育

全屋智能

医疗

智能制造

游戏

云短信

接口文档

单发短信

混合发送短信

批量发送短信

电话咨询：

服务咨询

建议反馈

产品与服务

文档与社区

关于我们

关注我们

请您联系我们

小安提醒您

1对1免费咨询智汇云专属顾问

为您量身定制产品解决方案