用.net访问电子枢纽信用中心的数据查询服务

概要说明

电子枢纽全称国家交通运输物流公共信息平台，主要提供物流及生产企业进行物流相关数据交换的标准和API，详细介绍可参考其官网www.logink.org，本文假定阅读者对该平台已有了解，并已成功申请了相应的帐号和数据交换服务。

信用中心是电子枢纽众多数据服务中的一个，提供物流参与者信用信息的上传和查询，包括运输车辆、从业人员等。官方的示例和介绍大多以Java为主，.net的非常少，希望本文可以帮助.net开发人员快速掌握数据交换方式。

电子枢纽的数据服务分为两种，一种称为数据交换，另一种称为服务调用。

数据交换是一种类似电子邮件的行为，可以把电子枢纽看作是一个邮件服务器，发送和接收数据就与收发电子邮件的方式类同。

服务调用就是常规的HTTP请求，主要用于向电子枢纽查询信息，例如对于信用中心来说，可以查询到车辆的运政信息、诚信记录等。

本文主要介绍的是服务调用方式，要调用电子枢纽提供的服务，首先必须确保已经开通了相关服务，开通后还需要获得服务的ID，这些任务都可以从电子枢纽的用户管理中心完成。

在调用服务前，必须获得用户验证的令牌（Access Token），这项工作可通过统一认证服务完成，获得令牌后，方可凭令牌调用相关服务。

引入服务

电子枢纽的数据接口都是以Web Service提供的，所以在开始编码之前，可以先引入相关的服务，在VS里直接添加服务引用即可，相关的服务地址可以在官网的开放接入中心找到。

值得注意的是，虽然电子枢纽提供的大部分Web Service都可以在VS中直接引入，但还有个别不能采用这种“添加服务引用”的方式，目前已知的就是信用中心服务。对于这种情况，需要在VS中以Web引用的方式来添加，具体方法如下。

右键点击解决方案浏览器中项目或引用（Reference）的节点，在菜单中选择“添加服务引用”（Add Service Reference），在弹出的对话框里点击“高级”（Advanced），再在弹出的服务引用设置对话框里点击“添加Web引用”（Add Web Reference）即可调出添加Web引用的对话框。

  

至于为什么要这样，由于我对SOAP和WCF没有太多了解，实在没法回答这个问题，希望这方面的大神可以给出解答。

访问代码

引用添加完以后，VS会为我们自动生成好相应的类型，直接使用就可以。

首先是获取令牌，统一验证服务的客户端类型是AuthenServiceClient，实例化以后调用他的authenticate方法，方法签名如下：

authenticate(string applicant, string userid, string password, string resource)

关于这个方法的具体说明，可参考官方说明。

返回值的tokenValid属性指示是否验证成功，如果为true，可通过token属性获取令牌的值。示例代码如下：

 private bool Authenticate(LoginkUser user, string resId, out string token)
 {
     AuthenServiceClient clnt = new AuthenServiceClient();

     var result = clnt.authenticate(user.ExchangeCode, user.ExchangeCode, user.Password, resId);

     if (result.tokenValied)
         token = result.token;
     else
         token = null;

     clnt.Close();

     return token != null;
 }

得到令牌以后，就可以直接调用信用中心的查询服务了，VS生成的信用中心服务的客户端类型为LoginkServiceService，实例化后调用它的InterfaceName方法。

genericResult InterfaceName(authentication Authentication, publicInformation PublicInformation, string BusinessInformation)

这个方法没有找到官方的文档，由于各个参数比较复杂，就不一一介绍了（其实我自己也没搞明白），直接照抄下面的示例就可以了。

 private string CallCreditService(LoginkUser user, string token, string action, string request)
 {
     var css = _settings.CreditService;

     Logink.Services.Credit.security security = new Logink.Services.Credit.security();
     security.LogisticsExchangeCode = user.ExchangeCode;
     security.UserTokenID = token;

     Logink.Services.Credit.authentication authentication = new Logink.Services.Credit.authentication();
     authentication.UserName = user.ExchangeCode;
     authentication.UserPassword = user.Password;
     authentication.ServiceId = css.ResourceId;
     authentication.UserId = user.ExchangeCode;

     Logink.Services.Credit.publicInformation publicInformation = new Logink.Services.Credit.publicInformation();
     publicInformation.ServiceType = "";
     publicInformation.ActionType = action;

     Logink.Services.Credit.LoginkServiceService service = new Logink.Services.Credit.LoginkServiceService();
     service.Url = css.Url;
     service.Security = security;

     var result = service.InterfaceName(authentication, publicInformation, request);

     if (result.ResultCode)
     {
         return result.BusinessInformation;
     }
     else
         throw new ExchangeException(result.ExceptionInformationCode, result.ExceptionInformation);
 }

示例中这个CallCreditService方法已经封装了调用信用中心服务的各种参数，其中action参数表示业务类型，官网有介绍，下面再详细说下request参数。

request参数实际上是个经过Base64编码的XML字符串，XML的内容就是各个传入参数的值，需要注意的是，传入的这个XML串并不是完整的文档，而是根节点以下的内容，千万不要把根节点也传上来，如果你使用XmlDocument来处理传入参数，可以使用根节点的InnerXml属性。

Base64编码相对来说就比较简单了，System.Convert类型直接支持转换为Base64，默认情况下电子枢纽使用的是UTF8编码，在编/解码时不要搞错，否则会查不到数据或出现乱码。

 private string XmlToBase64(string xml)
 {
     if (string.IsNullOrEmpty(xml))
         return xml;

     return Convert.ToBase64String(Encoding.Utf8.GetBytes(xml));
 }

最后，需要处理的是InterfaceName的返回值，返回值的ResultCode指示是否调用成功，如果不成功可通过ExceptionInformationCode属性获取错误代码，否则可以通过BusinessInformation属性获取返回的文本。

返回的文本同样是一个Base64编码的XML字符串，转换成明文以后就可以直接使用了，不过对于明文的处理是一件比较头痛的事，经过多次试验最终摸索出以下的规律。

文本为空串：可能是没有查询到相关的内容。

文本不是XML：尽管ResultCode为true，但仍旧可能是出现了错误，文本的内容就是出错信息。

对于这些情况，我们的程序都应该进行相应的处理。

 public XmlDocument QueryCredit(QueryParameters parameters)
 {
     if (parameters == null)
         throw new ArgumentNullException(nameof(parameters));

     AccessToken token;
     string data;
     bool forceRenewToken = false;

     retry:

     // 通过统一验证服务获取用户的访问令牌
     token = GetToken(_user, _settings.CreditService.ResourceId, forceRenewToken);

     // 将传入参数序列化为XML
     data = parameters.GetXml();
     // 对XML转换为BASE64编码
     data = XmlToBase64(data);

     try
     {
         // 调用信用中心的Web Service
         data = CallCreditService(_user, token.Value, parameters.ActionName, data);
     }
     catch(ExchangeException ee)
     {
         // 判断是否需要更新令牌
         if (ee.IsTokenInvalid && !forceRenewToken)
         {
             forceRenewToken = true;
             goto retry;
         }
         else
             throw;
     }

     if (!string.IsNullOrEmpty(data))
     {
         // 返回的内容已做了BASE64编码处理，将它转换为XML。
         data = Base64ToXml(data);

         // 部分情况下平台返回的可能是一串错误信息而非XML，因此对不是"<"开头的直接按错误信息处理。
         if (data[] == '<')
         {
             XmlDocument doc = new XmlDocument();
             doc.LoadXml(data);

             return doc;
         }
         else
             throw new ExchangeException(data);
     }
     else
     {
         // 如果返回的内容为空，可能是没有查到相关数据。
         throw new ExchangeException("", "暂时没有查到相应数据");
     }

 }

到些为止，调用信用中心服务所需的代码都已经大致做了介绍，把它们串起来以后就形成了一个完整的程序，全部源代码请点击此处。由于我的电脑上装的是VS2015，低版本的VS可能没办法打开，实在抱歉。

相关资源

几个必须加入的QQ群

213604083：平台接入群，这是必加的一个群，有很多平台的管理人员在里面，一些基础的问题可以问问他们，当然还有一点很重要的是群里有开发所需要的许多资源。

383412768：信用接入群，如果要使用信用中心服务，这就是你要找的组织。

363016382：园区通接入群，如果你是为了接入而接入（你懂的），那这里是也是必须的。

601484722：充装数据接入群。