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方法来创建对象。
这个createclient方法中需要传一个标识你现在使用的httpclient的名称。
二 获取参数token
按照他们的api规范中说的,在headers中需要进行token传递的,这个称之为请求票据,没有这个是无法进行验证的,首先我们需要定义一个用于请求token的数据结构,同时还需要根据他们的规范来定义一个接收token的数据结构。
a 请求token的数据结构
b 接收token的数据结构
c 同步请求方法
这个方法是一个常规的异步请求方法,这里使用httpcontent作为数据载体,将一些重要的系统参数添加到headers里面,将业务参数传递到stringcontent的构造函数中去,最后调用postasync异步方法发送post请求,请求完了通过返回的response来获取返回的数据,通过这种方式来获取完整的数据结构。这里特别需要注意如果第一次请求token失败则可以再次请求重新刷新token,最后将获取的json类型token反序列化为我们定义的tokenresult结构,这样我们就能够正常获取到token数据了。
三 获取发运单数据
我们之前所有的工作都是为了能够获取到最终的业务数据,那么这里我们也是一样,首先要定义请求和接收数据的数据结构,首先是请求的数据结构。
这里面customercode是我们用户编码,这个是唯一的,这是跨越速运官方给予的用户凭证,第二个waybillnumbers 就是我们需要查询的发运单的集合,这里的接口支持一次性查询多个发运单数据,所以接口使用string[ ]数组类型。
下面来说一下根据官方定义来定义查询物流信息的接口定义。
有了输入请求参数,当然也需要能够接受最终数据的数据接口,这些数据结构首先都要定义好,而且必须和官方保持一致,否则就无法进行反序列化操作。
有了这些准备工作我们来看看最核心的获取业务数据的过程,我们会在稍后来对其中的一些代码进行说明。
这里有一些需要说明的部分,首先获取nowdate的时候是获取utc时间,其次获取sign的时候需要对内容进行md5加密的过程。asp.net core中的md5加密比较简单,采用下面的方式即可。
这里使用using包裹便于进行非托管对象的释放,这里需要注意,还有一些常用的const变量定义为局部变量即可,有了这些就能够创建一个完整的根据发运单号来获取完整的物流数据的第三方api对接过程了。
最后我们来看看通过整个调用过程获取物流信息并在系统中进行展示的效果。
以上就是asp.net core 调用第三方open api查询物流数据的示例的详细内容,更多关于asp.net core 调用第三方api的资料请关注其它相关文章!