ListWebHooks - 查询 Webhook 列表

通过OpenAPI查询WebHook列表。

适用版本

标准版

服务接入点与授权信息

  • 获取服务接入点,替换 API 请求语法中的 <domain> :服务接入点(domain)

  • 获取个人访问令牌,具体操作,请参见获取个人访问令牌

  • 获取organizationId,请前往组织管理后台基本信息页面获取组织 ID 。

产品

资源

所需权限

代码管理

WebHook

只读

请求语法

GET https://{domain}/oapi/v1/codeup/organizations/{organizationId}/repositories/{repositoryId}/webhooks

请求头

参数

类型

是否必填

描述

示例值

x-yunxiao-token

string

个人访问令牌。

pt-0fh3****0fbG_35af****0484

请求参数

参数

类型

位置

是否必填

描述

示例值

organizationId

string

path

组织 ID。

60de7a6852743a5162b5f957

repositoryId

string

path

代码库 ID 或者 URL-Encoder 编码的全路径。

2835387

page

integer

query

页码,默认从1开始,一般不要超过150页。

1

perPage

integer

query

每页大小,默认20,取值范围【1,100】。

20

请求示例

curl -X 'GET' \
  'https://test.rdc.aliyuncs.com/oapi/v1/codeup/organizations/{organizationId}/repositories/{repositoryId}/webhooks?page=<page>&perPage=<perPage>' \
  -H 'Content-Type: application/json' \
  -H 'x-yunxiao-token: pt-0fh3****0fbG_35af****0484'

返回参数

参数

类型

描述

示例值

-

object

createdAt

string

创建时间。

2023-01-03T15:41:26+08:00

description

string

Webhook 描述信息。

""

enableSSLVerification

boolean

是否开启 SSL 认证。

false

id

integer

Webhook 主键 ID。

524836

mergeRequestsEvents

boolean

合并请求事件。

true

noteEvents

boolean

评论事件。

true

pushEvents

boolean

代码推送事件。

true

repositoryId

integer

代码库 ID。

2825387

tagPushEvents

boolean

标签推送事件。

true

token

string

用于验证身份的 token,用户自定义。

f0b1e61db5961df5975a93f9129d2513

updatedAt

string

更新时间。

2023-01-03T15:41:26+08:00

url

string

Webhook 链接。

https://xxxxx

返回示例

{
    "createdAt": "2023-01-03T15:41:26+08:00",
    "description": "",
    "enableSSLVerification": false,
    "id": 524836,
    "mergeRequestsEvents": true,
    "noteEvents": true,
    "pushEvents": true,
    "repositoryId": 2825387,
    "tagPushEvents": true,
    "token": "f0b1e61db5961df5975a93f9129d2513",
    "updatedAt": "2023-01-03T15:41:26+08:00",
    "url": "https://xxxxx"
}

响应头

参数

描述

示例值

x-next-page

下一页。

2

x-page

当前页。

1

x-per-page

每页大小。

20

x-prev-page

前一页。

0

x-request-id

请求 ID。

37294673-00CA-5B8B-914F-A8B35511E90A

x-total

总数。

10

x-total-pages

总分页数。

1

错误码

访问错误码中心查看 API 相关错误码。