Webhook экспорт

Webhook - это HTTP вызов, осуществляемый сервисом IO по окончании работы диггера. В процессе этого вызова собранные данные будут переданы на предоставленный Webhook URL с теми параметрами, которые указаны при настройке экспортного конфига.

Для настройки Webhook экспорта выберите соответствующий конфиг в списке и нажмите кнопку - Добавить.

Давайте более подробно рассмотрим варианты настройки Webhook экспорта.

Послать данные как: Dataset

  1. Имя экспортного конфига.
  2. URL на webhook endpoint вашего сервиса.
  3. HTTP метод запроса.
  4. Тип контента.
  5. Послать данные как (Dataset).
  6. Формат вывода данных (CSV).
  7. Показ/сокрытие корневого элемента.
  8. Разделитель столбцов формата CSV.
  9. Описание порядка следования полей в выгрузке.
  10. Добавление полей в заголовок запроса.
  11. Сохранить конфиг.
  12. Удалить конфиг.
  13. Дополнительная информация.
  14. Признак внесенного в конфиг изменения.

Имя экспортного конфига - вы можете использовать любое, удобное для вас имя экспортного конфига (поле обязательное).

Webhook URL - линк на точку приема (endpoint) вашей платформы для запросов со стороны нашего сервиса IO (поле обязательное).

HTTP метод запроса - методы HTTP запроса POST, PUT, PATCH. Более подробно о методах вы можете ознакомиться пройдя по этому линку.

Послать данные как (Dataset / Шаблон) - определяет способ отправки данных.

Тип контента - список доступных типов MIME.

Формат вывода данных - определяет в каком виде буду переданы данные. В настоящий момент доступны: CSV, JSON/NDJSON, HTML. Каждый формат имеет свой набор параметров.

Показ/сокрытие корневого элемента - если выходной датасет имеет корневой элемент, то здесь вы можете включить или выключить его отображение в выгружаемых через линк данных.

Разделитель столбцов формата CSV - набор стандарных сепараторов для формата CSV, позволяющие отделять столбцы друг от друга.

Описание порядка следования полей в выгрузке - здесь вы можете описать порядок полей, который вам необходим в выходных данных или оставить это поле пустым, в этом случае в выходных данных будут перечислены все доступные поля в алфавитном порядке. Более подробно о правилах описания вы можете прочитать в этом разделе.

Добавление полей в заголовок запроса - с помощью этой опции вы можете добавить дополнительные параметры в заголовок HTTP запроса.

Послать данные как: Шаблон

  1. Метод запроса.
  2. Тип контента.
  3. Послать данные как (Шаблон).
  4. Редактор шаблона выгрузки.

Редактор шаблона выгрузки - позволяет настроить необходимую структуру данных. Более подробно о шаблоне можно прочитать в этом разделе.

В следующем разделе мы рассмотрим вариант экспортного конфига - Spreadsheet.