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

/// <summary>
/// 摇一摇周边的接口定义
/// </summary>
public interface IShakeAround
{
	#region 设备管理
	/// <summary>
	/// 申请设备ID。
	/// 接口说明 申请配置设备所需的UUID、Major、Minor。
	/// 若激活率小于50%，不能新增设备。单次新增设备超过500个，需走人工审核流程。审核通过后，可用返回的批次ID用“查询设备列表”接口拉取本次申请的设备ID。
	/// </summary>
	/// <param name="accessToken">调用接口凭证</param>
	/// <param name="applyInfo">设备申请信息</param>
	ShakeDeviceApplyJson ApplyDevice(string accessToken, 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, string comment);
	/// <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, int poi_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(string accessToken, ShakeDeviceSearchPaging data);
	#endregion
}

	/// <summary>
	/// 申请设备ID。
	/// 接口说明 申请配置设备所需的UUID、Major、Minor。
	/// 若激活率小于50%，不能新增设备。单次新增设备超过500个，需走人工审核流程。审核通过后，可用返回的批次ID用“查询设备列表”接口拉取本次申请的设备ID。
	/// </summary>
	/// <param name="accessToken">调用接口凭证</param>
	/// <param name="applyInfo">设备申请信息</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>
/// 新增页面。
/// 新增摇一摇出来的页面信息，包括在摇一摇页面出现的主标题、副标题、图片和点击进去的超链接。
/// 其中，图片必须为用素材管理接口上传至微信侧服务器后返回的链接。
/// </summary>
/// <param name="accessToken">调用接口凭证</param>
/// <param name="info">新增页面POST数据对象</param>
/// <returns></returns>
ShakePageResult AddPage(string accessToken, ShakePageJson info);

/// <summary>
/// 编辑页面信息。
/// 编辑摇一摇出来的页面信息，包括在摇一摇页面出现的主标题、副标题、图片和点击进去的超链接。
/// </summary>
/// <param name="accessToken">调用接口凭证</param>
/// <param name="info">编辑页面POST数据对象</param>
/// <returns></returns>
ShakePageResult UpdatePage(string accessToken, 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, int count);

/// <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(string accessToken, 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(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 ? "操作成功" : "修改设备失败:" + 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(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);
			}
		}
	}
}