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

前言:公司的业务主要是对接财务系统做单据传输或者凭证处理的,难免少不了和各大财务软件做数据对接,其中当然是必须通过接口来传递数据了。于是乎,用友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申请 http://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+接口的经验,下次遇到同样的项目就可以直接使用了,也免去了后续的麻烦。也希望自己在以后的工作中能更加有经验。加油。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,293评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,604评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,958评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,729评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,719评论 5 366
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,630评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,000评论 3 397
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,665评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,909评论 1 299
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,646评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,726评论 1 330
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,400评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,986评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,959评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,197评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 44,996评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,481评论 2 342

推荐阅读更多精彩内容