> ## 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.

# Список Ассетов

> Пагинированный каталог загруженных медиафайлов с фильтрацией по папкам и типам.



## OpenAPI

````yaml ru/openapi/ru-api-v3-openapi.yaml GET /cdn/assets
openapi: 3.1.0
info:
  title: ER:LC Россия API V3
  description: >
    Официальная документация платформы ER:LC Россия API V3.

    Включает в себя интеграцию с игровыми серверами ER:LC, экономику Экономика,
    аналитику статистики гильдий,

    объектное облачное хранилище CDN, систему баллов, управление подписками и
    заказами FunPay, OAuth2 авторизацию,

    WebSocket шлюз реального времени, входящие вебхуки событий PRC и полный
    административный API.
  version: 3.0.0
servers:
  - url: https://api.erlcrussia.xyz/v3
    description: Production API V3 (xyz)
  - url: https://api.erlcrussia.com/v3
    description: Production API V3 (com)
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: Каталог планов, заказы FunPay, начисление бенефитов и активация подписок.
  - name: Реальное Время и Вебхуки
    description: >-
      WebSocket шлюз событий и обработчик входящих вебхуков PRC с
      криптографической подписью Ed25519.
  - name: API Состояния
    description: Мониторинг работоспособности сервиса, подключений к PostgreSQL и Redis.
paths:
  /cdn/assets:
    get:
      tags:
        - CDN Ассеты
      summary: Список Ассетов Хранилища
      description: >-
        Пагинированный каталог загруженных медиафайлов с фильтрацией по папкам и
        типам.
      parameters:
        - name: page
          in: query
          schema:
            type: integer
            default: 1
        - name: limit
          in: query
          schema:
            type: integer
            default: 20
        - name: folderId
          in: query
          schema:
            type: string
        - name: search
          in: query
          schema:
            type: string
        - name: type
          in: query
          schema:
            type: string
      responses:
        '200':
          description: Каталог ассетов.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CDNAssetListResponse'
      security:
        - BearerAuth: []
        - MasterKeyHeader: []
components:
  schemas:
    CDNAssetListResponse:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/CDNAsset'
        total:
          type: integer
          example: 120
        page:
          type: integer
          example: 1
        totalPages:
          type: integer
          example: 6
    CDNAsset:
      type: object
      properties:
        id:
          type: string
          example: ast_9f8d1c2b
        name:
          type: string
          example: banner_summer_2026.png
        url:
          type: string
          example: >-
            https://api.erlcrussia.xyz/v3/cdn/resolve/banners/banner_summer_2026.png
        sizeBytes:
          type: integer
          example: 2451920
        mimeType:
          type: string
          example: image/png
        folderId:
          type: string
          nullable: true
          example: fld_general
        createdAt:
          type: string
          format: date-time
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: API Ключ в заголовке Authorization (формат `Bearer <token>`).
    MasterKeyHeader:
      type: apiKey
      in: header
      name: X-Master-Key
      description: Секретный мастер-ключ сервиса (SUPER_ADMIN).

````