开发前必读

服务端API开放了丰富的能力接口，开发者可以借助接口能力，实现企业服务及企业微信的集成。支持的能力，通过目录导航可以快速预览，目录树按功能块聚合归类，如通讯录管理、消息推送等。

文档的阅读次序，建议先阅读一遍开发指南，以及接口token获取。然后就可以独立查看各个功能块文档说明。

所有的接口需使用HTTPS协议、JSON数据格式。

所有的请求都必须携带以下参数

名称	类型	必须	示例值	描述
token	string	是	eaa7c835b5b27c231a8b0c323feb1361	第三方认证的token,所有的请求需要携带该参数
request_id	String	是	09cb05da9c91453fa1ae08efa083ecd1	32位请求号,全局唯一,采用querystring方式携带在url后面

请求时将token通过http增加header的方式传递，token:"eaa9c935b5b27c231a8b0c323feb1361"

请求方式：所有接口统一使用 POST 方法

数据格式：请求和响应均使用 JSON 格式

字符编码：统一使用 UTF-8

认证方式：所有接口需要在 header 中携带 token

token是开发者调用Work-bot Api的重要票据，由accessKey和accessSecret产生。所有接口在通信时都需要携带此信息用于验证接口的访问权限。

获取token，参考 [文档说明]获取token。

名称	类型	必须	示例值	描述
accessKey	String	是	user1	登录账号
accessSecret	String	是	Q3KR21ME	登录密钥

accessKey、accessSecret在联系客服获得体验账号时颁发。

在本项目API文档中已设置了测试用的token，用于在测试相关Api时使用。

机器人交互接口包括服务请求接口和通知接口。
开发者通过服务接口调用机器人能力，服务端收到请求后，操纵机器人完成任务指令，执行结果通过通知接口回调开发者。
回调通知接口：企业微信收到的会话消息以及客户、群数据变更等将在回调通知接口通知开发者。

URL: /wxworkapi/message/exchange
Request method: POST application/json

请求消息id：messageld（String），必传，32个字符的唯一，回调接口原样回传示例：mm202504212069831394827942942968

说明: 回调通知接口, 由开发者实现，接口地址开发者自定义，文档中地址仅作为参考，回调通知接口地址需提供给客服进行配置
例如: URL: /XXXX/service/result
Request method: POST application/json

成功响应及重试说明：
接收通知接口需在收到通知时响应200状态码，非200响应，推送服务会识别为失败，延迟10秒重试1次，继续失败，再延时30秒重试1次。之后不再重试。

开发前必读#