9、ABPZero系列教程之拼多多卖家工具 拼团提醒类库封装

时间:2021-11-28 04:37:00

  本篇开始正式做功能,我在开发拼团提醒之前,拼多多并没有放出拼团人数不足就提醒卖家的功能。

有这个想法主要来源于朋友的抱怨,我想这应该是大部分卖家的心声吧。

经过分析,拿到了几个api,不要问我api怎么拿到的,这不是本系列的内容。

接口1:http://apiv4.yangkeduo.com/mall/{0}/info?pdduid=0(传入店铺编号,可以获取店铺资料)

接口2:http://apiv4.yangkeduo.com/v2/mall/{0}/goods?page=1&size=500&sort_type=PRIORITY&pdduid=0(传入店铺编号,可以拿到店铺商品资料,拼多多限制最多获取500个商品)

接口3:http://apiv2.yangkeduo.com/v2/goods/{0}/local_group(传入商品id,可以获取拼团信息)

有了这几个api,拼团提醒功能就不在话下,接下来讲解实现过程。

 

 建立新项目

 在解决方案下建立PddTool项目,目的是把拼多多相关业务逻辑以专门的一个类库来实现。

9、ABPZero系列教程之拼多多卖家工具 拼团提醒类库封装

 

在解决方案右键选择“管理解决方案的 NuGet程序包”,搜索安装如下NuGet包,注意版本号。

 

9、ABPZero系列教程之拼多多卖家工具 拼团提醒类库封装

 

创建目录,先创建好几个目录,如下图所示:

9、ABPZero系列教程之拼多多卖家工具 拼团提醒类库封装

 

在Response目录下新建MallEntity类,代码如下:

public class MallEntity
{
/// <summary>
///
/// </summary>
public int mall_id { get; set; }
/// <summary>
/// 木子缘
/// </summary>
public string mall_name { get; set; }
/// <summary>
///
/// </summary>
public string logo { get; set; }
/// <summary>
///
/// </summary>
public int goods_num { get; set; }
/// <summary>
/// 小店主要经营时尚潮流女装,品质女装,质量有保障!
/// </summary>
public string mall_desc { get; set; }
/// <summary>
///
/// </summary>
public string company_phone { get; set; }
/// <summary>
///
/// </summary>
public string offline_note { get; set; }
/// <summary>
///
/// </summary>
public int chat_enable { get; set; }
/// <summary>
/// 广东广州天河区沙太路牛利岗大街6巷28号
/// </summary>
public string refund_address { get; set; }
/// <summary>
///
/// </summary>
public int score_avg { get; set; }
/// <summary>
///
/// </summary>
public int staple_id { get; set; }
/// <summary>
///
/// </summary>
public int mall_sales { get; set; }
/// <summary>
///
/// </summary>
public int region_emergent { get; set; }
/// <summary>
///
/// </summary>
public int is_open { get; set; }
/// <summary>
///
/// </summary>
public int status { get; set; }
/// <summary>
///
/// </summary>
public int wms_id { get; set; }
/// <summary>
/// 店铺优惠券,不需要
/// </summary>
//public List<string> mall_coupons { get; set; }
/// <summary>
///
/// </summary>
public int server_time { get; set; }
}

 

 

这是请求api之后,根据返回json数据所生成的类,

http://www.bejson.com/convert/json2csharp/(通过这个工具,可以把json转C#实体类)

再同目录下新建ProductEntity类,代码如下:

/// <summary>
/// 拼团
/// </summary>
public class Group
{
/// <summary>
/// 拼团人数
/// </summary>
public int customer_num { get; set; }
/// <summary>
/// 拼团价格÷100
/// </summary>
public int price { get; set; }
}

public class Goods_listItem
{
/// <summary>
/// 单买价÷100
/// </summary>
public int normal_price { get; set; }
/// <summary>
/// 已拼数量
/// </summary>
public int cnt { get; set; }
/// <summary>
/// 小图连接
/// </summary>
public string thumb_url { get; set; }
/// <summary>
///
/// </summary>
public int event_type { get; set; }
/// <summary>
/// 市场价÷100
/// </summary>
public int market_price { get; set; }
/// <summary>
/// 【木子缘】毛呢外套女中长款韩版2017新款宽松显廋修身学生百搭大码加厚外套bf过膝气质呢子大衣
/// </summary>
public string goods_name { get; set; }
/// <summary>
/// 商品id
/// </summary>
public int goods_id { get; set; }
/// <summary>
/// 【木子缘】毛呢外套女中长款韩版2017新款宽松显廋修身学生百搭大码加厚外套bf过膝气质呢子大衣
/// </summary>
public string short_name { get; set; }
/// <summary>
///
/// </summary>
public Group group { get; set; }
/// <summary>
///
/// </summary>
public string country { get; set; }
/// <summary>
/// 商品主图
/// </summary>
public string image_url { get; set; }
/// <summary>
/// 高清图
/// </summary>
public string hd_thumb_url { get; set; }
/// <summary>
///
/// </summary>
public int is_app { get; set; }
}

public class ProductEntity
{
/// <summary>
///
/// </summary>
public List<string> recommend_subject { get; set; }
/// <summary>
///
/// </summary>
public int server_time { get; set; }
/// <summary>
///
/// </summary>
public List<Goods_listItem> goods_list { get; set; }
/// <summary>
///
/// </summary>
public List<string> subject_list { get; set; }
}

 

 

同目录下再创建KaiTuanEntity类,代码如下:

public class Local_groupItem
{
/// <summary>
/// 拼团订单id
/// </summary>
public string group_order_id { get; set; }
/// <summary>
/// 商品id
/// </summary>
public string goods_id { get; set; }
/// <summary>
/// 城市名称
/// </summary>
public string city_name { get; set; }
/// <summary>
/// 昵称
/// </summary>
public string nickname { get; set; }
/// <summary>
/// 头像
/// </summary>
public string avatar { get; set; }
/// <summary>
///
/// </summary>
public string expire_time { get; set; }
/// <summary>
/// 用户id
/// </summary>
public string uid { get; set; }
}

public class KaiTuanEntity
{
/// <summary>
/// 正在拼团列表
/// </summary>
public List<Local_groupItem> local_group { get; set; }
/// <summary>
///
/// </summary>
public int server_time { get; set; }
/// <summary>
/// 正在拼团人数
/// </summary>
public int total { get; set; }
}

 

 

然后在Entities目录下,创建KaiTuan类,代码如下:

public class KaiTuan
{
/// <summary>
/// 商品id
/// </summary>
public int Id { get; set; }

/// <summary>
/// 昵称
/// </summary>
public string NickName { get; set; }

/// <summary>
///
/// </summary>
public string SKU { get; set; }

/// <summary>
/// 订单号
/// </summary>
public string OrderNum { get; set; }

/// <summary>
/// 剩余时间
/// </summary>
public double TimeLeft { get; set; }

/// <summary>
/// 开团单号
/// </summary>
public string KaiTuanOrderNum { get; set; }
}

 

 

继续在Entities目录下创建KaiTuanProduct类,代码如下:

/// <summary>
/// 开团商品
/// </summary>
public class KaiTuanProduct
{
/// <summary>
/// 商品id
/// </summary>
public int GoodId { get; set; }
/// <summary>
/// 商品名称
/// </summary>
public string Name { get; set; }

/// <summary>
/// 商品图片
/// </summary>
public string Img { get; set; }
/// <summary>
/// 开团人数
/// </summary>
public int KaiTuanCount { get; set; }
}

 

 

再类库下创建DateTimeHelper类,代码如下:

public class DateTimeHelper
{
/// <summary>
/// 传入unix时间戳,计算与当前时间之间的小时数
/// </summary>
/// <param name="unixTimeStamp"></param>
/// <returns></returns>
public static double GetHours(long unixTimeStamp)
{
System.DateTime startTime
= TimeZone.CurrentTimeZone.ToLocalTime(new System.DateTime(1970, 1, 1)); // 当地时区
DateTime dt = startTime.AddSeconds(unixTimeStamp);
var a = dt - DateTime.Now;

return Math.Round(a.TotalHours, 1);
}
}

 

 

再类库下创建MallTool类,实现几个方法,代码如下:

public class MallTool
{
/// <summary>
/// 按店铺id获取店铺资料
/// </summary>
/// <param name="mallId"></param>
public static MallEntity GetInfo(string mallId)
{
string url = string.Format("http://apiv4.yangkeduo.com/mall/{0}/info?pdduid=0", mallId);
var client = new RestClient(url);
var request = new RestRequest(Method.GET);
request.AddHeader(
"cache-control", "no-cache");
request.AddHeader(
"referer", url);
IRestResponse response
= client.Execute(request);
if (string.IsNullOrWhiteSpace(response.Content) || response.Content.Contains("mall not exists"))
{
throw new Exception("店铺编号错误!");
}
var mall = JsonConvert.DeserializeObject<MallEntity>(response.Content);
return mall;
}

/// <summary>
/// 最多拿到500个商品
/// </summary>
/// <param name="mallId"></param>
/// <returns></returns>
public static ProductEntity GetGoods(string mallId)
{
string url =
string.Format(
"http://apiv4.yangkeduo.com/v2/mall/{0}/goods?page=1&size=500&sort_type=PRIORITY&pdduid=0", mallId);
var client = new RestClient(url);
var request = new RestRequest(Method.GET);
request.AddHeader(
"cache-control", "no-cache");
request.AddHeader(
"referer", url);
IRestResponse response
= client.Execute(request);
var product = JsonConvert.DeserializeObject<ProductEntity>(response.Content);
return product;
}

/// <summary>
/// 根据商品id ,获取开团信息
/// </summary>
/// <param name="goodId"></param>
/// <returns></returns>
public static KaiTuanEntity GetKaiTuanInfo(int goodId)
{
string url = string.Format("http://apiv2.yangkeduo.com/v2/goods/{0}/local_group", goodId);
var client = new RestClient(url);
var request = new RestRequest(Method.GET);
request.AddHeader(
"cache-control", "no-cache");
request.AddHeader(
"referer", url);
IRestResponse response
= client.Execute(request);
var content = response.Content.Replace("\\\"", "\"");
content
= content.Replace("\\\\", "\\").Replace("\"{", "{").Replace("}\"", "}");
var kaiTuan = JsonConvert.DeserializeObject<KaiTuanEntity>(content);
return kaiTuan;
}

/// <summary>
/// 根据商品id,获取此商品所有开团信息
/// </summary>
/// <param name="goodId"></param>
/// <returns></returns>
public static List<KaiTuan> GetAllKaiTuanByGoodId(int mallId, int goodId)
{
int total = 0;// 总开团数量
var kaituan = GetKaiTuanInfo(goodId);
total
= kaituan.total;
List
<KaiTuan> groups = new List<KaiTuan>();
int maxNoKaituan = 20;//获取拼团
int noKaituan = 0;//获取拼团,返回的数据中没有新的拼团则+1
//获取开团信息存放集合里面
AddRange(groups, kaituan, mallId, goodId, ref noKaituan);

//开团数量大于5就分页循环
if (kaituan.total > 5)
{
while (true)
{
//重试了maxNoKaituan次,还是没有新数据就退出
if (noKaituan >= maxNoKaituan)
{
break;
}
kaituan
= GetKaiTuanInfo(goodId);
//已获取到的开团数>=获取回来的开团数 就退出
if (groups.Count >= kaituan.total)
{
break;
}
AddRange(groups, kaituan, mallId, goodId,
ref noKaituan);
}
}
return groups;
}

/// <summary>
/// 根据店铺id,获取所有商品的开团人数
/// </summary>
/// <param name="mallId"></param>
/// <returns></returns>
public static List<KaiTuanProduct> GetKaiTuanList(string mallId)
{
var goods = GetGoods(mallId);
if (goods.goods_list.Count == 0)
{
throw new UserFriendlyException("此店铺商品为 0");
}
List
<KaiTuanProduct> kaiTuanProducts = new List<KaiTuanProduct>();
foreach (var goodsListItem in goods.goods_list)
{
var kaituanProduct = GetKaiTuanCountByGoodId(goodsListItem.goods_id);
if (kaituanProduct == null)
{
continue;
}
kaituanProduct.Name
= goodsListItem.goods_name;
kaituanProduct.GoodId
= goodsListItem.goods_id;
kaituanProduct.Img
= goodsListItem.thumb_url;
kaiTuanProducts.Add(kaituanProduct);
}
return kaiTuanProducts;
}

/// <summary>
///根据商品id, 获取开团人数
/// </summary>
/// <param name="goodId"></param>
public static KaiTuanProduct GetKaiTuanCountByGoodId(int goodId)
{
var kaituanInfo = GetKaiTuanInfo(goodId);
if (kaituanInfo.total == 0)
{
return null;
}
return new KaiTuanProduct()
{
KaiTuanCount
= kaituanInfo.total
};
}

public static void AddRange(List<KaiTuan> groups, KaiTuanEntity kaiTuan, int mallId, int goodId, ref int noKaituan)
{
bool isExist = true;
int count = 0;
foreach (var localGroupItem in kaiTuan.local_group)
{
//过滤已经存在的拼团
if (groups.Any(a => a.KaiTuanOrderNum == localGroupItem.group_order_id))
{
count
++;
isExist
= false;
continue;
}
//过滤时间小于0的拼团
var t = DateTimeHelper.GetHours(Convert.ToInt64(localGroupItem.expire_time));
if (t <= 0)
{
count
++;
isExist
= false;
continue;
}

var item = new KaiTuan()
{
Id
= Convert.ToInt32(localGroupItem.goods_id),
KaiTuanOrderNum
= localGroupItem.group_order_id,
NickName
= localGroupItem.nickname,
TimeLeft
= DateTimeHelper.GetHours(Convert.ToInt64(localGroupItem.expire_time)),
};
groups.Add(item);
isExist
= true;
}
if (isExist == false && count == kaiTuan.local_group.Count)
{
noKaituan
++;
}
}
}

 

 

可以看到UserFriendlyException报异常,这是abp的异常类,接着解决方案再打开”管理解决方案的 NuGet程序包”,搜索:“abp”安装。

最后项目结构如下,拼团提醒功能就封装好了。

 

9、ABPZero系列教程之拼多多卖家工具 拼团提醒类库封装

 

 创建单元测试

 在解决方案Tests目录下新建单元测试项目,如下图所示:

9、ABPZero系列教程之拼多多卖家工具 拼团提醒类库封装

 

新建MallTool_Test类,用来测试刚刚封装的几个方法,代码如下:

[TestClass]
public class MallTool_Test
{
public string mallId { get; set; } = "1277675";
[TestMethod]
public void TestGetInfo()
{
MallEntity result
=MallTool.GetInfo(mallId);
Console.WriteLine(result.mall_name);
}
}

 

 

下图为调试输出结果:

9、ABPZero系列教程之拼多多卖家工具 拼团提醒类库封装

 

以上代码传入店铺编号,获取店铺资料,

店铺编号哪里来?

http://mobile.yangkeduo.com/search_result.html?search_key=%E6%89%93%E5%BA%95%E8%A1%AB%E5%A5%B3&search_src=history&search_met=history_sort&search_met_track=history&refer_page_name=search&refer_page_id=&page_id=&sp=0&item_index=1&is_back=1

通过以上连接可以查询拼多多商品信息,接着随便点入一个商品,点击“进店逛逛”,如下图所示:

9、ABPZero系列教程之拼多多卖家工具 拼团提醒类库封装

 

进来之后就可以看到地址栏就有店铺编号,如下图所示:

9、ABPZero系列教程之拼多多卖家工具 拼团提醒类库封装

 

 其它几个方法测试类似,就不一一说明。

 

 返回总目录