Webhooks
Outgoing webhooks (Standard Webhooks signatures).
8 نقاط وصول. أسماء نقاط الوصول وأوصافها مأخوذة من ملف OpenAPI، لذلك تظهر بالإنجليزية.
GET /v1/webhooksPOST /v1/webhooksGET /v1/webhooks/{webhook_id}PATCH /v1/webhooks/{webhook_id}DELETE /v1/webhooks/{webhook_id}POST /v1/webhooks/{webhook_id}/rotate-secretPOST /v1/webhooks/{webhook_id}/testGET /v1/webhooks/{webhook_id}/deliveries
GET
/v1/webhooksWebhooks List
يحتاج إلى مفتاح أو جلسة في لوحة التحكم
الردود
- 200Successful Response
WebhookOut[]
POST
/v1/webhooksWebhooks Create
يحتاج إلى مفتاح أو جلسة في لوحة التحكم
المعاملات
| الاسم | الموضع | النوع | إلزامي | الوصف |
|---|---|---|---|---|
Idempotency-Key | header | string | null | لا | Unique per logical write (8-255 chars). Retries with the same key are safe. · pattern ^[A-Za-z0-9_\-:.]{8,255}$ |
جسم الطلب application/json WebhookIn
| الاسم | النوع | إلزامي | الوصف |
|---|---|---|---|
url | string | نعم | HTTPS only.max length 2048 · pattern ^https:// |
events | "search.zero_results_spike" | "catalog.sync_failed" | "catalog.import_finished" | "translation.batch_ready" | "usage.threshold_reached" | "experiment.finished" | "assistant.handover" | "billing.payment_failed" | "ping"[] | نعم | |
description | string | null | لا | max length 300 |
enabled | boolean | لا | default true |
الردود
- 201Successful Response
WebhookCreated
GET
/v1/webhooks/{webhook_id}Webhooks Get
يحتاج إلى مفتاح أو جلسة في لوحة التحكم
المعاملات
| الاسم | الموضع | النوع | إلزامي | الوصف |
|---|---|---|---|---|
webhook_id | path | string | نعم |
الردود
- 200Successful Response
WebhookOut
PATCH
/v1/webhooks/{webhook_id}Webhooks Update
يحتاج إلى مفتاح أو جلسة في لوحة التحكم
المعاملات
| الاسم | الموضع | النوع | إلزامي | الوصف |
|---|---|---|---|---|
webhook_id | path | string | نعم |
جسم الطلب application/json WebhookPatch
| الاسم | النوع | إلزامي | الوصف |
|---|---|---|---|
url | string | null | لا | max length 2048 · pattern ^https:// |
events | "search.zero_results_spike" | "catalog.sync_failed" | "catalog.import_finished" | "translation.batch_ready" | "usage.threshold_reached" | "experiment.finished" | "assistant.handover" | "billing.payment_failed" | "ping"[] | null | لا | |
description | string | null | لا | max length 300 |
enabled | boolean | null | لا |
الردود
- 200Successful Response
WebhookOut
DELETE
/v1/webhooks/{webhook_id}Webhooks Delete
يحتاج إلى مفتاح أو جلسة في لوحة التحكم
المعاملات
| الاسم | الموضع | النوع | إلزامي | الوصف |
|---|---|---|---|---|
webhook_id | path | string | نعم |
الردود
- 200Successful Response
Deleted
POST
/v1/webhooks/{webhook_id}/rotate-secretNew secret; deliveries are signed with old + new for 24 h
يحتاج إلى مفتاح أو جلسة في لوحة التحكم
المعاملات
| الاسم | الموضع | النوع | إلزامي | الوصف |
|---|---|---|---|---|
webhook_id | path | string | نعم |
الردود
- 200Successful Response
WebhookCreated
POST
/v1/webhooks/{webhook_id}/testSend a `ping` event now
يحتاج إلى مفتاح أو جلسة في لوحة التحكم
المعاملات
| الاسم | الموضع | النوع | إلزامي | الوصف |
|---|---|---|---|---|
webhook_id | path | string | نعم |
الردود
- 200Successful Response
WebhookDeliveryOut
GET
/v1/webhooks/{webhook_id}/deliveriesWebhooks Deliveries
يحتاج إلى مفتاح أو جلسة في لوحة التحكم
المعاملات
| الاسم | الموضع | النوع | إلزامي | الوصف |
|---|---|---|---|---|
webhook_id | path | string | نعم | |
cursor | query | string | null | لا | max length 200 |
limit | query | integer | لا | default 50 · min 1 · max 200 |
الردود
- 200Successful Response
Page_WebhookDeliveryOut_
أشكال البيانات في هذه الصفحة
WebhookOut
| الاسم | النوع | إلزامي | الوصف |
|---|---|---|---|
id | string | نعم | |
url | string | نعم | |
events | "search.zero_results_spike" | "catalog.sync_failed" | "catalog.import_finished" | "translation.batch_ready" | "usage.threshold_reached" | "experiment.finished" | "assistant.handover" | "billing.payment_failed" | "ping"[] | نعم | |
description | string | null | لا | |
enabled | boolean | نعم | |
failure_count | integer | لا | default 0 |
created_at | string (date-time) | نعم |
WebhookIn
| الاسم | النوع | إلزامي | الوصف |
|---|---|---|---|
url | string | نعم | HTTPS only.max length 2048 · pattern ^https:// |
events | "search.zero_results_spike" | "catalog.sync_failed" | "catalog.import_finished" | "translation.batch_ready" | "usage.threshold_reached" | "experiment.finished" | "assistant.handover" | "billing.payment_failed" | "ping"[] | نعم | |
description | string | null | لا | max length 300 |
enabled | boolean | لا | default true |
WebhookCreated
| الاسم | النوع | إلزامي | الوصف |
|---|---|---|---|
id | string | نعم | |
url | string | نعم | |
events | "search.zero_results_spike" | "catalog.sync_failed" | "catalog.import_finished" | "translation.batch_ready" | "usage.threshold_reached" | "experiment.finished" | "assistant.handover" | "billing.payment_failed" | "ping"[] | نعم | |
description | string | null | لا | |
enabled | boolean | نعم | |
failure_count | integer | لا | default 0 |
created_at | string (date-time) | نعم | |
secret | string | نعم | whsec_... Shown once. Verify deliveries with it (Standard Webhooks). |
WebhookPatch
| الاسم | النوع | إلزامي | الوصف |
|---|---|---|---|
url | string | null | لا | max length 2048 · pattern ^https:// |
events | "search.zero_results_spike" | "catalog.sync_failed" | "catalog.import_finished" | "translation.batch_ready" | "usage.threshold_reached" | "experiment.finished" | "assistant.handover" | "billing.payment_failed" | "ping"[] | null | لا | |
description | string | null | لا | max length 300 |
enabled | boolean | null | لا |
Deleted
| الاسم | النوع | إلزامي | الوصف |
|---|---|---|---|
deleted | boolean | لا | default true |
id | string | نعم |
WebhookDeliveryOut
| الاسم | النوع | إلزامي | الوصف |
|---|---|---|---|
id | string | نعم | |
event_id | string | نعم | |
event_type | string | نعم | |
status | "pending" | "succeeded" | "failed" | "dead" | نعم | |
attempt | integer | نعم | |
response_status | integer | null | لا | |
created_at | string (date-time) | نعم | |
delivered_at | string (date-time) | null | لا |
Page_WebhookDeliveryOut_
| الاسم | النوع | إلزامي | الوصف |
|---|---|---|---|
data | WebhookDeliveryOut[] | نعم | |
next_cursor | string | null | لا | |
total | integer | null | لا | Present when cheap to count. |