MediaVault API REFERENCE
OpenAPI-style mockMock server online
MEDIA STORAGE · REST API

MediaVault API

Единая точка входа для управления медиафайлами. Загружайте изображения, видео и документы, получайте метаданные и управляйте объектами через простой REST-интерфейс.

API VERSIONv1.0.0Last updated · 2026
https://api.mediavault.local/v1
↥
Загрузка файлов

Моковый upload endpoint с валидацией имени, типа и размера.

⌕
Поиск и фильтры

Пагинация, поиск по имени и фильтрация по MIME-типу.

⌘
JSON responses

Предсказуемые ответы и HTTP-коды в стиле настоящего API.

Авторизация

Пример заголовка для защищённых запросов

BEARER TOKEN

В демо токен не проверяется — поле нужно для имитации рабочего API-клиента.

Authorization: Bearer mv_demo_xxxxxxxxxxxx

Endpoints

Раскройте метод, чтобы посмотреть параметры и выполнить mock-запрос

5 RESOURCES
GET/assetsПолучить список медиафайлов›

Возвращает список объектов с поддержкой поиска, фильтрации и пагинации.

Query parameters

ПараметрТипОписание
qstringПоиск по имени файла
typestringimage, video, document, audio
limitintegerКоличество результатов (1–100)
pageintegerНомер страницы

Response · 200

Объект с массивом data и метаданными пагинации.

Try it out
Response body● 200 OK · 18 ms
GET/assets/{id}Получить файл по ID›

Возвращает объект и метаданные указанного файла. Для неизвестного ID вернёт 404.

Path parameters

ПараметрТипОписание
idstringУникальный идентификатор ресурса

Response · 200 / 404

Asset object либо стандартная ошибка API.

Try it out
Response body
POST/assetsЗагрузить новый файл›

Создаёт новый объект в моковом хранилище. Реальная передача бинарных данных не выполняется.

Request body · application/json

ПолеТипОписание
filenamestringИмя с расширением
mimeTypestringMIME-тип файла
sizeintegerРазмер в байтах
folderstringПапка назначения (опционально)

Response · 201

Созданный Asset и временный URL.

Try it out
Response body● 201 Created · 24 ms
PUT/assets/{id}Обновить метаданные›

Обновляет имя и теги существующего объекта в демо-коллекции.

Request body

ПолеТипОписание
filenamestringНовое имя файла
tagsstring[]Список тегов через запятую
Try it out
Response body
DELETE/assets/{id}Удалить файл›

Удаляет объект из текущего состояния мокового хранилища. Действие можно отменить перезагрузкой страницы.

Path parameters

idstringИдентификатор объекта

Response · 200 / 404

Try it out
Response body
GET/storage/statsСтатистика хранилища›

Сводные данные о количестве файлов и занятом пространстве.

Response · 200

Счётчики пересчитываются по текущему моковому массиву.

Try it out
Response body● 200 OK · 9 ms

Модели данных

Основная схема ресурса Asset

SCHEMA
Assetobject
idstringУникальный ID, например med_001
filenamestringИсходное имя файла
mimeTypestringMIME content type
sizeintegerРазмер в байтах
urlstring (uri)URL ресурса в моковом CDN
folderstringПуть внутри хранилища
tagsstring[]Массив пользовательских тегов
createdAtstring (date-time)Дата создания в ISO 8601

Ошибки и коды ответов

Единый формат ошибок API

200 OKSuccessЗапрос выполнен успешно
201 CreatedSuccessОбъект создан
400 Bad RequestErrorНеверные параметры запроса
404 Not FoundErrorРесурс не найден
413 Payload Too LargeErrorПревышен лимит размера (демо: 100 MB)
Скопировано