各位知友大家好！我是量潮科技创始人 @iGuo ，这篇文章和大家分享我们公司目前的一些技术进展和一些开源项目的规划。

在技术方面，我们目前还处在搭建平台的早期阶段；在架构完善以后，我会专门写一篇文章介绍量潮应用系统的设计思路和实现方案。在这个过程中，我们需要使用大量腾讯系( @腾讯 )的API和SDK，包括腾讯云( @腾讯云 @腾讯云技术社区 )、微信公众号( @微信 )、微信小程序、微信开放平台、微信支付( @微信支付 )、企业微信( @企业微信 @企业微信团队 )等等。我们遇到的最大困难是SDK不好用。这里不得不吐槽一下，腾讯系的API文档十分难读且返回值略微有些混乱，SDK十分难用且内部实现十分糟糕，还有很多API并没有官方SDK，我们的开发进度遇到了极大的阻碍，大部分时间都浪费在了和API、文档、源码做斗争中。

这里大概介绍一下腾讯系Python SDK的情况。

腾讯云：有官方SDK(Python - SDK 中心 - 腾讯云)，但是腾讯云官网给的SDK使用样例的文档实在太难理解，使用的过程中主要还是需要去翻源码。深入研究源码以后，我们发现腾讯云SDK的源码实现十分糟糕，有很多多余的代码，接口也十分不友好。(PS：阿里云、支付宝的Python SDK情况基本差不多，源码甚至更加让人匪夷所思……)在启动非官方SDK的开发计划的时候我们会详细介绍。

微信系(微信公众号、微信小程序、微信开放平台、微信支付)：没有SDK，其中微信公众号、微信支付、微信开放平台是比较早的产品，API文档十分混乱，重复信息很多，遗漏的要点很多，demo过少，等等，基本来说是不说人话的，只能意会。且测试环境十分糟糕，微信支付的沙箱环境等于不可用，且在社区没有看到成功使用的案例。(PS：隔壁支付宝的沙箱好用多了……)而且由于安全限制，微信系几乎很难在本地测试。(PS：企业微信和腾讯云是可以本地测试的。)

企业微信：没有官方SDK，API文档还算比较清楚。加密算法的文档有小问题，在后文中我会详细介绍一下。加密算法提供了所谓SDK，但是……我看了以后表示，这也能叫SDK？勉强可以算demo，而且不太能用，最后我参考了一些小的实现以后重新写了一遍算法……

为了把这些坑填上，我们在量潮应用系统里做了一层SDK二次封装，把外部API和SDK重新封装处理，并且统一了接口风格。因此我们积累了一些SDK代码，打算分步把SDK库开源出来。由于企业微信的文档最说人话，SDK生态比较空白，而且封装相对容易做，所以我们先从这边开始开源。

下面介绍一下封装思路。

企业微信有两大类接口，一类是主动接口，是向企业微信服务器发送请求并且返回；一类是被动接口，是企业微信服务器向开发者服务器发送的回调数据。

主动接口的逻辑比较简单，只有两步。第一步，开发者发送corpid和应用sercet，接收access_token，有效期三十分钟。第二步，开发者向具体接口发送access_token和请求数据，并且接收返回数据。以通讯录读取成员API(读取成员 - 企业微信API)为例：

# 定义

class ContactSDK(object):

def __init__(self, corpid, secret):

self.corpid = corpid

self.secret = secret

@property

def access_token(self):

return get_access_token(corpid, secret)

def get_user_info(self, data):

return get_user_info(self. access_token, data)

# 调用

sdk = ContactSDK(corpid, secret)

return_data = sdk.get_user_info()

由于企业微信的接口是比较有规律的，所以可以首先定义一个基本SDK，比如

class WeChatWorkSDK(object):

def __init__(self, corpid, secret):

self.corpid = corpid

self.secret = secret

self._api_root = 'xxx' # 顶层URL

@property

def access_token(self):

# 包含缓存和refresh逻辑

return get_access_token(corpid, secret)

def request_api(api, method, params, data):

import requests

params['access_token'] = self.access_token

return requests.request(method, self._api_root+api, params, data)

然后继承：

class ContactSDK(WeChatWorkSDK):

def __init__(self, corpid, secret):

super().__init__(corpid, secret)

self._api_root = self._api_root + 'ttt' # 下级URL

def get_user_info(self, params):

return self.request_api('ddd', 'GET', params)

这样会更加简单清晰。

回调SDK基本同理，复杂的点在于需要实现加密解密算法，这里就不贴源代码了。加密解密算法如下：加解密方案说明 - 企业微信API。文档里面有一处没有说清楚的小错误。在最后的示例中的第三步，伪代码如下：

content = rand_msg[16:] # 去掉前16随机字节

msg_len = str_to_uint(content[0:4]) # 取出4字节的msg_len

msg = content[4:msg_len+4] # 截取msg_len 长度的msg

receiveid = content[xml_len+4:] = "wx5823bf96d3bd56c7" # 剩余字节为receiveid

其中xm_len的解析略微有一些小的处理，我在Python demo中看到了处理方式，还没有来及详细确认具体的算法。文档对于怎么获得xml_len这个东西没有仔细说明，因此加密解密的文档不可以直接完全follow。

项目的地址在：https://github.com/quanttide/wechatwork-sdk-py​github.com

目前我们项目周期比较紧张，所以暂时只实现一些需要用到的接口，并且只在自己的开发环境中做初步的alpha测试，beta测试和接口的完善需要社区一起完成。感兴趣的同学可以私信 @iGuo 。初步覆盖完以后，会以Pypi包的形式发布，方便大家直接用pip下载使用，暂时还没有打包。

上文提到的其他SDK内部开发还没有完成，逻辑还没有完全梳理清楚，之后会单独写文章介绍和发布相关SDK的开发计划和项目地址。

欢迎大家联系和关注量潮科技！