閱讀(8.2k) 書(shū)簽贊(0) 我要糾錯(cuò)

微信搖一搖頁(yè)面管理

2018-09-30 10:51 更新

頁(yè)面管理

搖一搖頁(yè)面管理

接口說(shuō)明

新增搖一搖出來(lái)的頁(yè)面信息，包括在搖一搖頁(yè)面出現(xiàn)的主標(biāo)題、副標(biāo)題、圖片和點(diǎn)擊進(jìn)去的超鏈接。其中，圖片必須為用素材管理接口上傳至微信側(cè)服務(wù)器后返回的鏈接。

接口調(diào)用說(shuō)明

http請(qǐng)求方式: POST（請(qǐng)使用https協(xié)議）https://api.weixin.qq.com/shakearound/page/add?access_token=ACCESS_TOKENPOST數(shù)據(jù)格式：json
POST數(shù)據(jù)例子：
{
"title":"主標(biāo)題",
"description":"副標(biāo)題",
"page_url":" https://zb.weixin.qq.com ",
"comment":"數(shù)據(jù)示例",
"icon_url":"http://3gimg.qq.com/shake_nearby/dy/icon "
}

參數(shù)說(shuō)明

參數(shù)	是否必須	說(shuō)明
access_token	是	調(diào)用接口憑證
title	是	在搖一搖頁(yè)面展示的主標(biāo)題，不超過(guò)6個(gè)漢字或12個(gè)英文字母
description	是	在搖一搖頁(yè)面展示的副標(biāo)題，不超過(guò)7個(gè)漢字或14個(gè)英文字母
icon_url	是	在搖一搖頁(yè)面展示的圖片。圖片需先上傳至微信側(cè)服務(wù)器，用“素材管理-上傳圖片素材”接口上傳圖片，返回的圖片URL再配置在此處
comment	否	頁(yè)面的備注信息，不超過(guò)15個(gè)漢字或30個(gè)英文字母

返回說(shuō)明

正常時(shí)的返回JSON數(shù)據(jù)包示例：

{
"data": {
"page_id": 28840
}
"errcode": 0,
"errmsg": "success."
}

參數(shù)說(shuō)明

參數(shù)	說(shuō)明
page_id	新增頁(yè)面的頁(yè)面id

編輯頁(yè)面信息

接口說(shuō)明

編輯搖一搖出來(lái)的頁(yè)面信息，包括在搖一搖頁(yè)面出現(xiàn)的主標(biāo)題、副標(biāo)題、圖片和點(diǎn)擊進(jìn)去的超鏈接。

接口調(diào)用說(shuō)明

http請(qǐng)求方式: POST（請(qǐng)使用https協(xié)議）https://api.weixin.qq.com/shakearound/page/update?access_token=ACCESS_TOKENPOST數(shù)據(jù)格式：json
POST數(shù)據(jù)例子：
{
"page_id":12306
"title":"主標(biāo)題",
"description":"副標(biāo)題",
"page_url":" https://zb.weixin.qq.com ",
"comment":"數(shù)據(jù)示例",
"icon_url":" http://3gimg.qq.com/shake_nearby/dy/icon"
}

參數(shù)說(shuō)明

參數(shù)	是否必須	說(shuō)明
access_token	是	調(diào)用接口憑證
page_id	是	搖周邊頁(yè)面唯一ID
title	是	在搖一搖頁(yè)面展示的主標(biāo)題，不超過(guò)6個(gè)漢字或12個(gè)英文字母
description	是	在搖一搖頁(yè)面展示的副標(biāo)題，不超過(guò)7個(gè)漢字或14個(gè)英文字母
icon_url	是	在搖一搖頁(yè)面展示的圖片。圖片需先上傳至微信側(cè)服務(wù)器，用“素材管理-上傳圖片素材”接口上傳圖片，返回的圖片URL再配置在此處
page_url	是	跳轉(zhuǎn)鏈接
comment	否	頁(yè)面的備注信息，不超過(guò)15個(gè)漢字或30個(gè)英文字母

返回說(shuō)明正常時(shí)的返回JSON數(shù)據(jù)包示例：

{
"data": {

},
"errcode": 0,
"errmsg": "success."
}

? 查詢頁(yè)面列表

接口說(shuō)明

查詢已有的頁(yè)面，包括在搖一搖頁(yè)面出現(xiàn)的主標(biāo)題、副標(biāo)題、圖片和點(diǎn)擊進(jìn)去的超鏈接。提供兩種查詢方式，可指定頁(yè)面ID查詢，也可批量拉取頁(yè)面列表。

接口調(diào)用請(qǐng)求說(shuō)明

http請(qǐng)求方式: POST（請(qǐng)使用https協(xié)議）https://api.weixin.qq.com/shakearound/page/search?access_token=ACCESS_TOKENPOST數(shù)據(jù)格式：json
POST數(shù)據(jù)例子：
需要查詢指定頁(yè)面時(shí)：
{
"type": 1,
"page_ids":[12345, 23456, 34567]
}

需要分頁(yè)查詢或者指定范圍內(nèi)的頁(yè)面時(shí)：
{
"type": 2,
"begin": 0,
"count": 3
}

參數(shù)說(shuō)明

參數(shù)	是否必須	說(shuō)明
access_token	是	調(diào)用接口憑證
type	是	查詢類型。1：查詢頁(yè)面id列表中的頁(yè)面信息；2：分頁(yè)查詢所有頁(yè)面信息
page_ids	是	指定頁(yè)面的id列表；當(dāng)type為1時(shí)，此項(xiàng)為必填
begin	是	頁(yè)面列表的起始索引值；當(dāng)type為2時(shí)，此項(xiàng)為必填
count	是	待查詢的頁(yè)面數(shù)量，不能超過(guò)50個(gè)；當(dāng)type為2時(shí)，此項(xiàng)為必填

返回說(shuō)明

正常時(shí)的返回JSON數(shù)據(jù)包示例：

{
"data": {
"pages": [
{
"comment": "just for test",
"description": "test",
"icon_url": "https://www.baidu.com/img/bd_logo1",
"page_id": 28840,
"page_url": "http://xw.qq.com/testapi1",
"title": "測(cè)試1"
},
{
"comment": "just for test",
"description": "test",
"icon_url": "https://www.baidu.com/img/bd_logo1",
"page_id": 28842,
"page_url": "http://xw.qq.com/testapi2",
"title": "測(cè)試2"
}
],
"total_count": 2
},
"errcode": 0,
"errmsg": "success."
}

參數(shù)說(shuō)明

參數(shù)	說(shuō)明
total_count	商戶名下的頁(yè)面總數(shù)
page_id	搖周邊頁(yè)面唯一ID
title	在搖一搖頁(yè)面展示的主標(biāo)題，
description	在搖一搖頁(yè)面展示的副標(biāo)題
icon_url	在搖一搖頁(yè)面展示的圖片
page_url	跳轉(zhuǎn)鏈接
comment	頁(yè)面的備注信息

刪除頁(yè)面

接口說(shuō)明

刪除已有的頁(yè)面，包括在搖一搖頁(yè)面出現(xiàn)的主標(biāo)題、副標(biāo)題、圖片和點(diǎn)擊進(jìn)去的超鏈接。只有頁(yè)面與設(shè)備沒(méi)有關(guān)聯(lián)關(guān)系時(shí)，才可被刪除。

接口調(diào)用請(qǐng)求說(shuō)明

http請(qǐng)求方式: POST（請(qǐng)使用https協(xié)議）https://api.weixin.qq.com/shakearound/page/delete?access_token=ACCESS_TOKENPOST數(shù)據(jù)格式：json
POST數(shù)據(jù)例子：
{
"page_id":34567
}

參數(shù)說(shuō)明

參數(shù)	是否必須	說(shuō)明
page_id	是	指定頁(yè)面的id

返回說(shuō)明

正常時(shí)的返回JSON數(shù)據(jù)包示例：

{
"data": {

},
"errcode": 0,
"errmsg": "success."
}

以上內(nèi)容是否對(duì)您有幫助：

← 微信設(shè)備ID

微信搖一搖上傳圖片素材 →

寫(xiě)筆記

我要補(bǔ)充