API 令牌是其他插件或第三方服务在调用本 API 时必需提供的安全令牌。

创建一个API令牌

进入 系统设置 > 管理应用  > API 令牌配置。

点击 “创建令牌”。


其中，有效期”以天为单位，只能输入整数 -1 ~ 1825（五年）, -1 表示令牌无期限。

使用API令牌调用接口的示例

① 约定、限制及假设

已安装 OrgWise 插件，并已生成API 令牌Token。令牌仅限于调用V3的API接口。

② 请求示例

接口功能

为指定部门添加直属成员。使用成员的ID代表成员，可以一次添加多个成员。

请求类型

GET

请求地址

{jira_base_url}/rest/orgwise/3/department/{id}/member/ids

媒体类型

application/json

请求头

Authorization: Bearer 0d0995d5-b85e-4546-a99c-bb8d5857733b

Body

{
  "members": "1, 4, 8"
}

③ 消息返回

正常消息返回参见：4.3 OrgWise REST API v3

认证失败：

{
  "code": "401",
  "msg": "无效的令牌"
}
  • No labels