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

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

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

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

        #endregion

        /// <summary>
        /// 申請(qǐng)?jiān)O(shè)備ID。
        /// 接口說(shuō)明 申請(qǐng)配置設(shè)備所需的UUID、Major、Minor。
        /// 若激活率小于50%，不能新增設(shè)備。單次新增設(shè)備超過500個(gè)，需走人工審核流程。審核通過后，可用返回的批次ID用“查詢?cè)O(shè)備列表”接口拉取本次申請(qǐng)的設(shè)備ID。
        /// </summary>
        /// <param name="accessToken">調(diào)用接口憑證</param>
        /// <param name="applyInfo">設(shè)備申請(qǐng)信息</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 頁(yè)面管理

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

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

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

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

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

        #endregion 頁(yè)面管理

       /// <summary>
        /// 搖一搖設(shè)備的申請(qǐng)、修改、綁定處理操作測(cè)試
        /// </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 = "測(cè)試", comment = "測(cè)試備注", 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>
        /// 增加搖一搖素材、增加頁(yè)面、修改頁(yè)面、刪除頁(yè)面的操作示例代碼
        /// </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 = "主標(biāo)題",
                    description = "副標(biāo)題",
                    comment = "備注說(shuō)明",
                    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("修改頁(yè)面");
                            Console.WriteLine(result.ToJson());
                        }

                        CommonResult comResult = api.DeletePage(this.token, new List<int>() { json.page_id.Value });
                        MessageUtil.ShowTips(comResult.Success ? "刪除頁(yè)面操作成功" : "刪除頁(yè)面失敗:" + comResult.ErrorMessage);
                    }
                }
            }
        }