Skip to main content
POST
モニターWebhookの検証

承認

pubrio-api-key
string
header
必須

API で実行する操作内容と、その操作に付与された権限を識別するための一意の API トークンです。このトークンはダッシュボードの 設定 画面から発行できます。

ボディ

application/json
destination_config
object
必須

配信先の設定。Webhookの場合:webhook_url(文字列)が必須、headers(オブジェクト)と body(オブジェクト)はオプション。メールの場合:email(文字列)または emails(文字列の配列)を指定できます。sequences タイプは sequence_identifier(文字列)に加えて、is_people_search_enrolled / is_company_contact_enrolled の少なくとも一方を true に設定する必要があります。

:
monitor_id
string<uuid>

テストする既存モニターの一意識別子。新しい設定のテスト時はオプションです。

name
string

モニターの名前。

description
string

モニターの説明。

detection_mode
enum<string>

シグナルの検出方法。signal_first は市場全体を広くスキャンし、company_first は指定した企業リストを追跡します(企業・ドメイン・LinkedIn URL のいずれかが 1 件以上必要)。作成後は変更できません — 既存モニターで変更すると 40021 が返ります。新しいモニターを作成してください。

利用可能なオプション:
company_first,
signal_first
signal_types
enum<string>[]

監視対象のシグナルタイプ。

利用可能なオプション:
jobs,
news,
advertisements,
expansions
signal_filters
object[]

シグナルフィルターオブジェクトの配列。各オブジェクトは signal_type(jobs、news、advertisements、expansions のいずれか)と filters(シグナル固有のパラメータを含むオブジェクト)で構成されます。シグナルタイプごとの利用可能なフィルターパラメータについては、Job SearchNews SearchAdvertisement Search を参照してください。expansions の場合は、Expansion Search のフィルター語彙(froms / tosstagesmomentumfreshnessscopessignal_typessignal_strengthswindow_days)を使用します。

:
company_filters
object

グローバル企業フィルター。Company Searchエンドポイントと同じパラメータを受け付けます。

:
companies
string<uuid>[]

監視対象の企業 domain_search_id UUID のリスト。代替: domains または linkedin_urls を使用。

domains
string[]

企業ドメインリスト。companies の代替。

linkedin_urls
string<uri>[]

LinkedInの企業ページURLリスト。companies の代替。

is_company_enrichment
boolean

企業データをエンリッチメントするかどうか。

is_people_enrichment
boolean

人物データをエンリッチメントするかどうか。

people_enrichment_configs
object[]

人物エンリッチメントレイヤーの配列。max_people_to_return(1-25)、people_contact_typesRedeem を参照)、filtersPeople Search を参照)を含みます。

:
destination_type
enum<string>

配信先タイプ。

利用可能なオプション:
webhook,
email,
sequences
frequency_minute
integer

トリガー頻度(分単位)。最小:0、最大:10080。

必須範囲: 0 <= x <= 10080
max_failure_trigger
integer

一時停止前の最大連続失敗数。最小:1、最大:10。

必須範囲: 1 <= x <= 10
max_daily_trigger
integer

1日あたりの最大トリガー数。最小:0、最大:86400。

必須範囲: 0 <= x <= 86400
max_records_per_trigger
integer

トリガーごとに配信される最大レコード数を制御します。値を低く設定すると1回あたりのペイロードサイズが削減され、大量の結果セットやレート制限のある統合に推奨されます。最小値:1、最大値:100、デフォルト:25。詳細については Webhook の設定 をご覧ください。

必須範囲: 1 <= x <= 100
notification_email
string<email>

失敗通知用のメールアドレス。

max_retry_per_trigger
integer

トリガーあたりの最大リトライ回数。最小:0、最大:3。

必須範囲: 0 <= x <= 3
retry_delay_second
integer

リトライ間の遅延(秒単位)。最小:1、最大:5。

必須範囲: 1 <= x <= 5

レスポンス

配信先の設定およびテストリクエスト/レスポンスペイロードを含むWebhookバリデーション結果の成功レスポンスです。Webhookが失敗した場合、このエンドポイントは 400(MONITOR_WEBHOOK_URL_INVALID)を返し、エラー詳細に Webhook のレスポンスが含まれます。

data
object