手册

目录

管理设备与页面的关联关系

收藏863

阅读41563

更新时间2022-04-11

配置设备与页面的关联关系

1475204329604291.png

接口说明 

配置时传入该设备需要关联的页面的id列表(该设备原有的关联关系将被直接清除);

页面的id列表允许为空,当页面的id列表为空时则会清除该设备的所有关联关系。

配置完成后,在此设备的信号范围内,即可摇出关联的页面信息。

在申请设备ID后,可直接使用接口直接配置页面。

若设备配置多个页面,则随机出现页面信息。一个设备最多可配置30个关联页面。

接口调用说明

http请求方式: POST(请使用https协议)https://api.weixin.qq.com/shakearound/device/bindpage?access_token=ACCESS_TOKENPOST数据格式:json
POST数据例子:
{
   "device_identifier":{
              "device_id":10011,
              "uuid":"FDA50693-A4E2-4FB1-AFCF-C6EB07647825",
              "major":1002,
              "minor":1223
     },
   "page_ids":[12345, 23456, 334567]
}

参数说明

参数是否必须说明
access_token调用接口凭证
page_ids待关联的页面列表
device_identifier指定页面的设备ID
device_id设备编号,若填了UUID、major、minor,则可不填设备编号,若二者都填,则以设备编号为优先
UUID、major、minorUUID、major、minor,三个信息需填写完整,若填了设备编号,则可不填此信息  

返回说明 

正常时的返回JSON数据包示例:

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

查询设备与页面的关联关系

接口说明

查询设备与页面的关联关系。提供两种查询方式,可指定页面ID分页查询该页面所关联的所有的设备信息;

也可根据设备ID或完整的UUID、Major、Minor查询该设备所关联的所有页面信息。

接口调用说明

http请求方式: POST(请使用https协议)https://api.weixin.qq.com/shakearound/relation/search?access_token=ACCESS_TOKENPOST数据格式:json
POST数据例子:
当查询指定设备所关联的页面时:
{    
  "type": 1,
  "device_identifier": {
      "device_id": 10011,
      "uuid": "FDA50693-A4E2-4FB1-AFCF-C6EB07647825",
      "major": 1002,
      "minor": 1223
  }
}
当查询页面所关联的设备时:
{
  "type": 2,
  "page_id": 11101,
  "begin": 0,
  "count": 3
}

参数说明

参数是否必须说明
access_token调用接口凭证
type查询方式。1: 查询设备的关联关系;2:查询页面的关联关系
device_identifier指定的设备;当type为1时,此项为必填
device_id设备编号,若填了UUID、major、minor,则可不填设备编号,若二者都填,则以设备编号为优先
UUID、major、minorUUID、major、minor,三个信息需填写完整,若填了设备编号,则可不填此信息
page_id指定的页面id;当type为2时,此项为必填
begin关联关系列表的起始索引值;当type为2时,此项为必填
count待查询的关联关系数量,不能超过50个;当type为2时,此项为必填   

返回说明

正常时的返回JSON数据包示例:

{
  "data": {
      "relations": [
          {
              "device_id": 797994,
              "major": 10001,
              "minor": 10023,
              "page_id": 50054,
              "uuid": "FDA50693-A4E2-4FB1-AFCF-C6EB07647825"
          },
          {
              "device_id": 797994,
              "major": 10001,
              "minor": 10023,
              "page_id": 50055,
              "uuid": "FDA50693-A4E2-4FB1-AFCF-C6EB07647825"
          }
      ],
      "total_count": 2
  },
  "errcode": 0,
  "errmsg": "success."
}

参数说明

参数说明
relations关联关系列表
device_id设备编号
UUID、major、minorUUID、major、minor
page_id摇周边页面唯一ID
total_count设备或页面的关联关系总数

科技资讯

更多

精选课程

更多
前端入门_HTML5
前端入门_HTML5

共29课时

61.7万人学习

CSS视频教程-玉女心经版
CSS视频教程-玉女心经版

共25课时

39.3万人学习

JavaScript极速入门_玉女心经系列
JavaScript极速入门_玉女心经系列

共43课时

70.9万人学习

独孤九贱(1)_HTML5视频教程
独孤九贱(1)_HTML5视频教程

共25课时

61.6万人学习

独孤九贱(2)_CSS视频教程
独孤九贱(2)_CSS视频教程

共22课时

23万人学习

独孤九贱(3)_JavaScript视频教程
独孤九贱(3)_JavaScript视频教程

共28课时

33.9万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时

125万人学习

关于我们 免责申明 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号