REST API облачного хранилища файлов
{
"email": "user@example.com",
"password": "secret"
}
{
"access_token": "eyJhbGciOiJIUzI1NiIs...",
"refresh_token": "eyJhbGciOiJIUzI1NiIs...",
"expires_in": 3600,
"token_type": "Bearer"
}
| Код | Описание |
|---|---|
400 | Некорректный запрос |
401 | Неверные учётные данные |
{
"refresh_token": "eyJhbGciOiJIUzI1NiIs..."
}
{
"access_token": "eyJhbGciOiJIUzI1NiIs...",
"expires_in": 3600,
"token_type": "Bearer"
}
| Код | Описание |
|---|---|
401 | Недействительный refresh-токен |
| Заголовок | Описание | |
|---|---|---|
Authorization |
required | Bearer access-токен |
{
"id": "user-42",
"email": "user@example.com",
"name": "Иван Петров",
"role": "user",
"quota": {
"used": 536870912,
"limit": 10737418240
}
}
| Заголовок | Описание | |
|---|---|---|
Authorization |
required | Bearer access-токен |
(пусто)
{
"status": "ok",
"uptime_sec": 3600,
"version": "1.0.0"
}
| Параметр | Тип | Описание | |
|---|---|---|---|
prefix | string | Фильтр по пути/префиксу | |
limit | integer | Максимум записей | |
cursor | string | Токен пагинации | |
sort | string | Сортировка: name | size | updated_at |
{
"items": [
{
"name": "README.md",
"size": 1234,
"etag": "a1b2c3d4e5f6",
"updated_at": "2026-08-15T10:00:00Z"
}
],
"cursor": null
}
| Код | Описание |
|---|---|
401 | Не авторизован |
403 | Нет доступа |
| Параметр | Тип | Описание | |
|---|---|---|---|
name | string | required | Имя файла или путь |
| Параметр | Тип | Описание | |
|---|---|---|---|
download | boolean | Принудить загрузку (Content-Disposition) | |
range | string | Диапазон байт: bytes=0-1023 |
{
"name": "README.md",
"content": "...",
"size": 1234,
"content_type": "text/markdown",
"etag": "a1b2c3d4e5f6"
}
| Параметр | Тип | Описание | |
|---|---|---|---|
name | string | required | Имя файла или путь |
{
"name": "README.md",
"size": 1234,
"content_type": "text/markdown",
"created_at": "2026-08-10T09:00:00Z",
"updated_at": "2026-08-15T10:00:00Z",
"owner": "user-42",
"checksum": {
"md5": "a1b2c3d4e5f6a1b2c3d4e5f6",
"sha256": "9f8e7d..."
}
}
| Параметр | Тип | Описание | |
|---|---|---|---|
name | string | required | Имя файла или путь |
{
"versions": [
{ "version": 3, "size": 1234, "updated_at": "2026-08-15T10:00:00Z" },
{ "version": 2, "size": 1200, "updated_at": "2026-08-13T08:30:00Z" },
{ "version": 1, "size": 900, "updated_at": "2026-08-10T09:00:00Z" }
]
}
| Параметр | Тип | Описание | |
|---|---|---|---|
name | string | required | Имя файла или путь |
| Параметр | Тип | Описание | |
|---|---|---|---|
ttl | integer | Время жизни в секундах (по умолчанию 3600) |
{
"url": "https://cdn.your-cloud.example.com/README.md?token=...&expires=..."
}
| Поле | Тип | Описание | |
|---|---|---|---|
file | binary | required | Файл для загрузки |
path | string | Целевая папка внутри хранилища |
{
"name": "uploaded.txt",
"size": 456,
"etag": "9f8e7d6c5b4a",
"url": "https://cdn.your-cloud.example.com/uploaded.txt"
}
| Параметр | Тип | Описание | |
|---|---|---|---|
name | string | required | Имя файла или путь |
| Поле | Тип | Описание | |
|---|---|---|---|
file | binary | required | Новое содержимое |
{
"name": "README.md",
"version": 4,
"size": 1300,
"etag": "bbccddeeff00"
}
| Параметр | Тип | Описание | |
|---|---|---|---|
name | string | required | Имя файла или путь |
{
"content_type": "text/plain",
"tags": ["docs", "important"]
}
{
"name": "README.md",
"content_type": "text/plain",
"tags": ["docs", "important"]
}
| Параметр | Тип | Описание | |
|---|---|---|---|
name | string | required | Имя файла или путь |
| Параметр | Тип | Описание | |
|---|---|---|---|
purge | boolean | Удалить из CDN-кэша |
(пусто)