微盛企微管家API
version: 0.3.79
阅读说明
企微管家通过开放接口(Open API)为接入企业提供进一步集成的能力。
建议开发者先阅读一遍接入指南,以及接口access_token获取,再独立查看各个功能模块的文档说明。
所有的接口需使用HTTPS协议、GET或POST请求方式、JSON数据格式、UTF8编码。接口说明格式如下:
请求方式:GET/POST(HTTPS) 请求地址:https://open.wshoto.com/openapi/test_api?access_token=ACCESS_TOKEN 请求包体: ... 参数说明: ... 返回结果: ... 参数说明: ...
请求方式 标明接口调用的HTTP方法,区分HttpGet/HttpPost请求,所有的请求都为https协议。
请求地址 参数中标注大写的单词,表示为需要替换的变量。在上面的例子中 ACCESS_TOKEN 为需要替换的变量,根据实际获取值更新。
请求包体/参数说明 标明请求参数示例及说明,参数说明包括字段含义、取值范围,开发者在设计数据结构时,应参考该定义范围。
返回结果/参数说明 标明返回参数示例及说明。返回结果中总是包含 code、msg字段,为基础返回字段。(说明:开发者应以接口文档中描述的返回字段为准)
其定义如下:
字段 | 类型 | 说明 |
---|---|---|
code | int | 出错返回码,为0表示成功,非0表示调用失败。错误码见下文说明 |
msg | string | 返回码描述,错误时会以中文方式显示错误原因 |
调用流程
获取access_token,参考 获取access_token
缓存和刷新access_token。开发者需要缓存access_token,用于后续接口的调用(注意:不能频繁调用access_token接口,否则会受到频率拦截)。当access_token失效或过期时,需要重新获取。
调用具体的业务接口