Призначення та місце в потоці
«Вхідні дані API» — початок гілки, що передає потоку таблицю прийнятого HTTP-запиту. Додайте блок із групи «API: приймання й видача даних» або з вкладки підключень. Виберіть REST API з напрямом «Приймання даних у Data Bridge». У межах одного потоку для однієї вхідної точки використовуйте один такий блок.
Вхідної таблиці блок не потребує. Його результат з’єднується з очищенням, перевірками, перетвореннями та отримувачами. Прийнята доставка запускає Production, а не відкриту чернетку. Якщо потік використовує кілька джерел, зв’яжіть їх за потрібними ключами вже після отримання таблиць.
Дані або файли
У режимі «Приймання даних» оберіть автоматичний формат за Content-Type або JSON, JSON Lines, CSV/TSV, XML. Для JSON за потреби задайте шлях до записів, наприклад data.items. Для CSV визначте роздільник і заголовки, для XML — шлях записів і читання атрибутів предків. Вкладені значення утворюють поля на кшталт customer.id.
У режимі «Приймання файлів» позначте дозволені XLSX/XLSM, CSV, TXT, JSON, XML, кількість файлів і спосіб читання. Для Excel укажіть аркуш та явний діапазон A1:Z10000; для JSON-файлу — JSON Pointer, наприклад /data/rows. Рядки всіх файлів одного запиту об’єднуються. За потреби додайте окрему колонку імені файлу, що не повторює назву поля даних.
Поля та політика помилок
Введіть мок, виберіть його власний формат і оновіть поля. Для кожного поля перевірте формат: текст, ціле, число, дата, дата й час, так/ні; позначте обов’язкові. Перевірка формату не перетворює значення: нормалізацію виконайте наступними блоками. Додайте до 20 унікальних ключів з одного чи кількох полів; вони перевіряють повтори лише всередині одного запиту.
Відсутнє оголошене поле можна відхилити або замінити порожнім. Для неправильних значень оберіть: відхилити весь запит із деталями, прийняти лише коректні рядки або відхилити весь запит зі стислими причинами. Часткове приймання потребує подальшої звірки відхилених рядків; коли правильних рядків немає, запит відхиляється.
Симуляція та робочий запуск
Мок використовується в перегляді, перевірці, симуляції й прикладах довідки. Його формат незалежний від формату запиту. У Production мок не підставляється. Для запуску без API-доставки виберіть порожню таблицю з оголошеними полями або зупинку; це захищає від випадкового використання тестових значень.
Перевірте правильний рядок, порожнє обов’язкове поле й повтор ключа. Після публікації надішліть контрольну доставку та звірте таблицю отримувача. «Технічна документація» відкриває контракт точки; «Запити API» в контекстному меню — її журнал. Повний порядок підключення, підпису та відстеження дивіться в налаштуванні приймання API.