# 说明
计算符合查询条件的Webhook配置数量并返回
# url
https://apiv2.tapd.tencent.com/webhook_settings/count
# 支持格式
JSON/XML(默认JSON格式)
# HTTP请求方式
GET
# 请求数限制
只返回Webhook配置数量
# 请求参数
字段名 | 必选 | 类型及范围 | 说明 | 特殊规则 |
---|---|---|---|---|
id | 否 | integer | id | 支持多ID查询 |
workspace_id | 是 | integer | 项目ID | |
url | 否 | string | 接收 Webhook 请求的URL | |
content_type | 否 | enum('json','form') | 数据格式。取 json 或者 form,默认 json | |
secret | 否 | string | 验证密码(非必选,给接入方验证请求是否来自 TAPD) | |
owner | 否 | string | 配置负责人理人 | |
events | 否 | string | 事件。取值见页尾 | 支持模糊匹配 |
status | 否 | enum('closed','normal') | 配置状态 | |
creator | 否 | string | 配置创建人。取 API 帐号 | |
created | 否 | datetime | 创建时间 | 支持时间查询 |
modifier | 否 | string | 配置最后人。取 API 帐号 | |
modified | 否 | datetime | 最后修改时间 | 支持时间查询 |
# 调用示例及返回结果
# 获取项目下的Webhook配置数量
# curl 使用 Basic Auth 鉴权调用示例
curl -u 'api_user:api_password' 'https://apiv2.tapd.tencent.com/webhook_settings/count?workspace_id=10158231'
# curl 使用 OAuth Access Token 鉴权调用示例
curl -H 'Authorization: Bearer ACCESS_TOKEN' 'https://apiv2.tapd.tencent.com/webhook_settings/count?workspace_id=10158231'
# 返回结果
{
"status": 1,
"data": {
"count": 3
},
"info": "success"
}
1
2
3
4
5
6
7
2
3
4
5
6
7
# Webhook配置数据格式(content_type)取值字段说明
取值 | 字面值 |
---|---|
json | json 格式,默认格式 |
form | 即 application/x-www-form-urlencoded 形式 ,如 key1=value1&key2=value2 |
# Webhook配置事件(events)取值字段说明,可写多个,使用 , 分隔
取值 | 字面值 |
---|---|
launchform::create | 发布评审创建 |
launchform::update | 发布评审更新 |
bug::create | 缺陷创建 |
bug::update | 缺陷更新 |
bug::delete | 缺陷删除 |
story::create | 需求创建 |
story::update | 需求更新 |
story::delete | 需求删除 |
task::create | 任务创建 |
task::update | 任务更新 |
task::delete | 任务删除 |
release::create | 发布计划创建 |
release::update | 发布计划更新 |
release::delete | 发布计划删除 |
branch::relate | 需求缺陷任务绑定Git分支 |
branch::unrelate | 需求缺陷任务解除绑定Git分支 |
story_comment::add | 需求评论添加 |
story_comment::update | 需求评论更新 |
story_comment::delete | 需求评论删除 |
bug_comment::add | 缺陷评论添加 |
bug_comment::update | 缺陷评论更新 |
bug_comment::delete | 缺陷评论删除 |
task_comment::add | 任务评论添加 |
task_comment::update | 任务评论更新 |
task_comment::delete | 任务评论删除 |
workitem_time_relation::bind | 前后置对象绑定 |
workitem_time_relation::unbind | 前后置对象解绑 |