Asp.Net Core 调用第三方Open API查询物流数据的示例

更新时间：2021年03月05日 17:03:22 作者：Hello 寻梦者！

这篇文章主要介绍了Asp.Net Core 调用第三方Open API查询物流数据的示例，帮助大家更好的理解和学习使用Asp.Net Core，感兴趣的朋友可以了解下

　　在我们的业务中不可避免要与第三方的系统进行交互，调用他们提供的API来获取相应的数据，那么对于这样的情况该怎样进行处理呢？下面就结合自己对接跨越速运接口来获取一个发运单完整的物流信息为例来说明如何在Asp.Net Core中通过代码实现。当然在他们的官方网站上面会给出具体的API调用方式以及参数格式，作为调用方只需要根据相应规则来进行编码即可，下面以我们查询某一个具体的发运单的物流信息为例来进行说明。

　　下面以一个查询路由详细信息为例来进行说明。当前接口主要包括：1 概述。 2 系统参数。 3 业务参数。 4 业务参数。5 返回结果。6 响应数据格式。7 调用示例（Java语言）。这里主要是来说明如何使用C#语言来进行调用，其它语言的思路其实也是一样的。

　　一构造HttpClient对象

　　这里建议使用IHttpClientFactory这个接口来创建httpClient而不是直接new一个对象，至于具体原因网上有很多原因，具体理由也是IHttpClientFactory创建的HttpClient对象能够在使用完得到更好的释放资源的效果。在Asp.Net Core中直接在构造函数中注入IHttpClientFactory接口，然后采用CreateClient方法来创建对象。　　

 public LogisticsService(IHttpClientFactory httpClientFactory) {
   _httpClient = httpClientFactory.CreateClient(PartsConsts.DcsPartClientName);
  }

　　这个CreateClient方法中需要传一个标识你现在使用的HttpClient的名称。

　　二获取参数Token

　　按照他们的API规范中说的，在Headers中需要进行Token传递的，这个称之为请求票据，没有这个是无法进行验证的，首先我们需要定义一个用于请求Token的数据结构，同时还需要根据他们的规范来定义一个接收Token的数据结构。

　　A 请求Token的数据结构　　

public class LogisticsUser {
  public string appkey { get; set; }

  public string appsecret { get; set; }
 }

　　B 接收Token的数据结构

public class CodeMsg {
  public int Code { get; set; }
  public string Msg { get; set; }
  public bool Success { get; set; }
 }

public class TokenResult : CodeMsg {
  public TokenData Data { get; set; }
 }

 public class TokenData {
  public string Refresh_token { get; set; }

  public int Expire_time { get; set; }

  public string Token { get; set; }
 }

　　C 同步请求方法

/// <summary>
  /// 同步请求post（键值对形式）
  /// </summary>
  /// <param name="url"></param>
  /// <param name="postdate"></param>
  /// <param name="formData"></param>
  /// <param name="charset"></param>
  /// <param name="mediaType"></param>
  /// <returns></returns>
  public async Task<string> HttpPostAsync(string url, string postdate = null, List<KeyValuePair<string, string>> formData = null,
   string charset = "UTF-8", string mediaType = "application/json") {

   HttpContent content = new StringContent(postdate);
   content.Headers.ContentType = new MediaTypeHeaderValue(mediaType) {
    CharSet = charset
   };
   foreach (var data in formData) {
    content.Headers.Add(data.Key, data.Value);
   }
   var response = await _httpClient.PostAsync(url, content);

   var result = await response.Content.ReadAsStringAsync();

   return result;
  }

　　这个方法是一个常规的异步请求方法，这里使用HttpContent作为数据载体，将一些重要的系统参数添加到Headers里面，将业务参数传递到StringContent的构造函数中去，最后调用PostAsync异步方法发送Post请求，请求完了通过返回的Response来获取返回的数据，通过这种方式来获取完整的数据结构。这里特别需要注意如果第一次请求Token失败则可以再次请求重新刷新Token,最后将获取的Json类型Token反序列化为我们定义的TokenResult结构，这样我们就能够正常获取到Token数据了。

　　三获取发运单数据

　　我们之前所有的工作都是为了能够获取到最终的业务数据，那么这里我们也是一样，首先要定义请求和接收数据的数据结构，首先是请求的数据结构。

public class LogisticsInputModel {
  [JsonProperty("customerCode")]
  public string CustomerCode { get; set; }

  [JsonProperty("waybillNumbers")]
  public string[] WaybillNumbers { get; set; }
 }

　　这里面CustomerCode是我们用户编码，这个是唯一的，这是跨越速运官方给予的用户凭证，第二个WaybillNumbers 就是我们需要查询的发运单的集合，这里的接口支持一次性查询多个发运单数据，所以接口使用string[ ]数组类型。

　　下面来说一下根据官方定义来定义查询物流信息的接口定义。

/// <summary>
 /// 跨越速运查询物流信息接口
 /// </summary>
 public class LogisticInfoModel {
  public string Code { get; set; }

  public string Msg { get; set; }

  public bool? Success { get; set; }

  public DataInfo Data { get; set; }

  public string TraceId { get; set; }
 }

 public class DataInfo {
  public string ResultCount { get; set; }

  public IList<EsWayBillInfo> EsWayBill { get; set; }
 }

 public class EsWayBillInfo {
  public EsWayBillInfo() {
   ExteriorRouteList = new List<ExteriorRoute>();
  }

  public string WaybillNumber { get; set; }

  public string ProductCode { get; set; }

  public string ReceiveDate { get; set; }

  public string Receiver { get; set; }

  public string ExpectedDate { get; set; }

  public string MailingTime { get; set; }

  public string ServiceMode { get; set; }

  public string MailingAddress { get; set; }

  public string ReceivingAddress { get; set; }

  public string Addressee { get; set; }

  public string Sender { get; set; }

  public string TotalFreightAmount { get; set; }

  public string Count { get; set; }

  public string FreightWeight { get; set; }

  public decimal? Size { get; set; }

  public IList<ExteriorRoute> ExteriorRouteList { get; set; }
 }


 public class ExteriorRoute {
  public int Id { get; set; }

  public string RouteStep { get; set; }

  public string RouteDescription { get; set; }

  public string UploadDate { get; set; }
 }

　　有了输入请求参数，当然也需要能够接受最终数据的数据接口，这些数据结构首先都要定义好，而且必须和官方保持一致，否则就无法进行反序列化操作。

　　有了这些准备工作我们来看看最核心的获取业务数据的过程，我们会在稍后来对其中的一些代码进行说明。

public async Task<IList<EsWayBillInfo>> GetLogisticsInformationAsync(LogisticsInputModel input) {
   var parameter = new List<KeyValuePair<string, string>>();
   var nowDate = (DateTime.Now.ToUniversalTime() - new DateTime(1970, 1, 1)).TotalMilliseconds.ToString(CultureInfo.InvariantCulture);
   var jsonParam = JsonConvert.SerializeObject(input);
   var logisticsUser = new LogisticsUser() {
    appkey = Appkey,
    appsecret = Appsecret
   };
   parameter.Add(new KeyValuePair<string, string>("X-from", "openapi_ap"));

   var tokenResult = await HttpPostAsync(TokenUrl, JsonConvert.SerializeObject(logisticsUser), parameter);
   var codeMsg = JsonConvert.DeserializeObject<TokenResult>(tokenResult);

   //Token失效，调用刷新Token接口，返回新Token
   if (codeMsg.Data.Expire_time <= 0) {
    var tokenRefreshResult = await HttpPostAsync(RefreshTokenUrl,
     "{\"refresh_token\": \"" + codeMsg.Data.Refresh_token + "\"}", parameter);
    codeMsg = JsonConvert.DeserializeObject<TokenResult>(tokenRefreshResult);
   }

   parameter.Clear();
   parameter.Add(new KeyValuePair<string, string>("appkey", Appkey));
   parameter.Add(new KeyValuePair<string, string>("format", Format));
   parameter.Add(new KeyValuePair<string, string>("timestamp", nowDate));
   parameter.Add(new KeyValuePair<string, string>("method", QueryRoute));
   parameter.Add(new KeyValuePair<string, string>("sign", MD5Hash(Sign + nowDate + jsonParam).ToUpper()));
   parameter.Add(new KeyValuePair<string, string>("token", codeMsg.Data.Token));
   var result = await HttpPostAsync(RestUrl, jsonParam, parameter);
   return JsonConvert.DeserializeObject<LogisticInfoModel>(result)?.Data?.EsWayBill;
  }

　　这里有一些需要说明的部分，首先获取nowDate的时候是获取UTC时间，其次获取sign的时候需要对内容进行MD5加密的过程。Asp.Net Core中的MD5加密比较简单，采用下面的方式即可。

/// <summary>
  /// netcore下的实现MD5加密
  /// </summary>
  /// <param name="input">加密内容</param>
  /// <returns></returns>
  private string MD5Hash(string input) {
   using (var md5 = MD5.Create()) {
    var result = md5.ComputeHash(Encoding.ASCII.GetBytes(input));
    var strResult = BitConverter.ToString(result);
    return strResult.Replace("-", "");
   }
  }

　　这里使用Using包裹便于进行非托管对象的释放，这里需要注意，还有一些常用的const变量定义为局部变量即可，有了这些就能够创建一个完整的根据发运单号来获取完整的物流数据的第三方API对接过程了。

private const string Appkey = "80069";
  private const string Format = "json";
  private const string Appsecret = "XXXE034XXX355889DC68BB40BEDXXX0";
  private const string QueryRoute = "open.api.openCommon.queryRoute";
  private const string Sign = "XXXE034545E355889DC68BB40BEDXXX";
  private const string TokenUrl = "https://open.ky-express.com/security/token";
  private const string RefreshTokenUrl = "https://open.ky-express.com/security/token/refresh";
  private const string RestUrl = https://open.ky-express.com/router/rest;

　　最后我们来看看通过整个调用过程获取物流信息并在系统中进行展示的效果。

以上就是Asp.Net Core 调用第三方Open API查询物流数据的示例的详细内容，更多关于Asp.Net Core 调用第三方API的资料请关注脚本之家其它相关文章！

您可能感兴趣的文章:

Asp.Net MVC3.0如何项目部署到Win7 64位系统
这篇文章主要介绍了Asp.Net MVC3.0如何项目部署到Win7 64位系统的全部过程，需要的朋友可以参考下
2015-10-10
ASP.net全局程序文件Global.asax用法分析
这篇文章主要介绍了ASP.net全局程序文件Global.asax用法,较为详细分析了Global.asax文件中几个常见选项的含义及用法,需要的朋友可以参考下
2014-10-10
asp.net 相关文章实现方法
大家或许会觉得很惊讶：为什么灵感之源会讨论SQL？或许应该这样说吧：搞业务系统，不跟SQL扯上关系似乎比较难。
2009-05-05
asp.net小孔子cms中的数据添加修改
最近都在看小孔子cms的代码，其添加与修改数据十分方便，做下笔记，代码主要提取自小孔子cms，去掉了不用的函数并把相关代码写到一个文件中
2008-08-08
ASP.net Substitution 页面缓存而部分不缓存的实现方法
在ASP.NET中要实现部分内容非缓存，而其它的都需要缓存输出，可以使用Substitution控件实现.
2009-03-03
asp.net 身份验证（分目录验证篇）
在上一篇博文《asp.net中的身份验证（最简单篇）》中的身份验证虽然很简单，但是有一个缺点，就是访问整个网站都必须要经过身份验证，而事实上，很多网站都不会这么要求的。
2009-05-05
ASP.NET Core应用中与第三方IoC/DI框架的整合
ASP.NET Core应用中，针对第三方DI框架的整合可以通过在定义Startup类型的ConfigureServices方法返回一个ServiceProvider来实现。但是并不是那么容易的，下面通过实例给大家分享一下
2017-04-04
ASP.NET MVC在基控制器中处理Session
这篇文章介绍了ASP.NET MVC在基控制器中处理Session的方法，文中通过示例代码介绍的非常详细。对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
2022-08-08
asp.net 动态生成rdlc报表(原创)
因为公司需求研究微软的Reportviewer 因为有许多特别要求所以动态调用比较灵活我的需求是根据数据不同的合并表头（参考了随心所欲的博客文档再次表示感谢)
2011-12-12
.NET 6 中的 dotnet monitor详细解析
dotnet monitor 是一种工具，它提供了一种统一的方法来收集这些诊断信息，而不管您是在桌面计算机还是在 kubernetes 集群中运行,dotnet monitor 已经为 Azure App Service（Linux）提供 .NET 应用程序的诊断工具提供支持，我们希望它在更多环境中使用
2021-12-12