Получить вебхук

Заголовки ответа

• RateLimit-Policy

  Действующие лимиты в формате черновика IETF draft-ietf-httpapi-ratelimit-headers: элементы через запятую "<name>";q=<quota>;w=<window in seconds>. key — частота запросов ключа API (квота — допустимый всплеск, окно — время до полного восстановления; для сессии это user, без учётных данных — ip); minute, day и month — квоты организации на календарную минуту, день и месяц по UTC.

• RateLimit

  Сколько осталось по каждому лимиту из RateLimit-Policy: "<name>";r=<remaining>;t=<seconds until reset>.

• X-RateLimit-Limit

  Лимит самой строгой записи в RateLimit-Policy (той, где осталось меньше всего запросов).

• X-RateLimit-Remaining

  Сколько запросов осталось в пределах самого строгого лимита.

• X-RateLimit-Reset

  Через сколько секунд сбросится самый строгий лимит.

application/json

Объект: WebhookEndpoint

• idintegerобязательно
• urlstringобязательно
• descriptionstringобязательно
• eventsarray of WebhookEventFilterобязательно
• activebooleanобязательно
• statusWebhookStatusобязательно
• paused_atstring (date-time) | null
• paused_reasonstring | null

  failures — 10 неудачных попыток подряд; feature_disabled — тариф не включает вебхуки.

• disabled_reasonstring | null

  gone — получатель ответил 410; manual — отключён администратором.

  Допустимые значения: gonemanualnull

• disabled_atstring (date-time) | null
• roleWebhookRoleобязательно
• data_profile_idinteger | null

  Профиль доступа вебхука (null — без профиля, как у ключа API с той же ролью).

• collection_idsarray of integerобязательно

  Коллекции, о которых вебхук получает события; пусто — все коллекции, доступные роли и профилю доступа.

• tagsarray of stringобязательно

  События карточек — только по карточкам с любым из этих тегов; пусто — без фильтра.

• payloadWebhookPayloadModeобязательно
• headersarray of WebhookHeaderобязательно
• auth_typestring | null

  Тип авторизации исходящих запросов (null — нет).

  Допустимые значения: bearerbasicnull

• auth_setbooleanобязательно

  Задана ли авторизация исходящих запросов (значения никогда не возвращаются).

• previous_secret_valid_untilstring (date-time) | null

  До какого момента доставки подписываются ещё и прежним секретом (null — перекрытия нет).

• healthWebhookHealth
• consecutive_failuresintegerобязательно
• last_delivery_atstring (date-time) | null
• last_success_atstring (date-time) | null
• last_errorstring | null
• created_byinteger | null
• created_by_namestring | null
• created_atstring (date-time)обязательно
• updated_atstring (date-time)обязательно

Заголовки ответа

• RateLimit-Policy

  Действующие лимиты в формате черновика IETF draft-ietf-httpapi-ratelimit-headers: элементы через запятую "<name>";q=<quota>;w=<window in seconds>. key — частота запросов ключа API (квота — допустимый всплеск, окно — время до полного восстановления; для сессии это user, без учётных данных — ip); minute, day и month — квоты организации на календарную минуту, день и месяц по UTC.

• RateLimit

  Сколько осталось по каждому лимиту из RateLimit-Policy: "<name>";r=<remaining>;t=<seconds until reset>.

• X-RateLimit-Limit

  Лимит самой строгой записи в RateLimit-Policy (той, где осталось меньше всего запросов).

• X-RateLimit-Remaining

  Сколько запросов осталось в пределах самого строгого лимита.

• X-RateLimit-Reset

  Через сколько секунд сбросится самый строгий лимит.

application/json

Объект: Error

Заголовки ответа

• RateLimit-Policy

  Действующие лимиты в формате черновика IETF draft-ietf-httpapi-ratelimit-headers: элементы через запятую "<name>";q=<quota>;w=<window in seconds>. key — частота запросов ключа API (квота — допустимый всплеск, окно — время до полного восстановления; для сессии это user, без учётных данных — ip); minute, day и month — квоты организации на календарную минуту, день и месяц по UTC.

• RateLimit

  Сколько осталось по каждому лимиту из RateLimit-Policy: "<name>";r=<remaining>;t=<seconds until reset>.

• X-RateLimit-Limit

  Лимит самой строгой записи в RateLimit-Policy (той, где осталось меньше всего запросов).

• X-RateLimit-Remaining

  Сколько запросов осталось в пределах самого строгого лимита.

• X-RateLimit-Reset

  Через сколько секунд сбросится самый строгий лимит.

application/json

Объект: Error

Заголовки ответа

• RateLimit-Policy

  Действующие лимиты в формате черновика IETF draft-ietf-httpapi-ratelimit-headers: элементы через запятую "<name>";q=<quota>;w=<window in seconds>. key — частота запросов ключа API (квота — допустимый всплеск, окно — время до полного восстановления; для сессии это user, без учётных данных — ip); minute, day и month — квоты организации на календарную минуту, день и месяц по UTC.

• RateLimit

  Сколько осталось по каждому лимиту из RateLimit-Policy: "<name>";r=<remaining>;t=<seconds until reset>.

• X-RateLimit-Limit

  Лимит самой строгой записи в RateLimit-Policy (той, где осталось меньше всего запросов).

• X-RateLimit-Remaining

  Сколько запросов осталось в пределах самого строгого лимита.

• X-RateLimit-Reset

  Через сколько секунд сбросится самый строгий лимит.

application/json

Объект: Error

Заголовки ответа

• Retry-After

  Сколько секунд подождать перед повтором запроса.

• RateLimit-Policy

  Действующие лимиты в формате черновика IETF draft-ietf-httpapi-ratelimit-headers: элементы через запятую "<name>";q=<quota>;w=<window in seconds>. key — частота запросов ключа API (квота — допустимый всплеск, окно — время до полного восстановления; для сессии это user, без учётных данных — ip); minute, day и month — квоты организации на календарную минуту, день и месяц по UTC.

• RateLimit

  Сколько осталось по каждому лимиту из RateLimit-Policy: "<name>";r=<remaining>;t=<seconds until reset>.

• X-RateLimit-Limit

  Лимит самой строгой записи в RateLimit-Policy (той, где осталось меньше всего запросов).

• X-RateLimit-Remaining

  Сколько запросов осталось в пределах самого строгого лимита.

• X-RateLimit-Reset

  Через сколько секунд сбросится самый строгий лимит.

application/json

Объект: Error