流水线消息通知根据类型查询详情 - GetPipelineMessageNoticeByType
功能介绍
根据消息通知类型,查询流水线具体通知配置详情
调用方法
请参见如何调用API。
URI
GET /v5/{project_id}/api/pipeline-notices/{pipeline_id}/notice/detail
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
project_id | 是 | String | 参数解释: 项目ID,获取方式请参见获取项目ID。 约束限制: 不涉及。 取值范围: 32位字符,由数字和字母组成。 默认取值: 不涉及。 |
pipeline_id | 是 | String | 参数解释: 流水线ID,可以通过查询流水线列表接口获取,其中pipelines.pipelineId即为流水线ID。 约束限制: 不涉及。 取值范围: 32位字符,由数字和字母组成。 默认取值: 不涉及。 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
type | 是 | Integer | 参数解释: 流水线消息通知类型。 约束限制: 不涉及。 取值范围:
默认取值: 不涉及。 |
请求参数
无
响应参数
状态码:200
参数 | 参数类型 | 描述 |
|---|---|---|
type | Integer | 参数解释: 流水线消息通知类型。 约束限制: 不涉及。 取值范围:
默认取值: 不涉及。 |
events | Array of EventStatusDTO objects | 参数解释: 第三方通知事件配置。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
webhook_config | ThirdPartEventDTO object | 参数解释: 第三方通知事件配置。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
参数 | 参数类型 | 描述 |
|---|---|---|
id | String | 参数解释: 事件类型。 约束限制: 不涉及。 取值范围:
默认取值: 不涉及。 |
selected | Boolean | 参数解释: 是否启用事件通知。 约束限制: 不涉及。 取值范围:
默认取值: 不涉及。 |
name | String | 参数解释: 通知事件名称。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
english_name | String | 参数解释: 通知事件英文名称。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
resource_role_receivers | Array of strings | 参数解释: 通知对象列表。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
参数 | 参数类型 | 描述 |
|---|---|---|
notice_id | String | 参数解释: 第三方通知配置ID,第三方通知的唯一标识。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
url | String | 参数解释: 第三方通知URL地址,由对应第三方平台获取。 约束限制: URL地址只能以http://或者https://开头。 取值范围: 不涉及。 默认取值: 不涉及。 |
events | Array of strings | 参数解释: 流水线事件类型。 约束限制: 不涉及。 取值范围:
默认取值: 不涉及。 |
options | Array of strings | 参数解释: 通知内容列表。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
mentioned_list | Array of strings | 参数解释: 第三方user_id列表,通过user_id使用半角逗号(,)分隔组成。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
mentioned_mobile_list | Array of strings | 参数解释: 手机号列表。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
secret_info | String | 参数解释: 加签密钥。 约束限制: 钉钉、飞书自定义机器人可以开启安全设置,若未使用加签,无需填写加签秘钥。 取值范围: 不涉及。 默认取值: 不涉及。 |
状态码:400
参数 | 参数类型 | 描述 |
|---|---|---|
error_msg | String | 参数解释: 错误信息。 取值范围: 不涉及。 |
error_code | String | 参数解释: 错误码。 取值范围: 不涉及。 |
请求示例
GET https://(endpoint)/v5/e2e18230a85d4d6ab0b56cb6d2246c18/api/pipeline-notices/0747d5a7099e45f69dc1d099945909a9/notice/detail
响应示例
状态码:200
OK
{
"events" : [ {
"id" : "pipeline.updated",
"name" : null,
"selected" : false,
"english_name" : null,
"resource_role_receivers" : null
}, {
"id" : "pipeline.deleted",
"name" : null,
"selected" : false,
"english_name" : null,
"resource_role_receivers" : null
}, {
"id" : "pipelineRun.succeed",
"name" : null,
"selected" : false,
"english_name" : null,
"resource_role_receivers" : null
}, {
"id" : "pipelineRun.failed",
"name" : null,
"selected" : false,
"english_name" : null,
"resource_role_receivers" : null
} ],
"webhook_config" : null
} 状态码
状态码 | 描述 |
|---|---|
200 | OK |
400 | Bad request |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
错误码
请参见错误码。

