Обновление схемы API — 14 июля 2026

Корневой swagger.json был заменён последним на тот момент экспортом от команды бэкенда. Контракт стал называться ZennoHosting API (DEV); базовый адрес и схема авторизации OAuth2 не изменились.

Добавленные эндпоинты

• Язык аккаунта: PUT /account/locale.
• Уведомления: лента, отметка о прочтении, число непрочитанных и настройки доставки в /notifications.
• Операции проекта: список и детали в /projects/{projectId}/operations.
• Переименование проекта: PATCH /projects/{projectId}/rename.
• Метрики машины, изменение конфигурации и пересборка.
• Отмена и возобновление продления по акции.
• Административные saga-эндпоинты /admin/sagas — просмотр, finalize и force-compensate.

Удалённые и изменённые эндпоинты

• PATCH /projects/{projectId} заменён на PATCH /projects/{projectId}/rename. Клиентам нужно поменять путь и использовать RenameProjectRequest.
• У существующих ресурсов обновлены метаданные запросов, ответов, валидации и постраничной навигации.

Изменения схем

Контракт получил модели уведомлений, отслеживания операций, метрик, изменения конфигурации и пересборки машины, счётчиков ресурсов, локали, ошибок валидации и администрирования саг. Общие модели Operation и OperationStatus заменены на OperationResponse и ApiOperationStatus. Имена постраничных ответов для сетей, публичных адресов и машин приведены к единому виду.

Безопасность и переход

Требование OAuth2 не изменилось. Административные saga-эндпоинты предполагалось открывать только доверенным эксплуатационным инструментам. Клиентам следовало перегенерировать типы API, поменять путь переименования проекта и проверить переименованные модели операций и постраничных ответов.