> ## Documentation Index > Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt > Use this file to discover all available pages before exploring further. # 监控验证Webhook > 验证监控的 Webhook 端点配置。 ## OpenAPI ````yaml cn-openapi POST /monitors/webhook/validate openapi: 3.0.0 info: description: >- Pubrio API 提供市场扩张情报——实时捕捉企业进入新市场的信号，以及其底层的公司与人员数据。可搜索、查找并丰富账户与联系人信息，并订阅覆盖 200+ 市场、带类型与日期的动向信号。 version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/zh-CN/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/zh-CN/get-in-touch license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://api.pubrio.com security: - pubrio_api_key: [] tags: - name: Profile description: 工作区配置信息和使用统计 - name: Enrichment description: 通过详细的 B2B 数据丰富人员和公司记录 - name: Lookalike description: 查找与指定公司相似的公司 - name: Search description: 使用筛选条件搜索人员、公司、职位、新闻和广告 - name: Lookup description: 查找特定人员、公司、职位、新闻、广告和技术的详细信息 - name: LinkedIn description: 通过 LinkedIn 个人资料 URL 查找人员和公司数据 - name: Redeem description: 兑换积分以解锁人员联系方式（单个和批量） - name: Channels description: 管理外展渠道模板（创建、更新、删除、列表） - name: Monitor description: 创建和管理数据监控，包括 Webhook、统计和处理 - name: Filters description: 获取搜索参数的可用筛选值（技术、地点、垂直领域等） - name: API Keys description: 查看 API 密钥的请求日志和使用情况分析 - name: Insights description: 公司的信号聚合洞察(招聘、新闻、广告)。 - name: Export description: 批量数据导出(消耗积分)。 - name: Expansion description: 公司市场扩张情报:信号、阶段、市场与导出。 externalDocs: description: Pubrio API 用于搜索、预览和增强联系人及账户信息。Pubrio 数据库提供丰富的 B2B 联系人和销售情报数据。 url: https://docs.pubrio.com paths: /monitors/webhook/validate: post: tags: - Monitor summary: 验证监控 Webhook description: 验证监控的 Webhook 端点配置。 operationId: monitors_validate_webhook parameters: [] requestBody: required: true content: application/json: schema: type: object properties: monitor_id: type: string format: uuid description: 现有监控的唯一标识符（用于测试）。测试新配置时为可选。 name: type: string description: 监控名称。 description: type: string description: 监控描述。 detection_mode: type: string description: 检测模式。 enum: - company_first - signal_first signal_types: type: array items: type: string enum: - jobs - news - advertisements description: 要监控的信号类型。 signal_filters: type: array items: type: object description: >- 信号过滤器对象数组。每个对象包含 `signal_type` 和 `filters`。请参见 [Job Search](/cn/api-reference/endpoint/companies/job_search)、[News Search](/cn/api-reference/endpoint/companies/news_search) 或 [Advertisement Search](/cn/api-reference/endpoint/companies/advertisements_search) 了解过滤器参数。 example: - filters: locations: - US signal_type: jobs - filters: locations: - US signal_type: news - filters: target_locations: - US signal_type: advertisements company_filters: type: object description: >- 全局公司过滤器。接受与[Company Search](/cn/api-reference/endpoint/companies/search)端点相同的参数。 example: locations: - US employees: - - 501 - 1000 - - 1001 - 5000 companies: type: array items: type: string format: uuid description: >- 要监控的公司 domain_search_id UUID 列表。也可使用 `domains` 或 `linkedin_urls` 作为替代方式。 domains: type: array items: type: string description: 公司域名列表。`companies` 的替代方式。 linkedin_urls: type: array items: type: string format: uri description: LinkedIn 公司网址列表。`companies` 的替代方式。 is_company_enrichment: type: boolean description: 是否增强公司数据。 is_people_enrichment: type: boolean description: 是否增强人员数据。 people_enrichment_configs: type: array items: type: object description: >- 人员增强层数组。包含 `max_people_to_return`（1-25）、`people_contact_types`（参见 [Redeem](/cn/api-reference/endpoint/redeem/people)）和 `filters`（参见 [People Search](/cn/api-reference/endpoint/people/search)）。 example: - filters: people_locations: - US max_people_to_return: 3 people_contact_types: - email-work destination_type: type: string description: 投递目标类型。 enum: - webhook - email - sequences destination_config: type: object description: >- 目标配置。Webhook：需要 `webhook_url`（字符串），可选 `headers`（对象）和 `body`（对象）。Email：需要 `email`（字符串）。sequences 类型需要 `sequence_identifier`（字符串）和 `record_type`（字符串）。 example: webhook_url: https://your-webhook.com/endpoint headers: Authorization: Bearer token body: pipeline: my-webhook frequency_minute: type: integer description: 触发频率（分钟）。最小值：0，最大值：10080。 minimum: 0 maximum: 10080 max_failure_trigger: type: integer description: 暂停前的最大连续失败次数。最小值：1，最大值：10。 minimum: 1 maximum: 10 max_daily_trigger: type: integer description: 每日最大触发次数。最小值：0，最大值：86400。 minimum: 0 maximum: 86400 max_records_per_trigger: type: integer description: >- 控制每次触发最多推送的记录数量。较低的值可减少每次推送的数据量，适用于结果集较大或下游系统有速率限制的场景。最小值：1，最大值：100，默认值：25。详情请参阅 [配置 Webhooks](/cn/developer-guides/setting-up-webhooks)。 minimum: 1 maximum: 100 notification_email: type: string format: email description: 失败通知邮箱。 max_retry_per_trigger: type: integer description: 每次触发的最大重试次数。最小值：0，最大值：3。 minimum: 0 maximum: 3 retry_delay_second: type: integer description: 重试间隔（秒）。最小值：1，最大值：5。 minimum: 1 maximum: 5 profile_id: $ref: '#/components/schemas/profile_id' required: - destination_type - destination_config responses: '200': description: 成功响应，包含 webhook 验证结果，包括目标配置和测试请求/响应负载。 content: application/json: schema: type: object properties: data: type: object properties: destination_config: type: object description: 被测试的目标配置。 request_payload: type: object description: 验证期间发送到 webhook 的请求负载。 response_payload: type: object description: 从 webhook 接收到的响应负载。 response_status_code: type: integer description: webhook 返回的 HTTP 状态码。 is_success: type: boolean description: webhook 验证是否成功。 example: data: destination_config: webhook_url: https://usewebhook.com/example headers: X-Custom-Auth: your-token body: source: pubrio request_payload: monitor: monitor_id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 name: My Monitor detection_mode: signal_first signal_types: - jobs - news - advertisements signal_filters: - ... company_filters: ...: ... is_company_enrichment: true is_people_enrichment: true people_enrichment_configs: - ... metadata: total_signals: 3 total_companies: 1 total_people: 0 triggered_at: '2026-04-05T22:43:06.973Z' signals: - signal_type: jobs signal: signal_type: jobs job_search_id: ... companies: - ... companies: - ... - ... source: pubrio response_payload: OK '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: profile_id: type: integer description: >- 可选。发起请求的团队标识符。由于 API 密钥已包含您的工作区信息，此参数不再是必填项。如果提供，该 ID 有助于将查找与特定团队（工作区）关联，实现数据检索和额度追踪。 更多信息请参见团队标签下的 `user details` 端点。 responses: general_error: description: 请求错误。请求格式不正确或包含无效参数。请检查错误代码和消息以获取详细信息。 content: application/json: schema: required: - code - message - details type: object properties: code: example: 40001 type: integer message: example: 错误及代码会根据不同场景有所不同，详情请参阅文档。 type: string details: type: object rate_limit_error: description: 超出速率限制。在给定时间段内发送了过多请求。请在速率限制窗口重置后重试。 content: application/json: schema: required: - error type: object properties: error: example: 请求频率超出限制。请稍后再试。 type: string server_error: description: 内部服务器错误。服务器发生意外错误。如果错误持续存在，请联系支持团队。 content: application/json: schema: required: - error type: object properties: error: example: 服务器在处理请求时遇到了未预料的异常。 type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- 一个唯一的 API 令牌，用于标识您通过 API 执行的操作以及相应的权限和操作。您可以在 [设置](https://dashboard.pubrio.com/#/settings/) 部分创建该令牌。 in: header ````