企业自主应用开发流程

  1. 开通接口服务,获取到appId和appSecret。如信息有泄漏,需及时修改appSecret。
  2. 根据接口说明调用各个接口,完成对企业资源的访问和操作。

接口约定

接口域名: https://wx2.xjuke.com。
所有的接口如无特别说明,一律使用POST请求,返回JSON格式数据。

参数 说明
appId 企业接口服务唯一标识,开通接口服务时获取
timestamp unix时间戮,表示请求发送时间,与接口服务器时间相差不能超过5分钟
sign 将拼接得到的字符串后面拼接上appSecret,然后进行md5加密,然后把所有字符转换成大写, 最终得到sign的值。

公共请求参数:

签名生成规则:

  1. 将所有请求参数(包含appId, timestamp)升序排列。
  2. 将参数的名称和值按顺序拼接(不需要encoding):key1=value1&key2=value2… 。
  3. 将拼接得到的字符串后面拼接上appSecret,然后进行md5加密,然后把所有字符转换成大写, 最终得到sign的值。

请求示例(appSecret: 9021dp2dqtyplc6p9lgnwnwpzj8czf9y):

POST /demo HTTP/1.1
Host: wx2.xjuke.com/oapi

appId=kk75212380&timestamp=1511865228&keyword=mobile&priceMin=0&priceMax=100&sign=fb9eb72dbbdfd483c1c85f89e3b200fb