C#開發(fā)微信門戶及應(yīng)用(28)--微信“搖一搖·周邊”功能的使用和接口的實現(xiàn)
2021-07-25 16:53:41

    /// <summary>
    /// 搖一搖周邊的接口定義
    /// </summary>
    public interface IShakeAround
    {
        #region 設(shè)備管理
        /// <summary>
        /// 申請設(shè)備ID。
        /// 接口說明 申請配置設(shè)備所需的UUID、Major、Minor。
        /// 若激活率小于50%，不能新增設(shè)備。單次新增設(shè)備超過500個，需走人工審核流程。審核通過后，可用返回的批次ID用“查詢設(shè)備列表”接口拉取本次申請的設(shè)備ID。
        /// </summary>
        /// <param name="accessToken">調(diào)用接口憑證</param>
        /// <param name="applyInfo">設(shè)備申請信息</param>
        ShakeDeviceApplyJson ApplyDevice(string accessToken, ShakeDeviceAddJson applyInfo);

        /// <summary>
        /// 編輯設(shè)備信息。
        /// 接口說明 編輯設(shè)備的備注信息。可用設(shè)備ID或完整的UUID、Major、Minor指定設(shè)備，二者選其一。
        /// </summary>
        /// <param name="accessToken">調(diào)用接口憑證</param>
        /// <param name="info">設(shè)備信息</param>
        /// <param name="comment">設(shè)備的備注信息，不超過15個漢字或30個英文字母。</param>
        /// <returns></returns>
        CommonResult UpdateDevice(string accessToken, ShakeDeviceIdentifier info, string comment);

        /// <summary>
        /// 配置設(shè)備與門店的關(guān)聯(lián)關(guān)系。接口說明 修改設(shè)備關(guān)聯(lián)的門店ID、設(shè)備的備注信息?？捎迷O(shè)備ID或完整的UUID、Major、Minor指定設(shè)備，二者選其一。
        /// </summary>
        /// <param name="accessToken">調(diào)用接口憑證</param>
        /// <param name="info">設(shè)備信息</param>
        /// <param name="poi_id">待關(guān)聯(lián)的門店ID</param>
        /// <returns></returns>
        CommonResult BindDevice(string accessToken, ShakeDeviceIdentifier info, int poi_id);

        /// <summary>
        /// 查詢設(shè)備列表.
        /// 接口說明 查詢已有的設(shè)備ID、UUID、Major、Minor、激活狀態(tài)、備注信息、關(guān)聯(lián)門店、關(guān)聯(lián)頁面等信息。可指定設(shè)備ID或完整的UUID、Major、Minor查詢，也可批量拉取設(shè)備信息列表。
        /// </summary>
        /// <param name="accessToken">調(diào)用接口憑證</param>
        /// <param name="device_identifiers">設(shè)備列表信息</param>
        /// <returns></returns>
        ShakeDeviceSearchList SearchDevice(string accessToken, List<ShakeDeviceIdentifier> device_identifiers);

        /// <summary>
        /// 查詢設(shè)備列表.
        /// 接口說明 查詢已有的設(shè)備ID、UUID、Major、Minor、激活狀態(tài)、備注信息、關(guān)聯(lián)門店、關(guān)聯(lián)頁面等信息?？芍付ㄔO(shè)備ID或完整的UUID、Major、Minor查詢，也可批量拉取設(shè)備信息列表。
        /// </summary>
        /// <param name="accessToken">調(diào)用接口憑證</param>
        /// <param name="data">分頁查詢條件。apply_id為批次ID，如果指定則以批次進行查詢，否則以指定范圍查詢。</param>
        /// <returns></returns>
        ShakeDeviceSearchList SearchDevice(string accessToken, ShakeDeviceSearchPaging data);

        #endregion

        /// <summary>
        /// 申請設(shè)備ID。
        /// 接口說明 申請配置設(shè)備所需的UUID、Major、Minor。
        /// 若激活率小于50%，不能新增設(shè)備。單次新增設(shè)備超過500個，需走人工審核流程。審核通過后，可用返回的批次ID用“查詢設(shè)備列表”接口拉取本次申請的設(shè)備ID。
        /// </summary>
        /// <param name="accessToken">調(diào)用接口憑證</param>
        /// <param name="applyInfo">設(shè)備申請信息</param>
        public ShakeDeviceApplyJson ApplyDevice(string accessToken, 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;
            }
            return data;
        }

        #region 頁面管理

        /// <summary>
        /// 新增頁面。
        /// 新增搖一搖出來的頁面信息，包括在搖一搖頁面出現(xiàn)的主標題、副標題、圖片和點擊進去的超鏈接。
        /// 其中，圖片必須為用素材管理接口上傳至微信側(cè)服務(wù)器后返回的鏈接。
        /// </summary>
        /// <param name="accessToken">調(diào)用接口憑證</param>
        /// <param name="info">新增頁面POST數(shù)據(jù)對象</param>
        /// <returns></returns>
        ShakePageResult AddPage(string accessToken, ShakePageJson info);

        /// <summary>
        /// 編輯頁面信息。
        /// 編輯搖一搖出來的頁面信息，包括在搖一搖頁面出現(xiàn)的主標題、副標題、圖片和點擊進去的超鏈接。
        /// </summary>
        /// <param name="accessToken">調(diào)用接口憑證</param>
        /// <param name="info">編輯頁面POST數(shù)據(jù)對象</param>
        /// <returns></returns>
        ShakePageResult UpdatePage(string accessToken, ShakePageJson info);
                        
        /// <summary>
        /// 查詢頁面列表。
        /// 查詢已有的頁面，包括在搖一搖頁面出現(xiàn)的主標題、副標題、圖片和點擊進去的超鏈接。
        /// 提供詢方式:指定頁面ID查詢。
        /// </summary>
        /// <param name="accessToken">調(diào)用接口憑證</param>
        /// <param name="begin">頁面列表的起始索引值</param>
        /// <param name="count">待查詢的頁面?zhèn)€數(shù)</param>
        /// <returns></returns>
        ShakePageSearchJson SearchPage(string accessToken, int begin, int count);

        
        /// <summary>
        ///  查詢頁面列表。
        /// 查詢已有的頁面，包括在搖一搖頁面出現(xiàn)的主標題、副標題、圖片和點擊進去的超鏈接。
        /// 提供詢方式:批量拉取頁面列表
        /// </summary>
        /// <param name="accessToken">調(diào)用接口憑證</param>
        /// <param name="page_ids">指定頁面的id列表</param>
        /// <returns></returns>
        ShakePageSearchJson SearchPage(string accessToken, List<int> page_ids);

        /// <summary>
        /// 查詢頁面列表。
        /// 查詢已有的頁面，包括在搖一搖頁面出現(xiàn)的主標題、副標題、圖片和點擊進去的超鏈接。
        /// 提供兩種查詢方式，可指定頁面ID查詢，也可批量拉取頁面列表。
        /// </summary>
        /// <param name="accessToken">調(diào)用接口憑證</param>
        /// <param name="info"></param>
        /// <returns></returns>
        ShakePageSearchJson SearchPage(string accessToken, ShakePageSearchPaging info);

        /// <summary>
        /// 刪除頁面。
        /// 刪除已有的頁面，包括在搖一搖頁面出現(xiàn)的主標題、副標題、圖片和點擊進去的超鏈接。
        /// 只有頁面與設(shè)備沒有關(guān)聯(lián)關(guān)系時，才可被刪除。 
        /// </summary>
        /// <param name="accessToken">調(diào)用接口憑證</param>
        /// <param name="page_ids">指定頁面的id列表</param>
        /// <returns></returns>
        CommonResult DeletePage(string accessToken, List<int> page_ids);

        #endregion 頁面管理

       /// <summary>
        /// 搖一搖設(shè)備的申請、修改、綁定處理操作測試
        /// </summary>
        private void btnDevice_Click(object sender, 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 = new ShakeDeviceIdentifier(device.device_id, device.uuid, device.major, device.minor);
                            CommonResult comResult = api.UpdateDevice(this.token, info, comment);
                            MessageUtil.ShowTips(comResult.Success ? "操作成功" : "修改設(shè)備失敗:" + comResult.ErrorMessage);

                            comResult = api.BindDevice(this.token, info, poi_id);
                            MessageUtil.ShowTips(comResult.Success ? "操作成功" : "修改設(shè)備失敗:" + comResult.ErrorMessage);
                        }
                    }
                }
            }
            catch(Exception ex)
            {
                Console.WriteLine(ex);
            }

        }

        /// <summary>
        /// 增加搖一搖素材、增加頁面、修改頁面、刪除頁面的操作示例代碼
        /// </summary>
        private void btnPage_Click(object sender, EventArgs e)
        {
            string file = FileDialogHelper.OpenImage(false);
            if(string.IsNullOrEmpty(file))
            {
                return;
            }

            ShakeMaterialJson mediaJson = api.AddMaterail(this.token, file);
            if (mediaJson != null)
            {
                ShakePageJson json = new ShakePageJson()
                {
                    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);
                    }
                }
            }
        }