> ## Documentation Index > Fetch the complete documentation index at: https://apidocs.erlcrussia.com/llms.txt > Use this file to discover all available pages before exploring further. # Загрузка файла > Загружает файл в CDN (multipart, поле `file`). По умолчанию изображения и видео сжимаются; `compress=false` сохраняет оригинал. ## OpenAPI ````yaml ru/openapi/ru-api-v3-openapi.yaml POST /cdn/assets openapi: 3.1.0 info: title: ER:LC Россия API V3 description: >- API ER:LC Россия: серверы, пользователи, CDN, редиректы, подписки и ключи доступа. version: 3.0.0 servers: - url: https://api.erlcrussia.com/v3 description: Основной сервер (com) - url: https://api.erlcrussia.xyz/v3 description: Резервный сервер (xyz) security: [] tags: - name: ER:LC Сервер description: Получение статуса, онлайна, списков игроков и персонала сервера ER:LC. - name: ER:LC Команды description: >- Отправка и постановка в очередь команд внутриигрового сервера (:h, :m, :kick, :ban и др.). - name: Экономика description: >- Взаимодействие с экономической системой (пользователи, бизнесы, мафии, магазин, реклама). - name: API Статистики description: >- Высокопроизводительное получение статистики дискорд-серверов и игровых серверов (онлайн, участники, боты). - name: API Верификации description: Поиск и сопоставление Discord ID и Roblox ID аккаунтов. - name: CDN Ассеты description: >- Загрузка, управление, статистика и очистка кэша файлов объектного хранилища MinIO / Edge CDN. - name: CDN Папки description: Иерархическая структура и сортировка папок медиатеки CDN. - name: API Наказаний description: Управление балансом и историей транзакций баллов игроков. - name: API Токенов description: Управление API токенами интеграции и проверка активных подписок. - name: API Подписок description: Каталог планов, заказы FunPay, начисление бенефитов и активация подписок. - name: API Авторизации description: >- Вход через Discord и Roblox OAuth2, управление сессиями пользователя и связывание аккаунтов. - name: Реальное Время и Вебхуки description: >- WebSocket шлюз событий и обработчик входящих вебхуков PRC с криптографической подписью Ed25519. - name: API Управления - Ключи description: Выпуск, аудит, деактивация и разграничение прав API ключей. - name: API Управления - Ограничения description: >- Тонкая настройка разрешенных версий, эндпоинтов, действий (actions) и query-параметров. - name: API Управления - WebSocket Ключи description: Управление ключами доступа к WebSocket шлюзу и подписками на каналы. - name: API Управления - Вебхуки description: Регистрация, валидация доступности и мониторинг пользовательских вебхуков. - name: API Управления - Панель description: >- Управление пользователями, подписками, тарифами, ручной баланс и системная статистика. - name: API Состояния description: Мониторинг работоспособности сервиса, подключений к PostgreSQL и Redis. paths: /cdn/assets: parameters: - name: teamId in: query description: Optional; must equal the API key organization. schema: type: string post: tags: - CDN Ассеты summary: Загрузка файла description: >- Загружает файл в CDN (multipart, поле `file`). По умолчанию изображения и видео сжимаются; `compress=false` сохраняет оригинал. parameters: - name: domain in: query required: false description: > Пространство имён. `default` — наш общий namespace, либо домен клиента для его собственных файлов. schema: type: string example: client.ru - name: path in: query required: false description: Произвольный путь внутри пространства имён. schema: type: string example: branding/logo.png - name: folderId in: query required: false description: ID папки UI для группировки. На путь не влияет. schema: type: string - name: slug in: query required: false description: Имя файла, используется если не задан `path`. schema: type: string example: logo.png - name: autoFolders in: query required: false description: >- Создать папку UI по первому сегменту пути, если `folderId` не передан. schema: type: boolean example: true requestBody: required: true content: multipart/form-data: schema: type: object required: - file properties: file: type: string format: binary description: Файл, максимум 250 МБ. name: type: string description: Отображаемое имя. По умолчанию имя файла. slug: type: string description: Имя файла, если не задан `path`. path: type: string description: Произвольный путь, если не заданы `folderId` и `slug`. domain: type: string default: default folderId: type: string isPinned: type: boolean autoFolders: type: boolean example: file: (binary) path: branding/logo.png folderId: fld_2Qx7 compress: true responses: '200': description: Ассет создан, прогрев кэша отправлен на edge. content: application/json: schema: type: object properties: success: type: boolean asset: $ref: '#/components/schemas/CdnAsset' edgeCached: type: boolean description: >- Whether the edge cache was warmed before the upload response. examples: asset_created_ok: summary: Asset created ok value: asset: name: Инструкция slug: manual.png domain: default path: docs/manual.png fullPath: default/docs/manual.png full_path: default/docs/manual.png folderId: 0199a1b7-033e-7e99-b1f2-6be98f4b2b1d folder_id: 0199a1b7-033e-7e99-b1f2-6be98f4b2b1d sourceType: LOCAL source_type: LOCAL sourceUrl: default/docs/manual.png source_url: default/docs/manual.png isPinned: true is_pinned: 1 mimeType: image/png mime_type: image/png size: 70 sha256: >- c2153f77e11087fcb078ae38527fa83bef29791e3700e30cc87fec4405a66d0f downloads: 0 createdAt: '2026-10-06T14:56:09.0798434Z' created_at: '2026-10-06T14:56:09.0798434Z' updatedAt: '2026-10-06T14:56:09.0798434Z' updated_at: '2026-10-06T14:56:09.0798434Z' folder: name: Документы slug: docs success: true '400': description: Bad Request (400) — некорректные параметры запроса. content: application/json: examples: invalid_param: summary: Invalid param value: code: 5004 message: Invalid Param Name missing_params: summary: Missing params value: code: 5002 message: Missing Parameters '401': description: Unauthorized (401) — ключ не передан. content: application/json: examples: missing_token: summary: Missing token value: code: 5007 message: Missing Token '403': description: Forbidden (403) — ключ есть, но недостаточно прав. content: application/json: examples: missing_token: summary: Missing token value: code: 5007 message: Missing Token '429': description: >- Лимит запросов исчерпан. Учитывайте Retry-After; не запускайте неограниченные параллельные загрузки. content: application/json: schema: $ref: '#/components/schemas/APIError' example: code: 5016 message: Rate Limit Exceeded '503': description: Хранилище недоступно. content: application/json: examples: storage_unavailable: summary: Storage unavailable value: code: 5138 message: CDN Storage Unavailable security: - ApiKeyHeader: [] components: schemas: CdnAsset: type: object description: >- Ассет организации; domain/path и fullPath задают ключ MinIO. folderId задаёт группировку. properties: id: type: string name: type: string slug: type: string domain: type: string description: Пространство имён, первый сегмент пути. example: default path: type: string description: Путь внутри пространства имён. example: branding/logo.png fullPath: type: string description: Полный путь `{domain}/{path}`. example: default/branding/logo.png full_path: type: string folderId: type: - string - 'null' folder_id: type: - string - 'null' folder: type: - object - 'null' properties: id: type: string name: type: string slug: type: string sourceType: type: string enum: - LOCAL - EXTERNAL source_type: type: string sourceUrl: type: string description: Для LOCAL — ключ объекта в MinIO, для EXTERNAL — оригинальный адрес. source_url: type: string isPinned: type: boolean is_pinned: type: integer mimeType: type: string mime_type: type: string size: type: integer description: Размер в байтах. sha256: type: - string - 'null' downloads: type: integer description: Всегда 0, файлы отдаёт edge напрямую из MinIO. createdAt: type: string created_at: type: string updatedAt: type: string updated_at: type: string teamId: type: string APIError: type: object properties: code: type: integer message: type: string error: type: string details: type: object additionalProperties: true required: - code - message securitySchemes: ApiKeyHeader: type: apiKey in: header name: erlcrussia-api-key description: >- Пользовательский API-ключ. Храните на сервере; не включайте в клиентский JavaScript. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.