JD_PDD.SDK.CSharpe

京东和拼多多用c#干净的实现开放api，使用netstandard2.0。

解决json对应class的复杂嵌套关系。尽量让代码足够清晰。

---

Feature

无需关心jd或者pdd的调用规则，只需关心 业务 请求响应参数 。

针对需要补充的系统参数，在继承BaseRequest之后，会有未实现的异常。

生成注释完善的请求响应实体，统一使用方法名的规范命名规则

/// <summary>
/// 商品类目查询--请求参数
/// 根据商品的父类目id查询子类目id信息，通常用获取各级类目对应关系，以便将推广商品归类。业务参数parentId、grade都输入0可查询所有一级类目ID，之后再用其作为parentId查询其子类目。
/// jd.union.open.category.goods.get
/// </summary>
public partial class JdUnionOpenCategoryGoodsGetRequest : BaseRequest
{
    /// <summary>
    /// 描述：父类目id(一级父类目为0)
    /// 必填：true
    /// 例如：1342
    /// </summary>
    public int? ParentId { get; set; }
    .
    .
    .
}


/// <summary>
/// 商品类目查询--响应参数
/// 根据商品的父类目id查询子类目id信息，通常用获取各级类目对应关系，以便将推广商品归类。业务参数parentId、grade都输入0可查询所有一级类目ID，之后再用其作为parentId查询其子类目。
/// jd.union.open.category.goods.get
/// </summary>
public partial class JdUnionOpenCategoryGoodsGetResponse
{
    /// <summary>
    /// 描述：类目Id
    /// 必填：true
    /// 例如：1350
    /// </summary>
    public int? Id { get; set; }
    .
    .
    .
}

较为完善的单元测试（部分接口需要权限申请，或者一些特殊情况的，添加不满足生产的断言）

支持默认和可传入的appkey等主要参数

public JdUnionOpenCategoryGoodsGetRequest() { }
public JdUnionOpenCategoryGoodsGetRequest(string appKey, string appSecret, string accessToken = null) : base(appKey, appSecret, accessToken) { }

一句话调用

await new JdUnionOpenCategoryGoodsGetRequest(...).InvokeAsync();

使用接口生成工具

• 进入src/Tool目录，运行dotnet run
• 选择jd或者pdd

正确的使用姿势

目前不提供dll直接调用，希望的使用方法是copy基类代码到自己的项目，针对需要使用的接口使用Tool去生成请求响应实体。就这样~

缺点

• 采用代码生成无法识别接口的相同部分，也就意味这生成的代码几乎无代码复用。会产生一定程度的重复代码。
• 会产生贼长的命名。

public class JdUnionOpenOrderQueryResponse
{
    public JdUnionOpenOrderQuery_SkuInfo SkuInfo { get; set; }
}

public class JdUnionOpenOrderQuery_SkuInfo
{
    ...
}

---

更新日志

2019年6月28日 加入 pdd 多多客接口
            |
            .
            |
            v
2019年6月25日 优化嵌套类的结构，加入config
            |
            .
            |
            v
2019年6月24日 Jd 17个接口通过单元测试
            |
            .
            |
            v
2019年6月21日 优化调用代码，添加单元测试
            |
            .
            |
            v
2019年6月18日 jd全部api接入，支持一键更新全部jd接口
            |
            .
            |
            v
2019年6月17日 增加jd demo
            |
            .
            |
            v
2019年6月13日 初始化项目