# 简要描述
-发送公众号通知消息,需要用户关注（potato cloud）公众号后绑定APP
# 请求URL
/api/sendWeChatMessage
# 请求头
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| Content-Type | 是 | string | 此参数必传，当请求数据非json时此参数传对应格式如（multipartform-data，application/x-www-form-urlencoded，等）是json请传application/json |
| askKey | 是 | string | 此参数必传,验证app的令牌 |
| sign | 否 | string | 此参数如果在app设置开启了验签是必传 |
| time | 否 | string | 当开启验签时，此参数为必传 |
| apiUserToken | 否 | string | 除了部分不验证用户令牌的接口以外此参数为必传（注册/登录/发送验证码）不是必传，其余都是必传 |
| nonce | 否 | string | 随机字符串(当开启V3验签此参数必传，且6分钟内不允许重复) |
# 请求方式
- post
# 请求参数说明
- 接口支持使用模板和使用直接内容发送,使用模板发送只需要传模板key（必传）和param参数（非必传）， 如果模板不需要参数则参数可以不传，如果使用直接内容发送，则head和content均为必传，不管是哪一个方式openId均为必传项
# 参数
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| openId | 是 | string | 绑定公众号后自动生成的id |
| key | 否 | string | 模板key |
| head | 否 | string | 标题 |
| content | 否 | string | 内容 |
| param | 否 | string | 参数json对象 |
| nonce | string | 随机字符串(当开启V3验签必返回次参数，且6分钟内不会重复) | |
| sign | string | 此参数如果在app设置开启了验签是必返 | |
| time | long | 当开启验签时，此参数为必返回 |
# 请求示例
{
"openId":"openUserId",
"head":"土豆api提醒标题",
"content":"土豆api提醒内容",
"key":"key",
"param":{
"参数1":1,
"参数2":1,
}
}
1
2
3
4
5
6
7
8
9
10
11
12
2
3
4
5
6
7
8
9
10
11
12
# 返回示例
{
"code": "200",
"message": "",
"status": true,
"data": null,
"pc": null,
"time": null,
"sign": null
}
1
2
3
4
5
6
7
8
9
2
3
4
5
6
7
8
9
# 返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | string | 状态码200成功403权限异常或登录超时，500请求异常 |
| status | int | 状态0删除1使用 |
| data | json | 更新对象 |
| nonce | string | 随机字符串(当开启V3验签必返回次参数，且6分钟内不会重复) |
| sign | string | 此参数如果在app设置开启了验签是必返 |
| reqSign | string | 请求签名 |
| time | long | 当开启验签时，此参数为必返回 |
# 备注
- 更多返回错误代码请查看 错误代码参考