Devlog #16: Внутренние схемы API

У Quedula есть внутренний HTTP API между фронтендом и бэкендом. Поддерживать его без документации — значит создавать долг, который накапливается.

Мы используем OpenAPI-схему как единственный источник истины для контракта API. Схема генерируется из кода — это гарантирует что она не расходится с реальностью.

Из схемы автоматически генерируется клиент для фронтенда. Это значит что изменение типа поля на бэкенде немедленно проявляется как ошибка типизации на фронтенде — ещё до деплоя.

Дополнительный бонус: схему можно использовать для генерации тестовых данных и для валидации запросов на уровне middleware.