OpenAPI基本介绍

微伴助手开放接口对接文档

version: 0.4

注1：微伴助手开放接口已经开放公测，进入微伴后台-应用管理-API接入以获取企业标识（corp_id），企业API调用凭据（secret）

注2：系统内所有的时间相关字段如果没有特别说明都是以秒为单位。

注3：目前open api并未提供测试模式，请研发调用的时候注意，测试完成的时候及时删除测试数据。

阅读说明

微伴助手通过开放接口（Open API）为接入企业提供进一步集成和个性化定制的能力。

所有接口都使用 HTTPS 协议，JSON 数据格式和 UTF-8 编码。

接口使用 GET 和 POST 两种操作，其他类型操作（如 PUT）皆不会用到。

GET 类型操作中可能需要 query参数。

说明: query参数是放入url中的参数，例如 API 企业微信营销_企业微信会话存档_私域流量运营-微伴助手官网在添加 query 参数 access_token 和 id 后完整请求为：

企业微信营销_企业微信会话存档_私域流量运营-微伴助手官网

另外，POST 类型操作中除了 query参数 外还可能需要提供 body参数。具体会在相应业务 API 文档中介绍。

请求返回值中总是包含 errcode 和 errmsg 字段，称为基础返回字段。用于描述请求的成功状态，其定义如下：

https://weibanzhushou.com/dashboard/side_window#tab=clientCustomerInfoManage

node后端接口：

企业微信点击客户画像时，自动调我们配置的卡片链接对应后端接口，并将code传递给后端接口，后端拿到code。前端使用vue开发多页面应用，其中包含一个order.html页面用于显示在这个自定义卡片的位置。后端通过http协议读取order.html页面，并将code或者自定义一个token以响应头的形式返回给企业微信的卡片处。前端拿到code或token后可以和后端的其他接口交互了。

//微伴测试
const toolsGetPage = async (req, res) => {const { code } = req.queryconsole.log(req.url)console.log(code)axios({url: 'https://test.xxx.com/weiban/order.html'}).then(resHtml => {//console.log(resHtml.data)// const tempPage = fs.readFileSync(//   '/source/banxuezhushou_h5/public/weiban/index.html',//   'utf-8'// )if (code === '666') {res.setHeader('access_token', Date.now())res.setHeader('code', code)res.send(resHtml.data)//res.redirect('http://localhost:85/#/h5/index/home/recommend')} else {res.setHeader('access_token', 'no')res.setHeader('code', code)res.send(resHtml.data)}    })}

order.html: