功能介绍

消息通知接口实在安装插件后提供的一种功能，可以是企业在安装插件后对接别的机构或产品时使用，只需调用消息通知接口即可发送飞书的通知。

API 令牌是其他插件或第三方服务在调用本 API 时必需提供的安全令牌。用户调用这个 API，就可以给某个飞书用户发送通知。

一、消息通知接口配置、使用

1）API 令牌配置

使用消息通知接口必须要进行如下配置。并获取到令牌后，使用令牌进行接口的调用。

通过插件-【API 令牌配置】，点击”创建令牌“，对令牌名称和有效期进行配置，点击”保存“，即可成功创建令牌。

2）约定、限制及假设

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

3）接口文档

(1) 功能描述

根据调用方传入的参数，给对应的飞书用户发送消息通知。

(2) 调用说明

请求类型

POST

请求地址

{jira_base_url}/rest/feiShu-jira/2/message/sendMessage

媒体类型

application/json

请求头

noticeToken: xxxxxx

Required.

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

Auth

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

Body

以 JSON 格式传输 body。

{     

"userKey":["JIRAUSER10100", "JIRAUSER19625"],    

 "title":"问题即将到期",     

  "content":"问题即将到期，需要尽快处理",    

 "issueKey":"Test-1 "

}

必填字段：

userKey、title、content

非必填字段：

issueKey

参数说明

  1. userKey: 接收消息的用户集合，Jira用户唯一标识（注意 User Key 不是 User ID）。

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

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

  4. issueKey: 问题Key，可为空，为空时，消息中不带问题信息。


(3) 消息返回

消息返回格式示例：

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


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


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


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


3. 日志记录

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


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


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

消息码

消息内容(中文)

00000

发送成功。

90000

参数构造不合法。

90001

插件的许可无效。

90002

noticeToken不合法。

90003

用户不存在或未绑定飞书用户。

90005

title 参数不合法。

90007

插件的配置错误。

90008

Headers 中没有请求头。

90009

content 参数不合法。

90011

请先在移动端进行配置

5. 范例

不带issueKey：

带issueKey：

  • No labels