閱讀(8.2k) 書簽贊(0) 我要糾錯

微信搖一搖頁面管理

2018-09-30 10:51 更新

頁面管理

搖一搖頁面管理

接口說明

新增搖一搖出來的頁面信息，包括在搖一搖頁面出現(xiàn)的主標題、副標題、圖片和點擊進去的超鏈接。其中，圖片必須為用素材管理接口上傳至微信側服務器后返回的鏈接。

接口調(diào)用說明

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

參數(shù)說明

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

返回說明

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

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

參數(shù)說明

參數(shù)	說明
page_id	新增頁面的頁面id

編輯頁面信息

接口說明

編輯搖一搖出來的頁面信息，包括在搖一搖頁面出現(xiàn)的主標題、副標題、圖片和點擊進去的超鏈接。

接口調(diào)用說明

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

參數(shù)說明

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

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

{
"data": {

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

? 查詢頁面列表

接口說明

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

接口調(diào)用請求說明

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

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

參數(shù)說明

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

返回說明

正常時的返回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": "測試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": "測試2"
}
],
"total_count": 2
},
"errcode": 0,
"errmsg": "success."
}

參數(shù)說明

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

刪除頁面

接口說明

刪除已有的頁面，包括在搖一搖頁面出現(xiàn)的主標題、副標題、圖片和點擊進去的超鏈接。只有頁面與設備沒有關聯(lián)關系時，才可被刪除。

接口調(diào)用請求說明

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

參數(shù)說明

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

返回說明

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

{
"data": {

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

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

← 微信設備ID

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

寫筆記

我要補充