EasySeries.Post 3.0.2

EasySeries.Post

Easy邮寄，Easy系列的第二个应用，现支持快递100,京东物流。

使用说明:

预先配置模式

//appsettings.json
  "JDLSecurityOptions": {
    "Appkey":"xxx",
    "AppSecret":"xxx",
    "Token":"xxx",
    "CustomerCode":"xxx"
  },
  "KuaiDi100SecurityOptions": {
    "Customer":"xxx",
    "Key":"xxx",
    "Secret":"xxx"
  }

//注册
builder.Services.AddEasyPostService();

//使用
public YourController(IEasyPostJDL easyPostJDL)
{
  _easyPostJDL = easyPostJDL;
}

即时配置模式

//注册
builder.Services.AddEasyPostService();

//使用
public YourController(IEasyPostJDL easyPostJDL)
{
  _easyPostJDL = easyPostJDL;
}}
    
[HttpGet("JDL")]
public async Task<dynamic> QueryAsync(string outTradeNo)
{
    var options = new JDLSecurityOptions
    {
        Appkey="xxx",
        AppSecret="xxx",
        Token="xxx",
        CustomerCode="xxx"
    };

    return await _easyPostJDL.JDLCheckPreOrderAsync(senderAddress,receiverAddress, options);
}

API列表

/// <summary>
/// 京东物流interface.
/// </summary>
public interface IEasyPostJDL
{
    /// <summary>
    /// JDL-取消寄件.
    /// </summary>
    /// <param name="jdlSecurityOptions">京东物流安全信息.</param>
    /// <param name="cancelRequest">取消寄件信息.</param>
    /// <returns>请求结果.</returns>
    Task<JDLCancelOrderResponse> JDLCancelOrderAsync(JDLCancelOrderRequest cancelRequest, JDLSecurityOptions? jdlSecurityOptions = null);

    /// <summary>
    /// JDL-预检订单.
    /// </summary>
    /// <param name="senderAddress">发件地址.</param>
    /// <param name="receiverAddress">收件地址.</param>
    /// <param name="jdlSecurityOptions">京东物流安全信息.</param>
    /// <returns>预检结果.</returns>
    Task<JDLCheckPreOrderResponse> JDLCheckPreOrderAsync(string senderAddress, string receiverAddress, JDLSecurityOptions? jdlSecurityOptions = null);

    /// <summary>
    /// JDL-下单寄件.
    /// </summary>
    /// <param name="jdlSecurityOptions">京东物流安全信息.</param>
    /// <param name="createRequest">寄件信息.</param>
    /// <returns>请求结果.</returns>
    Task<JDLCreateOrderResponse> JDLCreatOrderAsync(JDLCreateOrderRequest createRequest, JDLSecurityOptions? jdlSecurityOptions = null);

    /// <summary>
    /// JDL-获取云打印数据.
    /// </summary>
    /// <param name="jdlSecurityOptions">京东物流安全信息.</param>
    /// <param name="jdlOrders">订单号数组.</param>
    /// <returns>云打印数据.</returns>
    Task<JDLPullDataResponse> JDLGetPrintDataAsync(string[] jdlOrders, JDLSecurityOptions? jdlSecurityOptions = null);

    /// <summary>
    /// JDL-获取运单模板.
    /// </summary>
    /// <param name="jdlSecurityOptions">京东物流安全信息.</param>
    /// <returns>运单模板.</returns>
    Task<JDLTemplateListResponse> JDLGetTemplateListAsync(JDLSecurityOptions? jdlSecurityOptions = null);

    /// <summary>
    /// JDL-查询.
    /// </summary>
    /// <param name="postNo">京东快递号.</param>
    /// <param name="jdlSecurityOptions">京东物流安全信息</param>
    /// <returns>查询结果.</returns>
    Task<JDLQueryOrderResult> JDLQueryOrderAsyncc(string postNo, JDLSecurityOptions? jdlSecurityOptions = null);
}

/// <summary>
/// 快递100interface.
/// </summary>
public interface IEasyPostKuaiDi100
{
    /// <summary>
    /// 快递100-取消寄件(电子面单).
    /// </summary>
    /// <param name="orderCancel"></param>
    /// <param name="kd100SecurityOptions"></param>
    /// <returns>取消寄件结果.</returns>
    Task<KuaidiCancelResponse> Kd100CancelOrderAsync(Kd100OrderCancel orderCancel, KuaiDi100SecurityOptions? kd100SecurityOptions = null);

    /// <summary>
    /// 快递100-寄件(电子面单).
    /// </summary>
    /// <param name="dianziParam"></param>
    /// <param name="kd100SecurityOptions">快递100安全信息.</param>
    /// <returns>请求结果.</returns>
    Task<DianzimiandanResponse> Kd100CreateOrderAsync(DianziParam dianziParam, KuaiDi100SecurityOptions? kd100SecurityOptions = null);

    /// <summary>
    /// 快递100-查询.
    /// </summary>
    /// <param name="query">查询信息.</param>
    /// <param name="kd100SecurityOptions">快递100安全信息.</param>
    /// <returns>查询结果.</returns>
    Task<KuaidiQueryResponse> Kd100QueryOrderAsync(Kd100OrderQuery query, KuaiDi100SecurityOptions? kd100SecurityOptions = null);
}