Secure Sharing API

Авторизация: Bearer JWT, Telegram initData или API-токен.

Папки

Список папок

GET /api/secure/folders

Ответ:

[
  {
    "id": 1,
    "name": "Команда разработки",
    "description": "Доступы к серверам",
    "isPaused": false,
    "fileCount": 3,
    "createdAt": "2025-01-15T10:00:00.000Z",
    "updatedAt": "2025-01-15T10:00:00.000Z"
  }
]

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

POST /api/secure/folders
Content-Type: application/json

{
  "name": "Команда разработки",
  "description": "Доступы к серверам"
}

Обновление папки

PATCH /api/secure/folders/:id
Content-Type: application/json

{
  "name": "Новое название"
}

Приостановка / возобновление

PATCH /api/secure/folders/:id/pause

Переключает isPaused. При isPaused: true все ссылки внутри папки возвращают 403.

Удаление папки

DELETE /api/secure/folders/:id

Каскадно удаляет все файлы и ссылки.

Файлы

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

GET /api/secure/files?folderId=1

Получение файла

GET /api/secure/files/:id

Создание файла

POST /api/secure/files
Content-Type: application/json

{
  "folderId": 1,
  "name": "SSH ключ",
  "description": "Сервер prod-01",
  "contentType": "text",
  "textContent": "ssh-rsa AAAA..."
}

Загрузка медиа/файла

POST /api/secure/files/:id/upload
Content-Type: multipart/form-data

file: <binary>

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

DELETE /api/secure/files/:id

Ссылки

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

GET /api/secure/links?fileId=1

Создание ссылки

POST /api/secure/links
Content-Type: application/json

{
  "fileId": 1,
  "expiresInHours": 24,
  "maxViews": 5
}

Ответ:

{
  "id": 1,
  "code": "abc123",
  "url": "https://tgio.app/s/abc123",
  "expiresAt": "2025-01-16T10:00:00.000Z",
  "maxViews": 5,
  "viewCount": 0,
  "isRevoked": false,
  "createdAt": "2025-01-15T10:00:00.000Z"
}

Отзыв ссылки

PATCH /api/secure/links/:id/revoke

Восстановление ссылки

PATCH /api/secure/links/:id/restore

Удаление ссылки

DELETE /api/secure/links/:id

Публичный просмотр (без авторизации)

Метаданные контента

GET /api/secure/view/:code

Для текста возвращает lines, для файлов — метаданные (mimeType, fileName, fileSize).

Стриминг файла

GET /api/secure/view/:code/stream

Поддерживает HTTP Range для видео.

Скачивание файла

GET /api/secure/view/:code/download

Коды ошибок

Код	Описание
403	Ссылка отозвана или папка приостановлена
404	Ссылка не найдена
410	Срок ссылки истёк или лимит просмотров
413	Файл превышает 10 МБ