Новое событие источника

POST

POST на адрес вебхука на каждое новое событие источника, на который он подписан; повторная отправка, история, удалённое и пустое событие запроса не шлют. Заголовки: X-Goodwink-Event (тип), X-Goodwink-Delivery (номер доставки), X-Goodwink-Signature: t=,v1=<hex HMAC-SHA256(секрет, t + ‘.’ + тело)>. Ответ 2xx — доставлено; иначе повтор с растущим интервалом до суток. Гарантия — хотя бы один раз: доставка с тем же id может прийти повторно.

Authorizations

• bearer
• apiKey

Request Body

Media typeapplication/json

object

id

required

Номер доставки — повтор приходит с тем же

integer

type

required

string

Allowed values: event.received ping

created_at

required

RFC 3339 в UTC, например 2026-10-19T13:30:00Z

string format: date-time

source

required

One of:

object

object

id

required

integer

name

required

string

null

null

data

required

One of:

object

object

id

required

integer

source

required

object

id

required

integer

name

required

string

channel

required

Адрес приёма, загрузка файла, опрос по адресу

string

Allowed values: webhook file pull

received_at

required

RFC 3339 в UTC, например 2026-10-19T13:30:00Z

string format: date-time

payload

required

Тело события, как разобрал приём: объект — поля события; тело, которое не разобралось, — служебными ключами _raw (текст), _value (JSON не объект), _parse_error (причина)

repeat_of

required

Повторная отправка: id первого события с тем же телом

integer | null

history

required

Из истории: загрузка файла и первый запуск опроса

boolean

deleted_at

required

Строку события удалили (корзина)

string | null format: date-time

null

null

Responses

200

Любой 2xx — доставлено