收藏187
分享
阅读41563
更新时间2022-04-11

接口说明
新增摇一摇出来的页面信息,包括在摇一摇页面出现的主标题、副标题、图片和点击进去的超链接。其中,图片必须为用素材管理接口上传至微信侧服务器后返回的链接。
接口调用说明
http请求方式: POST(请使用https协议)https://api.weixin.qq.com/shakearound/page/add?access_token=ACCESS_TOKENPOST数据格式:json
POST数据例子:
{
  "title":"主标题",   
  "description":"副标题",
  "page_url":" https://zb.weixin.qq.com ",
  "comment":"数据示例",
  "icon_url":"http://3gimg.qq.com/shake_nearby/dy/icon "
}
参数说明
| 参数 | 是否必须 | 说明 | 
| access_token | 是 | 调用接口凭证 | 
| title | 是 | 在摇一摇页面展示的主标题,不超过6个汉字或12个英文字母 | 
| description | 是 | 在摇一摇页面展示的副标题,不超过7个汉字或14个英文字母 | 
| icon_url | 是 | 在摇一摇页面展示的图片。图片需先上传至微信侧服务器,用“素材管理-上传图片素材”接口上传图片,返回的图片URL再配置在此处 | 
| comment | 否 | 页面的备注信息,不超过15个汉字或30个英文字母 | 
返回说明
正常时的返回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数据格式:json
POST数据例子:
{
"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个汉字或12个英文字母 | 
| description | 是 | 在摇一摇页面展示的副标题,不超过7个汉字或14个英文字母 | 
| icon_url | 是 | 在摇一摇页面展示的图片。图片需先上传至微信侧服务器,用“素材管理-上传图片素材”接口上传图片,返回的图片URL再配置在此处 | 
| page_url | 是 | 跳转链接 | 
| comment | 否 | 页面的备注信息,不超过15个汉字或30个英文字母 | 
返回说明 正常时的返回JSON数据包示例:
{
   "data": {
       
   },
   "errcode": 0,
   "errmsg": "success."
}
接口说明
查询已有的页面,包括在摇一摇页面出现的主标题、副标题、图片和点击进去的超链接。提供两种查询方式,可指定页面ID查询,也可批量拉取页面列表。
接口调用请求说明
http请求方式: POST(请使用https协议)https://api.weixin.qq.com/shakearound/page/search?access_token=ACCESS_TOKENPOST数据格式:json
POST数据例子:
需要查询指定页面时:
{
   "type": 1,
   "page_ids":[12345, 23456, 34567]
}
需要分页查询或者指定范围内的页面时:
{
   "type": 2,
   "begin": 0,
   "count": 3
}
参数说明
| 参数 | 是否必须 | 说明 | 
| access_token | 是 | 调用接口凭证 | 
| type | 是 | 查询类型。1: 查询页面id列表中的页面信息;2:分页查询所有页面信息 | 
| page_ids | 是 | 指定页面的id列表;当type为1时,此项为必填 | 
| begin | 是 | 页面列表的起始索引值;当type为2时,此项为必填 | 
| count | 是 | 待查询的页面数量,不能超过50个;当type为2时,此项为必填 | 
返回说明
正常时的返回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数据格式:json
POST数据例子:
{
   "page_id":34567
}
参数说明
| 参数 | 是否必须 | 说明 | 
| page_id | 是 | 指定页面的id | 
返回说明
正常时的返回JSON数据包示例:
{
   "data": {
       
   },
   "errcode": 0,
   "errmsg": "success."
}
相关
视频
RELATED VIDEOS
科技资讯
1
2
3
4
5
6
7
8
9
精选课程
							
							共5课时
17.2万人学习
							
							共49课时
77万人学习
							
							共29课时
61.7万人学习
							
							共25课时
39.3万人学习
							
							共43课时
70.9万人学习
							
							共25课时
61.6万人学习
							
							共22课时
23万人学习
							
							共28课时
33.9万人学习
							
							共89课时
125万人学习