# 说明

计算符合查询条件的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

# 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 前后置对象解绑
上次更新: 2025-04-17 19:58:41