## 公共參數
### 網關地址
| 環境 | 請求地址 |
| --- | --- |
| 正式環境 | 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 | 短信條數不足 |
