微信小程序 setUpdatableMsg
2022-05-11 14:53 更新
updatableMessage.setUpdatableMsg
本接口应在服务器端调用,详细说明参见服务端API。
本接口支持云调用。需开发者工具版本 >= 1.02.1904090(最新稳定版下载)
wx-server-sdk >= 0.4.0
修改被分享的动态消息。详见动态消息。
调用方式:
- HTTPS 调用
- 云调用
HTTPS 调用
请求地址
POST https://api.weixin.qq.com/cgi-bin/message/wxopen/updatablemsg/send?access_token=ACCESS_TOKEN
请求参数
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
access_token | string | 是 | 接口调用凭证 | |
activity_id | string | 是 | 动态消息的 ID,通过 updatableMessage.createActivityId 接口获取 | |
target_state | number | 是 | 动态消息修改后的状态(具体含义见后文) | |
template_info | Object | 是 | 动态消息对应的模板信息 |
target_state 的合法值
值 | 说明 | 最低版本 |
---|---|---|
0 | 未开始 | |
1 | 已开始 |
template_info 的结构
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
parameter_list | Array.<Object> | 是 | 模板中需要修改的参数 |
parameter_list 的结构
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
name | string | 是 | 要修改的参数名 | |
value | string | 是 | 修改后的参数值 |
name 的合法值
值 | 说明 | 最低版本 |
---|---|---|
member_count | target_state = 0 时必填,文字内容模板中 member_count 的值 |
|
room_limit | target_state = 0 时必填,文字内容模板中 room_limit 的值 |
|
path | target_state = 1 时必填,点击「进入」启动小程序时使用的路径。
对于小游戏,没有页面的概念,可以用于传递查询字符串(query),如 "?foo=bar"
|
|
version_type | target_state = 1 时必填,点击「进入」启动小程序时使用的版本。
有效参数值为: develop (开发版),trial (体验版),release (正式版) |
返回值
Object
返回的 JSON 数据包
属性 | 类型 | 说明 |
---|---|---|
errcode | number | 错误码 |
errmsg | number | 错误信息 |
errcode 的合法值
值 | 说明 | 最低版本 |
---|---|---|
0 | 请求成功 | |
-1 | 系统繁忙。此时请开发者稍候再试 | |
42001 | access_token 过期 | |
44002 | post 数据为空 | |
47001 | post 数据中参数缺失 | |
47501 | 参数 activity_id 错误 | |
47502 | 参数 target_state 错误 | |
47503 | 参数 version_type 错误 | |
47504 | activity_id 过期 |
消息状态
消息有两个状态(target_state),分别有其对应的文字内容和颜色。文字内容模板和颜色不支持变更。
状态 | 文字内容 | 颜色 | 允许转移的状态 |
---|---|---|---|
0 | "成员正在加入,当前 {member_count}/{room_limit} 人" | #FA9D39 | 0, 1 |
1 | "已开始" | #CCCCCC | 无 |
活动的默认有效期是 24 小时。活动结束后,消息内容会变成统一的样式:
- 文字内容:“已结束”
- 文字颜色:#00ff00
curl 调用示例
curl -d '{"activity_id": "966_NGiqxxxxxxxxx...xxxxxxxxE33BlwX", "target_state": 0, "template_info": {"parameter_list": [{"name": "member_count", "value": "2"}, {"name":"room_limit", "value": "5"} ] } }' \
'https://api.weixin.qq.com/cgi-bin/message/wxopen/updatablemsg/send?access_token=ACCESS_TOKEN'
云调用
云调用是小程序·云开发提供的在云函数中调用微信开放接口的能力,需要在云函数中通过 wx-server-sdk 使用。
接口方法
openapi.updatableMessage.setUpdatableMsg
需在 config.json 中配置 updatableMessage.setUpdatableMsg API 的权限,详情
请求参数
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
activityId | string | 是 | 动态消息的 ID,通过 updatableMessage.createActivityId 接口获取 | |
targetState | number | 是 | 动态消息修改后的状态(具体含义见后文) | |
templateInfo | Object | 是 | 动态消息对应的模板信息 |
targetState 的合法值
值 | 说明 | 最低版本 |
---|---|---|
0 | 未开始 | |
1 | 已开始 |
templateInfo 的结构
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
parameterList | Array.<Object> | 是 | 模板中需要修改的参数 |
parameterList 的结构
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
name | string | 是 | 要修改的参数名 | |
value | string | 是 | 修改后的参数值 |
name 的合法值
值 | 说明 | 最低版本 |
---|---|---|
member_count | target_state = 0 时必填,文字内容模板中 member_count 的值 |
|
room_limit | target_state = 0 时必填,文字内容模板中 room_limit 的值 |
|
path | target_state = 1 时必填,点击「进入」启动小程序时使用的路径。
对于小游戏,没有页面的概念,可以用于传递查询字符串(query),如 "?foo=bar"
|
|
version_type | target_state = 1 时必填,点击「进入」启动小程序时使用的版本。
有效参数值为: develop (开发版),trial (体验版),release (正式版) |
返回值
Object
返回的 JSON 数据包
属性 | 类型 | 说明 |
---|---|---|
errCode | number | 错误码 |
errMsg | number | 错误信息 |
errCode 的合法值
值 | 说明 | 最低版本 |
---|---|---|
0 | 成功 |
异常
Object
抛出的异常
属性 | 类型 | 说明 |
---|---|---|
errCode | number | 错误码 |
errMsg | number | 错误信息 |
errCode 的合法值
值 | 说明 | 最低版本 |
---|---|---|
-1 | 系统繁忙。此时请开发者稍候再试 | |
42001 | access_token 过期 | |
44002 | post 数据为空 | |
47001 | post 数据中参数缺失 | |
47501 | 参数 activity_id 错误 | |
47502 | 参数 target_state 错误 | |
47503 | 参数 version_type 错误 | |
47504 | activity_id 过期 |
以上内容是否对您有帮助:
更多建议: