Облачный API

Облако хранит то, что общее для установок и приложений: аккаунты, организации, реестр площадок и установок. Оно никогда не управляет куполом. Приложения работают с куполом через SDK в локальной сети.

Операции перечислены в справочнике облака.

Вход

curl -X POST "$BASE/api/v1/auth/sign-in" \
  -H 'content-type: application/json' \
  -d '{"email":"anna@example.org","password":"…","client":"native"}'

В ответе есть accessToken (JWT на 15 минут) и для нативных клиентов обновляемый refreshToken. Веб-клиенты получают токен обновления в httpOnly cookie. Повторное использование старого токена отзывает всё семейство токенов.

Ошибки

Ошибки приходят в формате RFC 9457 application/problem+json, стабильный ключ — поле code. Коды перечислены в разделе Ids and errors.

Удаление аккаунта

DELETE /api/v1/me запускает период ожидания 7 дней, после которого личные данные удаляются. POST /api/v1/me/deletion/cancel отменяет удаление. Пока аккаунт владеет организацией, вызов отвечает 409. Без приложения можно воспользоваться веб-страницей.

Состояние

Сервер работал внутри, в контейнерах: дымовые проверки и сгенерированные контрактные тесты там проходят. Отвечает ли публичный адрес, зависит от развёртывания.