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