C#开发微信门户及应用(28)--微信“摇一摇·周边”功能的使用和接口的实现

    /// <summary>
    ///摇一摇周边的接口定义/// </summary>
    public interfaceIShakeAround

    {#region 设备管理
        /// <summary>
        ///申请设备ID。///接口说明 申请配置设备所需的UUID、Major、Minor。///若激活率小于50%，不能新增设备。单次新增设备超过500个，需走人工审核流程。审核通过后，可用返回的批次ID用“查询设备列表”接口拉取本次申请的设备ID。/// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="applyInfo">设备申请信息</param>
        ShakeDeviceApplyJson ApplyDevice(stringaccessToken, ShakeDeviceAddJson applyInfo);/// <summary>
        ///编辑设备信息。///接口说明 编辑设备的备注信息。可用设备ID或完整的UUID、Major、Minor指定设备，二者选其一。/// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="info">设备信息</param>
        /// <param name="comment">设备的备注信息，不超过15个汉字或30个英文字母。</param>
        /// <returns></returns>
        CommonResult UpdateDevice(string accessToken, ShakeDeviceIdentifier info, stringcomment);/// <summary>
        ///配置设备与门店的关联关系。接口说明 修改设备关联的门店ID、设备的备注信息。可用设备ID或完整的UUID、Major、Minor指定设备，二者选其一。/// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="info">设备信息</param>
        /// <param name="poi_id">待关联的门店ID</param>
        /// <returns></returns>
        CommonResult BindDevice(string accessToken, ShakeDeviceIdentifier info, intpoi_id);/// <summary>
        ///查询设备列表.///接口说明 查询已有的设备ID、UUID、Major、Minor、激活状态、备注信息、关联门店、关联页面等信息。可指定设备ID或完整的UUID、Major、Minor查询，也可批量拉取设备信息列表。/// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="device_identifiers">设备列表信息</param>
        /// <returns></returns>
        ShakeDeviceSearchList SearchDevice(string accessToken, List<ShakeDeviceIdentifier>device_identifiers);/// <summary>
        ///查询设备列表.///接口说明 查询已有的设备ID、UUID、Major、Minor、激活状态、备注信息、关联门店、关联页面等信息。可指定设备ID或完整的UUID、Major、Minor查询，也可批量拉取设备信息列表。/// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="data">分页查询条件。apply_id为批次ID，如果指定则以批次进行查询，否则以指定范围查询。</param>
        /// <returns></returns>
        ShakeDeviceSearchList SearchDevice(stringaccessToken, ShakeDeviceSearchPaging data);#endregion

        /// <summary>
        ///申请设备ID。///接口说明 申请配置设备所需的UUID、Major、Minor。///若激活率小于50%，不能新增设备。单次新增设备超过500个，需走人工审核流程。审核通过后，可用返回的批次ID用“查询设备列表”接口拉取本次申请的设备ID。/// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="applyInfo">设备申请信息</param>
        public ShakeDeviceApplyJson ApplyDevice(stringaccessToken, ShakeDeviceAddJson applyInfo)

        {var url = string.Format("https://api.weixin.qq.com/shakearound/device/applyid?access_token={0}", accessToken);string postData =applyInfo.ToJson();



            ShakeDeviceApplyJson data= null;

            ShakeDeviceApplyResult result= JsonHelper<ShakeDeviceApplyResult>.ConvertJson(url, postData);if (result != null)

            {

                data=result.data;

            }returndata;

        }

        #region 页面管理

        /// <summary>
        ///新增页面。///新增摇一摇出来的页面信息，包括在摇一摇页面出现的主标题、副标题、图片和点击进去的超链接。///其中，图片必须为用素材管理接口上传至微信侧服务器后返回的链接。/// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="info">新增页面POST数据对象</param>
        /// <returns></returns>
        ShakePageResult AddPage(stringaccessToken, ShakePageJson info);/// <summary>
        ///编辑页面信息。///编辑摇一摇出来的页面信息，包括在摇一摇页面出现的主标题、副标题、图片和点击进去的超链接。/// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="info">编辑页面POST数据对象</param>
        /// <returns></returns>
        ShakePageResult UpdatePage(stringaccessToken, ShakePageJson info);/// <summary>
        ///查询页面列表。///查询已有的页面，包括在摇一摇页面出现的主标题、副标题、图片和点击进去的超链接。///提供询方式:指定页面ID查询。/// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="begin">页面列表的起始索引值</param>
        /// <param name="count">待查询的页面个数</param>
        /// <returns></returns>
        ShakePageSearchJson SearchPage(string accessToken, int begin, intcount);/// <summary>
        ///查询页面列表。///查询已有的页面，包括在摇一摇页面出现的主标题、副标题、图片和点击进去的超链接。///提供询方式:批量拉取页面列表/// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="page_ids">指定页面的id列表</param>
        /// <returns></returns>
        ShakePageSearchJson SearchPage(string accessToken, List<int>page_ids);/// <summary>
        ///查询页面列表。///查询已有的页面，包括在摇一摇页面出现的主标题、副标题、图片和点击进去的超链接。///提供两种查询方式，可指定页面ID查询，也可批量拉取页面列表。/// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="info"></param>
        /// <returns></returns>
        ShakePageSearchJson SearchPage(stringaccessToken, ShakePageSearchPaging info);/// <summary>
        ///删除页面。///删除已有的页面，包括在摇一摇页面出现的主标题、副标题、图片和点击进去的超链接。///只有页面与设备没有关联关系时，才可被删除。/// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="page_ids">指定页面的id列表</param>
        /// <returns></returns>
        CommonResult DeletePage(string accessToken, List<int>page_ids);#endregion 页面管理

       /// <summary>
        ///摇一摇设备的申请、修改、绑定处理操作测试/// </summary>
        private void btnDevice_Click(objectsender, EventArgs e)

        {try{int poi_id = 275961135;

                ShakeDeviceApplyJson result= api.ApplyDevice(this.token, new ShakeDeviceAddJson() { quantity = 1, apply_reason = "测试", comment = "测试备注", poi_id =poi_id });if (result != null)

                {

                    Console.WriteLine(result.ToJson());if (result.device_identifiers != null)

                    {

                        ShakeDeviceIdentifier device= result.device_identifiers[0];if (device != null)

                        {int device_id = device.device_id; //465123;
Console.WriteLine(device_id);string comment = "修改的备注";

                            ShakeDeviceIdentifier info= newShakeDeviceIdentifier(device.device_id, device.uuid, device.major, device.minor);

                            CommonResult comResult= api.UpdateDevice(this.token, info, comment);

                            MessageUtil.ShowTips(comResult.Success? "操作成功" : "修改设备失败:" +comResult.ErrorMessage);



                            comResult= api.BindDevice(this.token, info, poi_id);

                            MessageUtil.ShowTips(comResult.Success? "操作成功" : "修改设备失败:" +comResult.ErrorMessage);

                        }

                    }

                }

            }catch(Exception ex)

            {

                Console.WriteLine(ex);

            }



        }

        /// <summary>
        ///增加摇一摇素材、增加页面、修改页面、删除页面的操作示例代码/// </summary>
        private void btnPage_Click(objectsender, EventArgs e)

        {string file = FileDialogHelper.OpenImage(false);if(string.IsNullOrEmpty(file))

            {return;

            }



            ShakeMaterialJson mediaJson= api.AddMaterail(this.token, file);if (mediaJson != null)

            {

                ShakePageJson json= newShakePageJson()

                {

                    title= "主标题",

                    description= "副标题",

                    comment= "备注说明",

                    page_url= "https://www.iqidi.com",

                    icon_url=mediaJson.pic_url

                };

                ShakePageResult result= api.AddPage(this.token, json);if (result != null)

                {

                    Console.WriteLine(result.ToJson());if (result.data != null)

                    {

                        json.page_id=result.data.page_id;

                        json.comment= "修改备注信息";



                        result= api.UpdatePage(this.token, json);if (result != null)

                        {

                            Console.WriteLine("修改页面");

                            Console.WriteLine(result.ToJson());

                        }



                        CommonResult comResult= api.DeletePage(this.token, new List<int>() { json.page_id.Value });

                        MessageUtil.ShowTips(comResult.Success? "删除页面操作成功" : "删除页面失败:" +comResult.ErrorMessage);

                    }

                }

            }

        }