1. 约定、限制及假设

Confluence 已安装 WeChat Work for Confluence 插件，并已完成移动端配置、用户绑定配置。

 

2. 接口文档

(1) 功能描述

根据调用方传入的参数，给对应的企业微信用户发送消息通知。

(2) 调用说明

请求类型

POST

请求地址

{confluence_base_url}/rest/weChat-CF/2/message/sendMessage

媒体类型

application/json

请求头

weChatNotiToken: xxxxxx

必填。

weChatNotiToken 是其他插件或第三方服务在调用本 API 时必需提供的安全令牌。具体请查阅下文：2.2.2 API 令牌配置。

Auth

匿名接口无需 Auth。通过 headers 里面传过来的 weChatNotiToken 判断调用是否合法。

Body

以 JSON 格式传输 body。

 

{

“userKey”: [“1000000001”, “1000000002”],

“mode”: “1”,

“title”: “xxx到期了”，

“content”: “将要到期了请尽快处理”，

“url”: “https://www.xxx.com/xxx”

}

 

必填字段：

userKey、mode、title、content、url（仅卡片类型必填）

参数说明

  1. userKey: 一个集合，Confluence用户唯一标识（注意 User Key 不是 User ID）。

  2. mode: 企业微信消息通知的方式（整数类型: 1为文本，2为卡片）。

  3. title: 消息标题（String类型；不超过128个字节，超过截取）。

  4. content: 消息内容（String类型；html标签需要拼接，不超过512个字节，超过截取）。

  5. url: 卡片消息点击后跳转详情页面的url （String类型；请确保包含了协议头（http/https））。非卡片消息类型值可为空。

 

(3) 消息返回

消息返回格式示例：

{"code": "00000", "msg": "发送成功"}

 

返回内容为字符串，格式为JSON，UTF-8编码。含code和msg。

 

code为消息码，msg 为消息内容。

 

具体消息返回请参照下文：4. 消息码与消息内容一览表。

3. 日志记录

接口接收到的每一条请求报文，都会记录到 confluence 日志中，便于后期调试排错。

 

所有的错误与异常均记录在 atlassian-confluence.log （confluence application 日志）、catalina.out （confluence tomcat 日志）。

 

4. 消息码与消息内容一览表

消息码

消息内容(中文)

00000

发送成功。

90000

参数构造不合法。

90001

WeChat Work for Confluence 插件的许可无效。

90002

weChatNotiToken 不合法。

90003

用户（Confluence user key）不存在或未绑定企业微信用户。

90004

mode 参数不合法。

90005

title 参数不合法。

90006

发送格式为卡片时 url 不能为空。

90007

WeChat Work for Confluence 插件的配置错误。

90008

Headers 中没有 weChatNotiToken。

90009

content 参数不合法。

50000

未知错误。

 

  • No labels