Версии и публикация

Черновики, неизменяемые версии, публикации, slug, отключение, дублирование и удаление решений — и что видят ваши API-клиенты на каждом шаге.

У каждого решения есть редактируемый черновик и история неизменяемых версий. API всегда выполняет активную версию; черновик попадает в продакшен, только когда вы его публикуете.

Устройство решения

СвойствоПравила
НазваниеОт 1 до 80 символов.
SlugЭндпоинт: POST /v1/decisions/{slug}. Строчные буквы, цифры и одиночные дефисы, до 64 символов. Уникален в рабочем пространстве.
ОписаниеНеобязательно, до 500 символов.
ЧерновикСхема, которую вы редактируете.
ВерсииНеизменяемые снимки, создаваемые каждой публикацией: v1, v2, …
СтатусDraft, Live или Disabled.

Жизненный цикл

 Draft ──deploy──▶ Live (v1) ──deploy──▶ Live (v2) ──deploy──▶ …
                      │   ▲
               disable│   │enable
                      ▼   │
                    Disabled
СтатусЧто возвращает POST /v1/decisions/{slug}
Черновик — ни разу не опубликован409 DECISION_NOT_DEPLOYED
В работе200 с ответом активной версии; version указывает, какой именно
Отключено409 DECISION_DISABLED
Удалено (или неизвестный slug)404 DECISION_NOT_FOUND

Черновики и автосохранение

Редактор и визуальный конструктор редактируют один и тот же черновик. Изменения сохраняются автоматически примерно через 1,5 секунды после последней правки — только если черновик корректен; иначе панель сохранения перечисляет проблемы со ссылкой К ошибке.

Если коллега (или другая вкладка) сохранил решение после того, как вы его открыли, ваше сохранение отклоняется, а не перезаписывает чужое: панель сохранения показывает Кто-то другой сохранил это решение и предлагает Загрузить текущую версию.

Сохранение черновика никогда не меняет продакшен.

Публикация

Опубликовать (на вкладке Публикация решения) делает снимок текущего черновика как версию n + 1 и делает её активной немедленно — работающие клиенты переключаются на неё при следующем вызове. Несохранённые правки сначала сохраняются; черновик с проблемами схемы опубликовать нельзя.

  • Версии неизменяемы: их нельзя редактировать или удалять.
  • Поле version в ответе и каждое выполнение фиксируют версию, которая ответила.
  • История версий перечисляет все версии (В работе или В архиве) с их полной схемой.
  • Версия продолжает работать так, как была опубликована. Когда Dcision ужесточает правило валидации — v0.3 проверяет значения правил на соответствие вариантам, уровням и диапазонам, с которыми они сравниваются, — новое правило применяется при следующем сохранении или публикации черновика, но никогда к работающей версии.
  • Для публикации, как и для любого изменения решения, нужна роль «Участник» или выше — см. Команда, роли и аккаунт.

Откат

Отката в один клик пока нет. Чтобы вернуться к прежнему поведению, откройте схему версии в Истории версий, приведите черновик к ней и опубликуйте — это создаст новый номер версии со старой логикой.

Slug

  • Когда вы создаёте решение, slug генерируется из его названия: диакритика удаляется, буквы становятся строчными, всё остальное превращается в дефисы — "Lead Qualification!" становится lead-qualification. Если slug занят, добавляется суффикс: lead-qualification-2.
  • Slug можно менять до первой публикации. После этого он заблокирован: клиенты его вызывают, и переименование их сломало бы (409 CONFLICT — "The slug can't change after the first deploy.").
  • Slug уникален в пределах рабочего пространства. В двух рабочих пространствах может быть решение lead-qualification: API-ключ определяет, какое рабочее пространство — а значит, и какое решение — выполняется.

Отключение и включение

Отключить endpoint останавливает работающее решение, ничего не теряя: вызовы получают 409 DECISION_DISABLED, пока вы не нажмёте Включить endpoint, который снова обслуживает ту же активную версию. Включить можно только решение, которое уже публиковалось.

Дублирование

Дублировать копирует черновик (не версии) в новое решение с названием "name (copy)", со своим slug и без версий. Оно учитывается в лимите решений вашего тарифа.

Удаление

Удалить удаляет решение вместе с его версиями и историей выполнений. Вызовы его slug сразу завершаются ошибкой 404 DECISION_NOT_FOUND, а slug освобождается для нового решения. Это нельзя отменить.

Лимиты тарифа

Количество решений в рабочем пространстве зависит от тарифа — 2 на Genesis, 10 на Developer, без ограничений на Growth и Enterprise. Создание или дублирование сверх лимита завершается ошибкой 402 PLAN_LIMIT_REACHED; удалите решение или повысьте тариф. Отключённые решения и черновики тоже учитываются.

На этой странице