JIRA REST API是否支持查询标签列表?

时间:2016-09-12 05:07:28

标签: label jira jira-rest-api

我看到能够通过

获取项目的所有组件
/project/[projectkey]/components

但我没有看到任何关于如何获取项目可用标签列表的功能或文档(如:

/project/[projectkey]/labels

JIRA REST API是否支持查询项目中可用的标签列表?

2 个答案:

答案 0 :(得分:1)

为了澄清,标签(至少是内置的JIRA标签)是全球实体,因此它们可以附加到任何项目中的任何问题。

关于你的问题 - 不,没有公共REST端点来获取/更改/添加标签给JIRA。

答案 1 :(得分:0)

Jira Cloud有/rest/api/3/label

Jira Server提供了/rest/api/2/jql/autocompletedata/suggestions?fieldName=labels,但是没有分页并且仅返回前几个标签(可以使用&fieldValue=X查询标签值)。

但是,由于存在变通办法,您可能会误用某些Atlassian Jira Gadget与之通信的API端点。尽管这样做有以下缺点:

  • 是内部API
  • Atlassian显然计划用仪表板项目eventually替换小工具
  • 可能会更改行为,请参见例如JRASERVER-67446
  • 没有分页(?),响应可能很大
  • 响应是为小工具设计的,因此包含不相关的数据

标签小工具

/rest/gadget/1.0/labels/gadget/project-<PROJECT_ID>/labels
其中<PROJECT_ID>是项目的数字ID。

热图小工具

/rest/gadget/1.0/heatmap/generate?projectOrFilterId=<PROJECT_OR_FILTER>&statType=labels
<PROJECT_OR_FILTER>可以是:

  • project-<PROJECT_ID>
  • filter-<FILTER_ID>