Відхилити запит

Кінцевий вузол, який завершує виконання статусом rejected з кодом помилки й повідомленням, обраними його автором.

2 хв читання

Відхилити запит завершує шлях відмовою, яку задумав автор флоу. Виконання, яке до нього дійшло, отримує статус rejected, а той, хто викликає, отримує код і повідомлення, на які налаштовано вузол.

Вузол: Відхилити запит
Тип: reject
Категорія: Вихід
Порти: Немає
Завершує шлях: Так

Що робить вузол

Вузол завершує виконання статусом rejected. Виконання несе код вузла як error_code і його повідомлення як error_message; його output — null. Після нього нічого не виконується.

JSON

{
  "status": "rejected",
  "output": null,
  "error_code": "plan_required",
  "error_message": "This operation needs the Pro plan"
}

Відмова — це відповідь, а не помилка запиту: SDK повертають виконання й нічого не кидають, а той, хто викликає, відрізняє її від завершеного за статусом — Надіслати запит.

Коли використовувати

Відхилити запит, проти якого вирішив Умова: за тарифом, розміром, відсутнім полем.
Відповісти на відмовлену витрату своїми словами: ведіть сюди гілку Відмова вузла Перевірка бюджету або AI-модель.

Вузол відповідає за одну причину. Якщо флоу відмовляє з кількох, дайте кожній свій вузол зі своїм кодом, щоб той, хто викликає, міг їх розрізнити.

Налаштування

Налаштування	Для чого воно
`error_code`	Код, з яким закінчується виконання, — від 1 до 64 малих латинських літер, цифр, крапок і підкреслень. Обов’язковий.
`message`	Речення для людини, що йде з кодом, не довше за 500 символів. Якщо його немає або воно порожнє, виконання несе фразу The request was rejected by the flow.

У конструкторі налаштування — Код помилки і Повідомлення. Новий вузол налаштовано на код нижче; вузол без повідомлення відповідає «The request was rejected by the flow».

JSON

{ "error_code": "rejected_by_flow" }

Порти

Вузол не має портів: він завершує шлях. Порти й розгалуження каже, чому кожен шлях закінчується в кінцевому вузлі.

Вихід

Вузол не залишає відповіді: output відхиленого виконання — null. Той, хто викликає, читає код і повідомлення, а в трасуванні вони є в її події rejected.

Помилки

Помилок вузол не кидає. Налаштування перевіряються під час перевірки флоу та під час його публікації.

В API запис issues називає таку перевірку в params.detail; його code — invalid_node_config.

Перевірка	Повідомлення в конструкторі
`reject_needs_error_code`	Вузлу «`{node}`» потрібен код помилки.
`reject_invalid_error_code`	Код помилки «`{node}`» має бути завдовжки від 1 до `{max}` символів: малі латинські літери, цифри, крапки та підкреслення.
`reject_invalid_message`	Повідомлення «`{node}`» має бути текстом не довше `{max}` символів.

Приклад

Умова перевіряє тариф клієнта. Запит без цього тарифу закінчується в Відхилити запит з plan_required, і модель заради нього не викликається.

Надіслати запит — відмова флоу й відмова платформи з боку застосунку.
Повернути відповідь — інший спосіб завершити шлях.
Порти й розгалуження — кінцеві вузли й порти інших.

Зібрано з openapi b070e1f, sdk contract 5cc7055, php ae4a53b, node 84bc62d