记录用友T+接口对接的心酸历程

495 阅读6分钟

前言:公司的业务主要是对接财务系统做单据传输或者凭证处理的,难免少不了和各大财务软件做数据对接,其中当然是必须通过接口来传递数据了。于是乎,用友T+的版本来了,对接的工作自然是我来做,可没想到就是这样一个T+接口,搞得我快吐血了。

1.先简单描述下项目的运行环境,.net core 2.2。这也是导致后来一直卡在接口对接上的一大原因。接口不太支持.net core的运行环境。因为自己之前也处理过财务接口,金蝶K3,KIS账务平台,K3wise,U8Cloud等等,说实话,T+还是第一次接触,当然第一件事肯定是看官方文档了。直通车 T+开发平台,不过打开之后,浏览器一直在刷新页面,后来问了社区的服务人员人家说换个浏览器试试,换了T+的浏览器,结果还是一直刷新,到底是啥问题,咱也不知道,咱也不敢问🤣🤣,后来在官网的文档中给了解释,说是最好使用IE和360浏览器,估计是客户使用的比较多吧,所以才不兼容主流的Google浏览器嘛?

2.OK,那么首要任务就是先熟悉接口定义以及相关的请求方式和请求参数等等,当然返回参数也是需要的。接着就开始将接口封装到项目中了,T+ OpenAPI v2 接口需要引入鉴权机制,简单的来说就是需要在每次请求业务接口时,请求的Header需要带上Authorization参数,那么Authorization怎么来获取呢?见下图,即 对appKey,authInfo,orgId做base64位的加密。那么authInfo的值又如何获取呢?请看官方文档的注释,即 对 appkey,orgid,appsecret这三个参数做一次签名算法,那么还有两个问题需要解决。第一,这三个参数怎么获取?ISV申请 tplusdev.chanjet.com/enterprise 官网注册后会有ISV的申请,点击申请填写好资料后系统会有人员审核资质并发放具体的加密密钥。好了,第一个问题解决了,那么第二个问题呢?签名算法怎么做。不要着急,官网也有提供,这里仅标注C#版本,因为使用的环境是.net 的 签名1的下载地址签名1下载。

签名算法1 3.OK,我们接着往下看,如果上一步的工作都做完并且正常返回 {"result":true,"access_token":"03e74889-1457-48cd-970a-ba3742ffcdea","sid":""} 的信息时,不要高兴的太早,我当时也以为接口调用成功了,没想到啊,还是太年轻。还有接着的业务调用需要用到上一步请求到的access_token。请求方式,如下图官网给的注释一样,只不过在做authInfo的值处理时,需要添加第一步获取到的access_token的值同时做签名2的处理。签名2地址下载。不过官网给的还有对应的winForm demo大家可以下载后,根据自己的参数做出修改,并且可以在线调试,还是比较方便的,比较容易定位到问题。T+OpenAPI测试工具(包含v2版本).zip(C#) .

签名算法2 4.好了,坑终于来了,下载完demo后,将demo中用到的dll拷贝到自己的项目中去。主要用到的dll 有这么多

dll引用 由于官网提供的版本是.NET Framework的版本,但是项目中的环境是.net core2.2,大家都知道,目前.net Framework的好多类库,在.net core 下是不支持的,比如接口中用到的jose-jwt.dll

遇到这种情况,我的第一反应是反编译,将dll反编译为工程文件,再引用到自己的项目中去。因为之前做金蝶K3Cloud的接口也是,提供的是framework的版本,当时也是搞了好久的接口,最后采用的反编译项目才搞定的。所以这次也是想着直接反编译项目试试,结果,自己还是太年轻。反编译的项目在.net core 下也不能用。怎么办呢,当然是问了,在社区发布问题,加QQ群,问群里的大佬,有用的回答寥寥无几,不过还是感谢群里的一个朋友,指出来是jwt的加密算法有问题,虽然最后我实在是找不到到底是加密算法哪的问题,问了他好几次,他也没有告诉我。😮😮不过还是谢谢他。

至于加密算法是哪的问题,最后我也找到了问题,不过解决办法却没有找到。反编译出来的加密算法,在执行到num=加密方法的时候,最后返回的num值不是0,所以到这一步总是会报错,至于为啥会报错,对不起,我到现在也没搞清楚,因为加密源码这块,实在是看不太懂。原谅本人经历太浅,技术太菜。🤣🤣。就这样,一个业务调用的接口,搞了我差不多一个星期的时间,无奈啊,还是没搞定,只好求助自己的技术老大了,也是自己的老师,非常感谢感谢。在他努力一天的结果下,终于把接口的第一步调通了,但是夜里接到他通知我接口搞定的微信后,我就睡不着了。一直在想,在🙏希望业务调用的接口也能正常使用。怀着忐忑的心情,跑起来他给我的项目,哈,果然,控制台确实返回了结果,只不过是Token的获取结果。还不能确定第二步是否能用。

后续我将业务调用的代码添加上后,激动的按下了F5,结果还是不出所料,接口返回 提供的令牌信息不正确。。。这些天,我看这些个文字已经快看吐了。带着截图去群里问大佬,@大佬,结果没有人回复。哎,我也不知道为啥,问个问题也没回复的。没办法,接着调试呗。将老大给我的新封装的.net core 环境下的T+项目里的jose-jwt 添加到官网给的framework的winForm程序里去,这样调试,我就能快速找到问题所在,并且修正问题。皇天不负有心人啊,终于,感谢天,感谢地,再没出现 令我作呕的错误文字了。不由地心里好一阵激动。不容易啊,不容易。

jose-jwt源码签名加密 5.至此,终于是将T+的接口给搞定了,也不枉自己在这上面耽误这么多时间,感觉自己的头发又掉了好多。😂😂😂最后的最后,附上.net core 环境下T+的接口调用,给有需要的朋友,也免得大家入坑。Tplus.net core接口下载

总结一下,在处理接口问题的时候,其实最重要的还是要彻底理解接口的定义,然后做起来才能得心应手,不过,也很感谢这次经历,起码有了对接T+接口的经验,下次遇到同样的项目就可以直接使用了,也免去了后续的麻烦。也希望自己在以后的工作中能更加有经验。加油。

最新的代码已上传到github上,T+.netCore github.com/wnxyz8023/T…