腾讯EC .net API对接第三方系统

　　最近公司销售部门用到了腾讯EC，实现公司内部OA系统与腾讯ec的数据同步，要求如下：

1、OA内部系统账号与腾讯ec登陆账号同步

2、首先做义工客户端工具用来把现有客户导入到EC,销售人员的客户信息与EC同步，同时EC添加客户也要同时保存到OA系统内部，两边实现同步

　　在此不得不吐槽一下，腾讯EC的api，竟然没有导入用户的功能，各种验证，由于内部OA使用比较长，以前手机号码有的填的手机号，有的是固话，本想直接导入到EC电话字段，ec的电话字段竟然只认手机号，同时也不得不说一下ec的产品经理，在我眼里特么他们就会说，没有安排，就是这么设计的，时间成本，那垃圾接口都难用成这样了，还不改改吗，难怪EC的客户比起钉钉来真是差远了，，，，，，，，，，，，，，，，，吐槽一下。

3、公司内部语音及电话记录自动导入到腾讯EC

4、各种自定义字段来存OA系统里面的客户信息字段

 

首先，封装一个通用的用来请求Https，返回json数据的网络请求方法，如下图：

腾讯EC请求接口必须要的access_token，由于token每两小时过期，于是写了一个通用的辅助缓存类，用来缓存token及其他常用数据，使用了System.Runtime.Caching的内存缓存实现：

接着就是获取token的方法和过期自动刷新token

下面说一下导入oa客户的业务了，由于腾讯EC没有同步系统账号的功能只有在api后台有个导入模板的功能，没办法只能先用表格把系统用户导入ec，然后用手机号来对应ec账号和系统账号，通过手机号拿查询ec获取id，同时也通过手机号获取oa系统内部人员和客户的关系一次来导入客户进入ec，公司系统客户信息有很多字段信息和多个联系人，而ec的可用字段只有那几个，没办法在后台建立了很多个自定义字段来做对应，总之是先查出系统的客户信息和联系人信息通过构建ec需要的Json对象*（当然还包括多个自定义字段），构造号客户添加的json直接post到接口，不得不说各种验证导致了各种错误，于是就在接口返回的地方加了日志来记录导入数据的错误信息，好在返回的错误信息还算明确

客户相关操作：

错误日志信息：

相关实体类及缓存键值：

最后附上同步程序的客户端：

此程序封装客户导入，同步，查询及同步跟踪记录的功能，跟踪记录是在另一套客服系统里面实现自动同步数据到ec，于是把ecapi封装成类库供其他程序调用。

 

总的来说，第三方接口对接很简单，但是感觉EC 的api接口实在是不强大，很多不合理的地方，接口至今也不完善，本文记录一次第三方系统对接EC的过程，同时也提供了一个很简单思路，仅供记录，高手勿喷，喷子勿喷，谢谢。

有需要源码和交流的可以联系：1013454562

另外也可加入本人新建的QQ群：487501652