Справочник API

Вебхуки

Адреса доставки событий, секреты подписи и история доставок.

Список вебхуков

GET/v1/webhooks

Области доступа
webhooks:read

Параметры

ПолеТипОбязательно
cursorзапросstringнет
limitзапросintegerнет

Ответы

  • 200WebhookList
  • 400
  • 401
  • 403
  • 404
  • 409
  • 412
  • 413
  • 415
  • 422
  • 428
  • 429
  • 503

Создать вебхук

POST/v1/webhooks

Области доступа
webhooks:write
Обязательный заголовок
Idempotency-Key

Тело запросаWebhookCreate

ПолеТипОбязательно
urlstring (uri)да
event_typesarray of stringда
descriptionstringнет

Ответы

  • 201Webhook
  • 400
  • 401
  • 403
  • 404
  • 409
  • 412
  • 413
  • 415
  • 422
  • 428
  • 429
  • 503

Изменить вебхук

PATCH/v1/webhooks/{webhook_id}

Области доступа
webhooks:write
Обязательный заголовок
If-Match

Параметры

ПолеТипОбязательно
webhook_idпутьstring (uuid)да

Тело запросаWebhookUpdate

ПолеТипОбязательно
urlstring (uri)нет
event_typesarray of stringнет
statusenum: disabled, activeнет

Ответы

  • 200Webhook
  • 400
  • 401
  • 403
  • 404
  • 409
  • 412
  • 413
  • 415
  • 422
  • 428
  • 429
  • 503

Удалить вебхук

DELETE/v1/webhooks/{webhook_id}

Области доступа
webhooks:write
Обязательный заголовок
If-Match

Параметры

ПолеТипОбязательно
webhook_idпутьstring (uuid)да

Ответы

  • 204
  • 400
  • 401
  • 403
  • 404
  • 409
  • 412
  • 413
  • 415
  • 422
  • 428
  • 429
  • 503

Тестовое событие

POST/v1/webhooks/{webhook_id}/test

Области доступа
webhooks:write
Обязательный заголовок
Idempotency-Key

Параметры

ПолеТипОбязательно
webhook_idпутьstring (uuid)да

Ответы

  • 202Delivery
  • 400
  • 401
  • 403
  • 404
  • 409
  • 412
  • 413
  • 415
  • 422
  • 428
  • 429
  • 503

Сменить секрет подписи

POST/v1/webhooks/{webhook_id}/rotate-secret

Области доступа
webhooks:write
Обязательный заголовок
Idempotency-Key

Параметры

ПолеТипОбязательно
webhook_idпутьstring (uuid)да

Тело запросаReasonAction

ПолеТипОбязательно
reason_codestringда
notestringнет

Ответы

  • 200SecretIssued
  • 400
  • 401
  • 403
  • 404
  • 409
  • 412
  • 413
  • 415
  • 422
  • 428
  • 429
  • 503

Доставки вебхука

GET/v1/webhooks/{webhook_id}/deliveries

Области доступа
webhooks:read

Параметры

ПолеТипОбязательно
webhook_idпутьstring (uuid)да
cursorзапросstringнет
limitзапросintegerнет

Ответы

  • 200DeliveryList
  • 400
  • 401
  • 403
  • 404
  • 409
  • 412
  • 413
  • 415
  • 422
  • 428
  • 429
  • 503