Ответ

Блок "Ответ" форматирует и отправляет структурированные HTTP-ответы обратно к вызывающим API. Используйте его для возврата результатов воркфлоу с правильными кодами состояния и заголовками.

Параметры конфигурации

Данные ответа

Данные ответа — это основной контент, который будет отправлен обратно к вызывающему API. Это должно быть отформатировано как JSON и может включать:

• Статические значения
• Динамические ссылки на переменные воркфлоу с использованием синтаксиса <variable.name>
• Вложенные объекты и массивы
• Любую валидную структуру JSON

Код состояния

Поле ввода свободного текста, где вы можете ввести любой валидный HTTP-код состояния (заполнитель по умолчанию — 200). Распространенные примеры включают:

• 200: OK — Стандартный успешный ответ
• 201: Created — Ресурс успешно создан
• 400: Bad Request — Неверные параметры запроса
• 404: Not Found — Ресурс не существует
• 500: Internal Server Error — Ошибка на стороне сервера

Любой валидный HTTP-код состояния может быть введен непосредственно в поле.

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

Настройте дополнительные HTTP-заголовки для включения в ответ.

Заголовки настраиваются как пары ключ-значение:

Примеры использования

Ответ конечной точки API — Возврат структурированных данных из API поиска

Agent (Search) → Function (Format & Paginate) → Response (200, JSON)

Подтверждение вебхука — Подтверждение получения и обработки вебхука

Webhook Trigger → Function (Process) → Response (200, Confirmation)

Обработка ответов об ошибках — Возврат соответствующих ответов об ошибках

Condition (Error Detected) → Router → Response (400/500, Error Details)

Выходные данные

Блоки "Ответ" являются терминальными — никакие последующие блоки не выполняются после них. Однако блок определяет выходные данные (data, status, headers), которые используются для построения HTTP-ответа, отправляемого обратно к вызывающему API.

Ссылки на переменные

Используйте синтаксис <variable.name> для динамической вставки переменных воркфлоу в ваш ответ:

{
  "user": {
    "id": "<variable.userId>",
    "name": "<variable.userName>",
    "email": "<variable.userEmail>"
  },
  "query": "<variable.searchQuery>",
  "results": "<variable.searchResults>",
  "totalFound": "<variable.resultCount>",
  "processingTime": "<variable.executionTime>ms"
}

Рекомендации

• Используйте осмысленные коды состояния: Выбирайте соответствующие HTTP-коды состояния, которые точно отражают результат воркфлоу
• Структурируйте ответы последовательно: Поддерживайте последовательную структуру JSON во всех конечных точках API для лучшего опыта разработчиков
• Включайте релевантные метаданные: Добавляйте временные метки и информацию о версиях для помощи в отладке и мониторинге
• Обрабатывайте ошибки корректно: Используйте условную логику в вашем воркфлоу для установки соответствующих ответов об ошибках с описательными сообщениями
• Проверяйте ссылки на переменные: Убедитесь, что все ссылаемые переменные существуют и содержат ожидаемые типы данных перед выполнением блока "Ответ"