Базовый URL: https://egebulut.com/api/v1
Авторизация
Для методов рабочего пространства нужен bearer-токен. Храните токены в секрете и передавайте в заголовке Authorization.
Authorization: Bearer <access_token>Методы
| Метод | Путь | Описание | Токен |
|---|---|---|---|
| GET | /health | Состояние сервиса и текущий регион. | Нет |
| GET | /version | Версии API и клиента. | Нет |
| POST | /auth/login | Вход в рабочее пространство. | Нет |
| GET | /files | Файлы рабочего пространства. | Да |
Проверка сервиса
curl https://egebulut.com/api/v1/health
{"status":"ok","region":"tr-izm-1","time":"2026-10-11T09:00:00+00:00"}Ошибки
Ошибки возвращаются в формате JSON с полем error.
| HTTP | error | Описание |
|---|---|---|
| 401 | invalid_credentials | Почта или пароль не подошли. |
| 401 | unauthorized | Нужен действующий токен доступа. |
| 405 | method_not_allowed | Используйте метод, указанный для этого пути. |
| 429 | rate_limited | Подождите время из Retry-After перед следующей попыткой. |
Ограничение попыток входа
Для одного IP разрешено в среднем 30 запросов в минуту. Допускается короткая серия до 30 запросов.