建站
咨詢
售后
建站咨詢
新聞中心
updatableMessage.setUpdatableMsg
本接口應(yīng)在服務(wù)器端調(diào)用，詳細(xì)說明參見 服務(wù)端API。
成都創(chuàng)新互聯(lián)公司專注于任城網(wǎng)站建設(shè)服務(wù)及定制，我們擁有豐富的企業(yè)做網(wǎng)站經(jīng)驗(yàn)。 熱誠(chéng)為您提供任城營(yíng)銷型網(wǎng)站建設(shè)，任城網(wǎng)站制作、任城網(wǎng)頁(yè)設(shè)計(jì)、任城網(wǎng)站官網(wǎng)定制、小程序制作服務(wù)，打造任城網(wǎng)絡(luò)公司原創(chuàng)品牌,更為您提供任城網(wǎng)站排名全網(wǎng)營(yíng)銷落地服務(wù)。
本接口支持 云調(diào)用。需開發(fā)者工具版本 >= 1.02.1904090（最新 穩(wěn)定版下載）
wx-server-sdk >= 0.4.0
修改被分享的動(dòng)態(tài)消息。詳見動(dòng)態(tài)消息。
調(diào)用方式：
- HTTPS 調(diào)用
- 云調(diào)用
HTTPS 調(diào)用
請(qǐng)求地址
POST https://api.weixin.qq.com/cgi-bin/message/wxopen/updatablemsg/send?access_token=ACCESS_TOKEN
請(qǐng)求參數(shù)
| 屬性 | 類型 | 默認(rèn)值 | 必填 | 說明 |
|---|---|---|---|---|
| access_token | string | 是 | 接口調(diào)用憑證 | |
| activity_id | string | 是 | 動(dòng)態(tài)消息的 ID，通過 updatableMessage.createActivityId 接口獲取 | |
| target_state | number | 是 | 動(dòng)態(tài)消息修改后的狀態(tài)（具體含義見后文） | |
| template_info | Object | 是 | 動(dòng)態(tài)消息對(duì)應(yīng)的模板信息 |
target_state 的合法值
| 值 | 說明 | 最低版本 |
|---|---|---|
| 0 | 未開始 | |
| 1 | 已開始 |
template_info 的結(jié)構(gòu)
| 屬性 | 類型 | 默認(rèn)值 | 必填 | 說明 |
|---|---|---|---|---|
| parameter_list | Array. | 是 | 模板中需要修改的參數(shù) |
parameter_list 的結(jié)構(gòu)
| 屬性 | 類型 | 默認(rèn)值 | 必填 | 說明 |
|---|---|---|---|---|
| name | string | 是 | 要修改的參數(shù)名 | |
| value | string | 是 | 修改后的參數(shù)值 |
name 的合法值
| 值 | 說明 | 最低版本 |
|---|---|---|
| member_count | target_state = 0 時(shí)必填，文字內(nèi)容模板中 member_count 的值 |
|
| room_limit | target_state = 0 時(shí)必填，文字內(nèi)容模板中 room_limit 的值 |
|
| path | target_state = 1 時(shí)必填，點(diǎn)擊「進(jìn)入」啟動(dòng)小程序時(shí)使用的路徑。 對(duì)于小游戲，沒有頁(yè)面的概念，可以用于傳遞查詢字符串（query），如 "?foo=bar" |
|
| version_type | target_state = 1 時(shí)必填，點(diǎn)擊「進(jìn)入」啟動(dòng)小程序時(shí)使用的版本。 有效參數(shù)值為： develop（開發(fā)版），trial（體驗(yàn)版），release（正式版） |
返回值
Object
返回的 JSON 數(shù)據(jù)包
| 屬性 | 類型 | 說明 |
|---|---|---|
| errcode | number | 錯(cuò)誤碼 |
| errmsg | number | 錯(cuò)誤信息 |
errcode 的合法值
| 值 | 說明 | 最低版本 |
|---|---|---|
| 0 | 請(qǐng)求成功 | |
| -1 | 系統(tǒng)繁忙。此時(shí)請(qǐng)開發(fā)者稍候再試 | |
| 42001 | access_token 過期 | |
| 44002 | post 數(shù)據(jù)為空 | |
| 47001 | post 數(shù)據(jù)中參數(shù)缺失 | |
| 47501 | 參數(shù) activity_id 錯(cuò)誤 | |
| 47502 | 參數(shù) target_state 錯(cuò)誤 | |
| 47503 | 參數(shù) version_type 錯(cuò)誤 | |
| 47504 | activity_id 過期 |
消息狀態(tài)
消息有兩個(gè)狀態(tài)（target_state），分別有其對(duì)應(yīng)的文字內(nèi)容和顏色。文字內(nèi)容模板和顏色不支持變更。
| 狀態(tài) | 文字內(nèi)容 | 顏色 | 允許轉(zhuǎn)移的狀態(tài) |
|---|---|---|---|
| 0 | "成員正在加入，當(dāng)前 {member_count}/{room_limit} 人" | #FA9D39 | 0, 1 |
| 1 | "已開始" | #CCCCCC | 無(wú) |
活動(dòng)的默認(rèn)有效期是 24 小時(shí)。活動(dòng)結(jié)束后，消息內(nèi)容會(huì)變成統(tǒng)一的樣式：
- 文字內(nèi)容：“已結(jié)束”
- 文字顏色：#00ff00
curl 調(diào)用示例
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'
云調(diào)用
云調(diào)用是小程序·云開發(fā)提供的在云函數(shù)中調(diào)用微信開放接口的能力，需要在云函數(shù)中通過 wx-server-sdk 使用。
接口方法
openapi.updatableMessage.setUpdatableMsg
需在 config.json 中配置 updatableMessage.setUpdatableMsg API 的權(quán)限， 詳情
請(qǐng)求參數(shù)
| 屬性 | 類型 | 默認(rèn)值 | 必填 | 說明 |
|---|---|---|---|---|
| activityId | string | 是 | 動(dòng)態(tài)消息的 ID，通過 updatableMessage.createActivityId 接口獲取 | |
| targetState | number | 是 | 動(dòng)態(tài)消息修改后的狀態(tài)（具體含義見后文） | |
| templateInfo | Object | 是 | 動(dòng)態(tài)消息對(duì)應(yīng)的模板信息 |
targetState 的合法值
| 值 | 說明 | 最低版本 |
|---|---|---|
| 0 | 未開始 | |
| 1 | 已開始 |
templateInfo 的結(jié)構(gòu)
| 屬性 | 類型 | 默認(rèn)值 | 必填 | 說明 |
|---|---|---|---|---|
| parameterList | Array. | 是 | 模板中需要修改的參數(shù) |
parameterList 的結(jié)構(gòu)
| 屬性 | 類型 | 默認(rèn)值 | 必填 | 說明 |
|---|---|---|---|---|
| name | string | 是 | 要修改的參數(shù)名 | |
| value | string | 是 | 修改后的參數(shù)值 |
name 的合法值
| 值 | 說明 | 最低版本 |
|---|---|---|
| member_count | target_state = 0 時(shí)必填，文字內(nèi)容模板中 member_count 的值 |
|
| room_limit | target_state = 0 時(shí)必填，文字內(nèi)容模板中 room_limit 的值 |
|
| path | target_state = 1 時(shí)必填，點(diǎn)擊「進(jìn)入」啟動(dòng)小程序時(shí)使用的路徑。 對(duì)于小游戲，沒有頁(yè)面的概念，可以用于傳遞查詢字符串（query），如 "?foo=bar" |
|
| version_type | target_state = 1 時(shí)必填，點(diǎn)擊「進(jìn)入」啟動(dòng)小程序時(shí)使用的版本。 有效參數(shù)值為： develop（開發(fā)版），trial（體驗(yàn)版），release（正式版） |
返回值
Object
返回的 JSON 數(shù)據(jù)包
| 屬性 | 類型 | 說明 |
|---|---|---|
| errCode | number | 錯(cuò)誤碼 |
| errMsg | number | 錯(cuò)誤信息 |
errCode 的合法值
| 值 | 說明 | 最低版本 |
|---|---|---|
| 0 | 成功 |
異常
Object
拋出的異常
| 屬性 | 類型 | 說明 |
|---|---|---|
| errCode | number | 錯(cuò)誤碼 |
| errMsg | number | 錯(cuò)誤信息 |
errCode 的合法值
| 值 | 說明 | 最低版本 |
|---|---|---|
| -1 | 系統(tǒng)繁忙。此時(shí)請(qǐng)開發(fā)者稍候再試 | |
| 42001 | access_token 過期 | |
| 44002 | post 數(shù)據(jù)為空 | |
| 47001 | post 數(shù)據(jù)中參數(shù)缺失 | |
| 47501 | 參數(shù) activity_id 錯(cuò)誤 | |
| 47502 | 參數(shù) target_state 錯(cuò)誤 | |
| 47503 | 參數(shù) version_type 錯(cuò)誤 | |
| 47504 | activity_id 過期 |
分享文章：創(chuàng)新互聯(lián)小程序教程：微信小程序setUpdatableMsg
網(wǎng)頁(yè)URL：http://m.5511xx.com/article/djgigpg.html
