API Reference

Uply предоставляет REST API для интеграции с вашими системами.

Базовый URL

Окружение	URL
Production	https://api.getuply.io
Development	https://dev-api.getuply.io

Swagger UI

Интерактивная документация доступна:

• Production: api.getuply.io/swagger
• Development: dev-api.getuply.io/swagger

Аутентификация

API использует JWT токены. Получите токен через:

• POST /api/auth/login — логин по email/пароль
• Консоль → Настройки аккаунта → API токены

Использование токена

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://api.getuply.io/api/projects

Refresh токен

Токены истекают через 24 часа. Обновите через:

curl -X POST https://api.getuply.io/api/auth/refresh-token \
  -H "Content-Type: application/json" \
  -d '{"refresh_token": "YOUR_REFRESH_TOKEN"}'

Основные endpoints

Аутентификация

Метод	Endpoint	Описание
POST	/api/auth/register	Регистрация
POST	/api/auth/login	Вход
POST	/api/auth/logout	Выход
POST	/api/auth/refresh-token	Обновление токена

Проекты

Метод	Endpoint	Описание
GET	/api/projects	Список проектов
POST	/api/projects	Создать проект
GET	/api/project/{id}	Получить проект
PUT	/api/projects/{id}	Обновить проект
DELETE	/api/projects/{id}	Удалить проект

Приложения

Метод	Endpoint	Описание
GET	/api/projects/{id}/applications	Список приложений
POST	/api/projects/{id}/applications	Создать приложение
GET	/api/projects/{id}/applications/{appId}	Получить приложение
PUT	/api/projects/{id}/applications/{appId}	Обновить
DELETE	/api/projects/{id}/applications/{appId}	Удалить

Билды

Метод	Endpoint	Описание
GET	/api/app-distribution/{projectId}/{appId}/builds	Список билдов
POST	/api/app-distribution/{projectId}/{appId}/builds/upload-link	Получить URL загрузки
POST	/api/app-distribution/{projectId}/{appId}/builds/verify	Подтвердить загрузку
DELETE	/api/app-distribution/{projectId}/{appId}/builds/{buildId}	Удалить билд

Коды ошибок

HTTP код	Описание
400	Неверный запрос
401	Не авторизован
403	Доступ запрещён
404	Не найдено
413	Файл слишком большой
422	Ошибка валидации
429	Превышен лимит запросов
500	Внутренняя ошибка сервера

Rate Limits

Тариф	Лимит
Free	100 запросов/минуту
Pro	1000 запросов/минуту
Enterprise	Без ограничений

Примеры

Получение списка проектов

curl -X GET "https://api.getuply.io/api/projects" \
  -H "Authorization: Bearer $TOKEN"

Ответ:

{
  "projects": [
    {
      "id": "proj_abc123",
      "name": "My Project",
      "applicationsCount": 2,
      "createdAt": "2024-01-01T00:00:00Z"
    }
  ]
}

Создание проекта

curl -X POST "https://api.getuply.io/api/projects" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "New Project"}'