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

ASP.NET

JavaScript ASP.NET PHP编程正则表达式 AJAX相关 ASP编程 JSP编程编程10000问 CSS/HTML Flex 脚本加解密 web2.0 XML/RSS 网页编辑器相关技巧安全相关网页播放器 Dart Vue.js

上一篇: AntDesign Pro + .NET Core 实现... 下一篇:Asp.Net Core中创建多DbContext并...

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

发布时间：2022-04-16 发布网站：脚本宝典

脚本宝典收集整理的这篇文章主要介绍了Asp.Net Core 调用第三方Open API查询物流数据的示例，脚本宝典觉得挺不错的，现在分享给大家，也给大家做个参考。

　　在我们的业务中不可避免要与第三方的系统进行交互，调用他们提供的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的名称。

@L_360_4@

　　二获取参数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
   };
   for@R_512_2428@ (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 Core 调用第三方Open API查询物流数据的示例全部内容，希望文章能够帮你解决Asp.Net Core 调用第三方Open API查询物流数据的示例所遇到的问题。

如果觉得脚本宝典网站内容还不错，欢迎将脚本宝典推荐好友。

本图文内容来源于网友网络收集整理提供，作为学习参考使用，版权属于原作者。
如您有任何意见或建议可联系处理。小编QQ：384754419，请注明来意。

上一篇: AntDesign Pro + .NET Core 实现... 下一篇:Asp.Net Core中创建多DbContext并...

猜你在找的ASP.NET相关文章

C# 一些面试试题的实例教程 2022-05-16
.NET 6开发TodoList应用之请求日志组件HttpLogging介绍 2022-04-16
.NET 6中间件Http Logging使用介绍 2022-04-16
gojs一些实用的高级用法 2022-04-16
.NET 6开发TodoList应用之实现查询排序 2022-04-16
.NET 6开发TodoList应用之实现数据塑形 2022-04-16
.NET微服务架构CI/CD自动打包镜像 2022-04-16
Asp.Net Core 使用Monaco Editor 实现代码编辑器功能 2022-04-16
.NET微服务架构CI/CD自动构建Jenkins+Gitee 2022-04-16
.Net Core微服务网关Ocelot集成Consul 2022-04-16

全站导航更多

最新ASP.NET教程

热门ASP.NET教程

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

目录

一 构造HttpClient对象

二 获取参数Token

三 获取发运单数据

脚本宝典总结

　　一构造HttpClient对象

　　二获取参数Token

　　三获取发运单数据