1. 위챗 매장 진열대 소개
위챗 공식 계정 백그라운드에서 진열대 정보를 유지할 수 있으며, 인터페이스는 다음과 같습니다. 선반의 개념은 고객에게 카테고리별로 제품을 표시하는 것입니다. 선반은 잘 배치된 진열장과 유사하며 다양한 선반을 정의한 다음 경험을 위해 다양한 URL을 게시할 수 있습니다.
또한, 우리는 일반적으로 선반 템플릿 라이브러리를 기반으로 선반을 생성합니다. 선반 템플릿을 사용하면 선반을 빠르게 구축할 수 있으며 선반 템플릿 인터페이스를 제공합니다. 아래에 나와 있습니다.
WeChat의 진열대 관리 운영 인터페이스인 API를 활용한 WeChat 매장 개발을 위해 저장소, 일반 모듈과 유사하며 다음과 같은 기능적 동작을 갖습니다.
이전 객체 모델과 유사해 보이지만 선반 정보가 매우 복잡하므로 Json 데이터를 기반으로 엔터티 객체로 복원해야 하는 경우에는 다음이 필요합니다. 반복하려면 신중하게 고려하십시오. 그렇지 않으면 오류를 모델링하기 쉽습니다.
WeChat 매장 관리 인터페이스의 선반 템플릿에 해당합니다. 선반의 개체 정보에는 5가지 제어 모델이 포함되어 있으며 그 중 일부를 조합하여 사용할 수 있습니다.
아래는 여러 선반의 모형 전시입니다.
위의 5가지 제어 모델을 통해 각각 다른 레이아웃 효과를 나타내며 선반에 조합하여 사용할 수 있습니다.
WeChat 스토어의 인터페이스 설명에 따르면 우리가 최종 정의한 선반 엔터티 객체 정보는 내용이 매우 풍부하고 유연합니다.
WeChat 스토어의 API 설명을 참고하면 선반 정보 JSON 데이터가 매우 복잡하다는 것을 알 수 있으며, 구체적인 정의는 다음과 같습니다.
{ "shelf_data": { "module_infos": [ { "group_info": { "filter": { "count": 2 }, "group_id": 50 }, "eid": 1 }, { "group_infos": { "groups": [ { "group_id": 49 }, { "group_id": 50 }, { "group_id": 51 } ] }, "eid": 2 }, { "group_info": { "group_id": 52, "img": "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl29nqqObBwFwnIX3licVPnFV5Jm64z4I0TTicv0TjN7Vl9bykUUibYKIOjicAwIt6Oy0Y6a1Rjp5Tos8tg/0" }, "eid": 3 }, { "group_infos": { "groups": [ { "group_id": 49, "img": "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl29nqqObBwFwnIX3licVPnFV5uUQx7TLx4tB9qZfbe3JmqR4NkkEmpb5LUWoXF1ek9nga0IkeSSFZ8g/0" }, { "group_id": 50, "img": "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl29nqqObBwFwnIX3licVPnFV5G1kdy3ViblHrR54gbCmbiaMnl5HpLGm5JFeENyO9FEZAy6mPypEpLibLA/0" }, { "group_id": 52, "img": "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl29nqqObBwFwnIX3licVPnFV5uUQx7TLx4tB9qZfbe3JmqR4NkkEmpb5LUWoXF1ek9nga0IkeSSFZ8g/0" } ] }, "eid": 4 }, { "group_infos": { "groups": [ { "group_id": 43 }, { "group_id": 44 }, { "group_id": 45 }, { "group_id": 46 } ], "img_background": "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl29nqqObBwFwnIX3licVPnFV5uUQx7TLx4tB9qZfbe3JmqR4NkkEmpb5LUWoXF1ek9nga0IkeSSFZ8g/0" }, "eid": 5 } ] }, "shelf_banner": "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2ibrWQn8zWFUh1YznsMV0XEiavFfLzDWYyvQOBBszXlMaiabGWzz5B2KhNn2IDemHa3iarmCyribYlZYyw/0", "shelf_name": "测试货架" }
JSON 데이터 정의를 기반으로 여러 선반 제어 개체를 정의했습니다.
JSON 데이터를 기반으로 엔터티 객체를 모델링할 수 있으며, 이러한 객체를 사용하여 선반의 관련 작업 인터페이스를 추가로 정의할 수 있습니다. 인터페이스 정의는 다음과 같습니다.
아아앙有了这些接口的定义,我们就需要实现对应的接口,从而实现我们向微信API的封装处理了。
微信小店的货架管理实现内容如下所示(部分内容,增删改)。
/// <summary> /// 增加货架 /// </summary> /// <param>调用接口凭证 /// <param>货架招牌图片Url /// <param>货架名称 /// <param>货架控件1,2,3,4,5类型的集合 /// <returns></returns> public AddShelfResult AddShelf(string accessToken, string shelfBanner, string shelfName, List<shelfcontrolbase> controls) { var url = string.Format("https://api.weixin.qq.com/merchant/shelf/add?access_token={0}", accessToken); var data = new { shelf_data = new { module_infos = controls }, shelf_banner = shelfBanner, shelf_name = shelfName }; string postData = data.ToJson(); return JsonHelper<addshelfresult>.ConvertJson(url, postData); } /// <summary> /// 删除货架 /// </summary> /// <param>调用接口凭证 /// <param>货架Id /// <returns></returns> public CommonResult DeleteShelf(string accessToken, int shelfId) { var url = string.Format("https://api.weixin.qq.com/merchant/shelf/del?access_token={0}", accessToken); var data = new { shelf_id = shelfId }; string postData = data.ToJson(); return Helper.GetExecuteResult(url, postData); } /// <summary> /// 修改货架 /// </summary> /// <param>调用接口凭证 /// <param>货架Id /// <param>货架招牌图片Url /// <param>货架名称 /// <param>货架控件1,2,3,4,5类型的集合 /// <returns></returns> public CommonResult UpdateShelf(string accessToken, int shelfId, string shelfBanner, string shelfName, List<shelfcontrolbase> controls) { var url = string.Format("https://api.weixin.qq.com/merchant/shelf/mod?access_token={0}", accessToken); var data = new { shelf_id = shelfId, shelf_data = new { module_infos = controls }, shelf_banner = shelfBanner, shelf_name = shelfName }; string postData = data.ToJson(); return Helper.GetExecuteResult(url, postData); }</shelfcontrolbase></addshelfresult></shelfcontrolbase>
由于货架管理的对象和接口定义比较复杂一些,一定需要进行反复的测试才能正式使用,如果不注意有可能你定义的实体类,获取不到某个字段信息。
我为了方便,创建了一个Winform项目,分别对各个接口进行测试。
对于货架管理内容的接口测试,测试代码如下所示。
private void btnShelf_Click(object sender, EventArgs e) { IMerchantApi api = new MerchantApi(); List<shelfjson> list = api.GetAllShelf(token); Console.WriteLine(list.ToJson()); foreach(ShelfJson json in list) { Console.WriteLine("货架信息:"); ShelfJson getJson = api.GetShelfById(token, json.shelf_id.Value); Console.WriteLine(getJson.ToJson()); } string shelf_banner = "http://mmbiz.qpic.cn/mmbiz/mLqH9gr11Gyb2sgiaelcsxYtQENGePp0RgeNlAQicfZQokjbJMUq4h8MHtjpekJNEWKuMN3gdRz5RxfkYb7NlIrw/0"; string shelf_name = "测试货架"; ShelfControl1 c11 = new ShelfControl1(6, 202797386); ShelfControl1 c12 = new ShelfControl1(4, 202797397); List<shelfcontrolbase> controlList = new List<shelfcontrolbase>(){c11, c12}; AddShelfResult result = api.AddShelf(token, shelf_banner, shelf_name, controlList); if (result != null && result.shelf_id > 0) { Console.WriteLine("增加的货架信息:"); ShelfJson getJson = api.GetShelfById(token, result.shelf_id); Console.WriteLine(getJson.ToJson()); shelf_name = "测试货架-修改"; controlList = new List<shelfcontrolbase>(){c11}; CommonResult updateReuslt = api.UpdateShelf(token, result.shelf_id, shelf_banner, shelf_name, controlList); Console.WriteLine("修改货架操作:{0}", updateReuslt.Success ? "成功" : "失败"); CommonResult deleteResult = api.DeleteShelf(token, result.shelf_id); Console.WriteLine("删除货架操作:{0}", deleteResult.Success ? "成功" : "失败"); } }</shelfcontrolbase></shelfcontrolbase></shelfcontrolbase></shelfjson>
更多C# WeChat 포털 개발 및 WeChat 매장 진열대 정보 관리 적용相关文章请关注PHP中文网!