摇一摇周边-页面管理

安哥网络

目录

• 1 新增页面
• 2 编辑页面信息
• 3 查询页面列表
• 4 删除页面
  

新增页面新增摇一摇出来的页面信息，包括在摇一摇页面出现的主标题、副标题、图片和点击进去的超链接。其中，图片必须为用素材管理接口上传至微信侧服务器后返回的链接。
接口调用说明
http请求方式: POST（请使用https协议）https://api.weixin.qq.com/shakearound/page/add?access_token=ACCESS_TOKENPOST数据格式：jsonPOST数据例子：{   "title":"主标题",      "description":"副标题",           "page_url":" https://zb.weixin.qq.com ",           "comment":"数据示例",   "icon_url":"http://3gimg.qq.com/shake_nearby/dy/icon "}参数说明

参数	是否必须	说明
access_token	是	调用接口凭证
title	是	在摇一摇页面展示的主标题，不超过6个字
description	是	在摇一摇页面展示的副标题，不超过7个字
icon_url	是	在摇一摇页面展示的图片。图片需先上传至微信侧服务器，用“素材管理-上传图片素材”接口上传图片，返回的图片URL再配置在此处
comment	否	页面的备注信息，不超过15个字

返回说明正常时的返回JSON数据包示例：
{    "data": {        "page_id": 28840    }    "errcode": 0,    "errmsg": "success."}参数说明

参数	说明
page_id	新增页面的页面id

编辑页面信息编辑摇一摇出来的页面信息，包括在摇一摇页面出现的主标题、副标题、图片和点击进去的超链接。
接口调用说明
http请求方式: POST（请使用https协议）https://api.weixin.qq.com/shakearound/page/update?access_token=ACCESS_TOKENPOST数据格式：jsonPOST数据例子：{ "page_id":12306 "title":"主标题",    "description":"副标题",         "page_url":" https://zb.weixin.qq.com ",         "comment":"数据示例", "icon_url":" http://3gimg.qq.com/shake_nearby/dy/icon"}参数说明

参数	是否必须	说明
access_token	是	调用接口凭证
page_id	是	摇周边页面唯一ID
title	是	在摇一摇页面展示的主标题，不超过6个字
description	是	在摇一摇页面展示的副标题，不超过7个字
icon_url	是	在摇一摇页面展示的图片。图片需先上传至微信侧服务器，用“素材管理-上传图片素材”接口上传图片，返回的图片URL再配置在此处
page_url	是	跳转链接
comment	否	页面的备注信息，不超过15个字

返回说明正常时的返回JSON数据包示例：
{    "data": {        "page_id": 28840    },    "errcode": 0,    "errmsg": "success."}参数说明

参数	说明
page_id	编辑页面的页面id

查询页面列表查询已有的页面，包括在摇一摇页面出现的主标题、副标题、图片和点击进去的超链接。提供两种查询方式，可指定页面ID查询，也可批量拉取页面列表。
接口调用请求说明
http请求方式: POST（请使用https协议）https://api.weixin.qq.com/shakearound/page/search?access_token=ACCESS_TOKENPOST数据格式：jsonPOST数据例子：需要查询指定页面时：{    "page_ids":[12345, 23456, 34567]}需要分页查询或者指定范围内的页面时：{    "begin": 0,                    "count": 3}参数说明

参数	是否必须	说明
access_token	是	调用接口凭证
page_ids	是	指定页面的id列表
begin	是	页面列表的起始索引值
count	是	待查询的页面个数

返回说明正常时的返回JSON数据包示例：
{    "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."}参数说明

参数	说明
total_count	商户名下的页面总数
page_id	摇周边页面唯一ID
title	在摇一摇页面展示的主标题，
description	在摇一摇页面展示的副标题
icon_url	在摇一摇页面展示的图片
page_url	跳转链接
comment	页面的备注信息

删除页面删除已有的页面，包括在摇一摇页面出现的主标题、副标题、图片和点击进去的超链接。只有页面与设备没有关联关系时，才可被删除。接口调用请求说明
http请求方式: POST（请使用https协议）https://api.weixin.qq.com/shakearound/page/delete?access_token=ACCESS_TOKENPOST数据格式：jsonPOST数据例子：{    "page_ids":[12345,23456,34567]}参数说明

参数	是否必须	说明
page_ids	是	指定页面的id列表

返回说明正常时的返回JSON数据包示例：
{    "data": {            },    "errcode": 0,    "errmsg": "success."}
摘自http://mp.weixin.qq.com/wiki/5/6 ... 46d8e46cf13251.html