POST/v1/webhooksプラン · Developer

Webhook作成

リクエストヘッダー · 1

認証ヘッダー。

Authorizationstring必須

本番用のAPIキー。次の形式で渡します: Bearer ax_live_…

リクエストボディ · 2

JSONリクエストボディのフィールド。

urlstring必須
eventsstring[]必須

返り値 · 200

標準の { data, meta } エンベロープ。 data は WebhookCreateOut 型です。

エンベロープ

dataWebhookCreateOut

単一の結果オブジェクト。

metaMeta

ページネーションとリクエストメタデータ。request_iddata_as_ofontology_version を含みます。

ontology_version 2.1.0replay meta.as_of · ?as_of=<token>

WebhookCreateOut

idinteger

Webhook ID。

urlstring

Webhook配信を受信するHTTPS URL。

eventsstring[]

購読しているイベントタイプ(例: ['new_filing', 'amendment'])。

activeboolean

Webhookが現在有効かどうか。

created_atstring

Webhookが作成された日時(ISO 8601)。

secretstring

HMAC-SHA256署名シークレット(64文字の16進数)。作成時に1度だけ返される。

エラー

標準のHTTPステータスコードに加え、{ error: { code, message } } エンベロープ内で型付きの error.code を返します。

すべてのエンドポイントは共通の型付きエラーエンベロープ({ error: { code, message } })を返します。 全コードの一覧はエラーリファレンスを参照してください。