Понятные ресурсы
Рабочие пространства, источники, диалоги, сценарии и события представлены отдельными сущностями. Авторизация и изоляция workspace — обязательная часть серверной реализации.
curl -X POST https://api.example.invalid/v1/workspaces/demo/sources \
-H "Authorization: Bearer DEMO_TOKEN" \
-H "Content-Type: application/json" \
-d '{"type":"url","url":"https://example.com/faq"}'Адрес example.invalid намеренно нерабочий. Это пример контракта, не инструкция подключения к доступному API.
События и webhooks
В проекте предусмотрены идентификатор события, повтор с ограничением, подпись полезной нагрузки и ключ идемпотентности. Обработчик должен быть устойчив к дубликатам.
| Событие | Смысл |
|---|---|
| conversation.escalated | Нужен человек |
| lead.created | Создана заявка |
| knowledge.review_required | Источник требует проверки |
| content.approved | Материал согласован |
Ошибки — часть интерфейса
Предусмотрите ясные ответы на недостаточные права, превышение лимита, конфликт версии и недоступность источника. Повторы не должны порождать дублирующиеся заявки или публикации.
Экспорт данных
В демо можно экспортировать настройки и записи в JSON или CSV. Это локальная операция в браузере и пример будущего принципа переносимости данных.