Призначення й обмеження
«Видача даних API» задає, яку таблицю потоку отримує зовнішній споживач. Додайте блок із групи «API: приймання й видача даних» і виберіть REST API з напрямом «Видача даних потоку». На вхід під’єднайте потрібний результат: вихід перетворення, вибрану гілку маршрутизатора або дані, записані отримувачем.
Блок завершує гілку, не має виходів і не змінює значення таблиці. Один потік може містити лише один блок видачі. Одна точка належить одному опублікованому потоку; для іншої точки створіть окремий потік. Зайняті точки недоступні як нові вільні підключення.
Підключення та режим видачі
Адреса, версія API, формат JSON/JSON Lines/CSV/XML, відкритість і ліміт сторінки задаються в підключенні. Властивості блоку показують повну адресу та посилання на технічну документацію. Налаштування самого блоку визначають режим відповіді й параметри.
«Збережені результати останнього запуску» видає вже готову таблицю останнього завершеного Production. GET не виконує потік; свіжість забезпечує розклад чи інший запуск. «Запускати потік на кожен запит» запускає Production й очікує результат 1–120 секунд. Параметр повторного використання 0–3600 секунд дозволяє читати готовий результат однакового запиту. Нуль вимикає повторне використання завершених результатів.
Фільтри й параметри запуску
Додайте параметри API за потреби, до 20. Для кожного задайте назву, опис, призначення, поле чи параметр запуску, тип і обов’язковість. Назва починається з латинської літери, містить до 40 латинських літер, цифр або підкреслень; offset, limit, run зарезервовані.
Фільтр відбирає результат за текстом, числом або датою. Дозволені значення обмежують вибір; множинний вибір передається повтором імені в URL. Діапазон використовує суфікси _from та _to включно. Усі фільтри застосовуються до повного набору перед поділом на сторінки. Параметр запуску доступний лише у режимі запуску на запит і передає значення відповідному параметру потоку.
Публікація, доступ і перевірка
Збережіть і опублікуйте потік. Для збережених результатів виконайте перший запуск; без нього читати ще нічого. API-клієнту надайте «Читання», а для запуску на запит перевірте право власника запускати потік. Публічний доступ вмикається окремо в підключенні: тоді дані читаються без ключа, тому видавайте лише погоджений публічний набір.
Перевірте контрольний GET, кількість рядків після фільтрів і наступну сторінку. Якщо виконання триває, відповідь 202 містить next; запитуйте її після Retry-After, зберігаючи run.id. Невідомі параметри відхиляються. У разі 404 перевірте наявність завершеного результату; у разі 409 — стан публікації або актуальність даних. Детальні приклади наведено в налаштуванні видачі API.