Документация API

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

Создайте API-токен в Настройки → API → Создать токен. Токен передаётся в заголовке каждого запроса:

curl -X GET https://api.taigalabs.ru/v2/user/me \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

Прямой запрос без токена вернёт 401 Unauthorized. Токен не передаётся в URL — только в заголовке.

Лимиты запросов

Лимиты зависят от тарифа: Старт — 60 запросов/мин, Базовый/Стандарт — 300/мин, Профессионал+ — 1000/мин. При превышении возвращается 429 Too Many Requests с заголовком Retry-After.

Управление файлами

Список файлов

GET /v2/files?folder_id=root&limit=50&offset=0

Response 200:
{
  "items": [
    {
      "id": "f_3a8b2c1d",
      "name": "Отчёт Q1 2025.pdf",
      "size": 2048576,
      "created_at": "2025-04-01T10:00:00Z"
    }
  ],
  "total": 142,
  "has_more": true
}

Загрузка файла

curl -X POST https://api.taigalabs.ru/v2/files/upload \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -F "file=@report.pdf" \
  -F "folder_id=root"

Удаление файла

Квота хранилища

Response 200:
{
  "used_bytes": 5368709120,
  "total_bytes": 2199023255552,
  "plan": "standard",
  "used_human": "5 ГБ",
  "total_human": "2 ТБ"
}

Webhooks

Настраиваются в Настройки → API → Webhooks. Поддерживаемые события: file.created, file.updated, file.deleted, folder.shared.

{
  "event": "file.created",
  "timestamp": "2025-05-01T12:00:00Z",
  "data": {
    "file_id": "f_3a8b2c1d",
    "name": "document.docx",
    "size": 45678
  }
}