## 公共参数
### 网关地址
| 环境 | 请求地址 |
| --- | --- |
| 正式环境 | http://api.shansuma.com/gateway.do |
| 沙箱环境 | \- |
### 公共请求参数
| 名称 | 类型 | 是否必填 | 描述 | 示例 |
| --- | --- | --- | --- | --- |
| app\_id | string | 是 | 开发者app\_id | hw\_1000001 |
| method | string | 是 | 接口名称 | sms.message.send |
| version | string | 是 | 接口版本 | 1.0 |
| timestamp | long | 是 | 时间戳(毫秒) | 1620641251145 |
| sign\_type | string | 是 | 签名类型 | md5 |
| sign | string | 是 | 签名 | 参见签名规则 |
| biz\_content | string | 是 | 业务参数 | JSON字符串 |
## 业务参数
| 名称 | 类型 | 是否必填 | 描述 | 示例 |
| --- | --- | --- | --- | --- |
| mobile | JsonArray | 是 | 手机号 | \["13800138000"\] |
| template\_id | string | 是 | 短信模板id | ST\_2019041500001 |
| type | int | 是 | 短信类型 | 0\. 验证码
1\. 行业通知
2\. 营销短信
3\. 国际短信 |
| params | JsonObject | 特殊可选 | 模板参数 | {"code":137926} |
| send\_time | string | 否 | 定时发送 | 2019-04-15 12:20:30 |
| sign | string | 是 | 短信签名 | 短信测试专用 |
### 响应结果
~~~
{
"status": 200,
"message": "",
"result": {
"code": 0,
"message": "",
"data": {
"message_id": "xxxxxxxxxxxxxxx",
"total": 1
}
}
}
~~~
### 业务响应参数
| 名称 | 类型 | 描述 |
| --- | --- | --- |
| message\_id | string | 消息id |
| total | int | 短信发送条数 |
### 业务错误码
| 错误码 | 描述 |
| --- | --- |
| 0 | 发送成功 |
| 10001 | 开发者数据错误 |
| 10002 | 参数格式错误或缺少参数 |
| 10003 | 短信类型错误 |
| 10004 | 短信签名错误或缺少签名 |
| 10005 | 模板错误或模板类型错误 |
| 10006 | 短信条数不足 |
