点击右侧按钮复制完整请求地址，参数值请替换为实际有效值

请求参数 （暂无请求参数）

请求参数说明

### 短信接口流程：联系平台工作人员提供签名和模板 --> 审核资质 --> 获取模板id -->发送短信

# 接口名称：短信通知
>描述：发送短信通知(注册、找回密码等发送验证码通知等)
>注意：该接口限制70个字

**请求地址**：https://api.shuliancloud.com/sms/send
**请求方式**：POST

#### 参数
|  名称 |  类型 |是否必填   | 说明  |
| ------------ | ------------ | ------------ | ------------ |
| appid  |  varchar |  是 | 服务商分配的唯一标识  |
| timestamp |  number | 是  | 当前时间的毫秒数  |
| sign  | varchar  | 是  | 签名  |
| templateId  |  varchar | 是  | 短信模板ID  |
| receive | varchar  | 是  | 短信接收人号码  |
| tag | varchar  | 是  | 短信发送的变量值，多个tag变量用竖线‘\|’分隔 ，格式如 1234\|1234 |

#### 签名算法说明
> 商户分配的appid、当前时间毫秒数timestamp、商户分配的app_security、 三者通过&符号拼接成字符串进行md5加密得到。
>如：appid=xyzxyzxyz，timestamp=1555378976238，app_security=efcefcefcefcefc;
>拼接后的字符串：str=xyzxyzxyz&1555378976238&efcefcefcefcefc;
>加密后得到sign = md5(str) = 4e7e1974b79f3656aeaf03f1158f5d5d;

#### 正确返回
```json
{
    "msg": "成功",
    "success": true,
    "code": 200, //200为收费
    "data": {
        "taskId": "2020040211442081fffd9b",//短信发送任务ID
        "orderNo": "695237182989930496" //订单号
    }
}
```

#### 错误返回
```json
{
    "msg": "templateId 无效",
    "success": false,
    "code": 400,
    "data": {}
}
```

# 接口名称：短信发送状态查询
>描述：查询短信送达情况

**请求地址**：https://api.shuliancloud.com/sms/detail 
**请求方式**：GET
#### 参数
|  名称 |  类型 |是否必填   | 说明  |
| ------------ | ------------ | ------------ | ------------ |
| appid  |  varchar |  是 | 服务商分配的唯一标识  |
| timestamp |  number | 是  | 当前时间的毫秒数  |
| sign  | varchar  | 是  | 签名 |
| taskId  |  varchar | 是  | 短信任务编号  |

#### 正确返回
```json
{
    "msg": "成功",
    "success": true,
    "code": 200, 
    "data": {
        "result": "执行中",//result为SUCCESS 发送成功,FAILE 发送失败
        "taskId": "st200630172301394aaa7c6",
	"sendTime": 1713346870000
    }
}
```

#### 错误返回
```json
{
    "msg": "未查询到该taskId对应的记录",
    "success": false,
    "code": 400,
    "data": {}
}
```

#### 签名算法说明
> 服务商分配的appid、当前时间毫秒数timestamp、商户分配的app_security、 三者通过&符号拼接成字符串进行md5加密得到。
>如：appid=xyzxyzxyz，timestamp=1555378976238，app_security=efcefcefcefcefc;
>拼接后的字符串：str=xyzxyzxyz&1555378976238&efcefcefcefcefc;
>加密后得到sign = md5(str) = 4e7e1974b79f3656aeaf03f1158f5d5d;

#### code错误码说明
|  code |  说明 |
| ------------ | ------------ |
| 200  | 成功  |
| 400  | 参数错误   |
| 404  | 请求资源不存在   |
| 500  | 系统内部错误，请联系服务商   |
| 501  |第三方服务异常 |
| 601  | 服务商未开通接口权限 |
| 602  | 账号停用 |
| 603  | 余额不足请充值 |
| 604  | 接口停用 |
| 1001 | 其他，以实际返回为准 |

返回参数 （暂无返回参数）