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

Возвращает список неудаленных и неистекших файлов в файловом пространстве текущего пользователя. Результаты сортируются по created_at в обратном порядке.

GET https://api.odirouter.ai/v1/files

Параметры запроса

curl --location "https://api.odirouter.ai/v1/files?page=1&page_size=20" \
  --header "Authorization: Bearer YOUR_API_KEY"

page integer

Номер страницы, начиная с 1

По умолчанию: 1

page_size integer

Размер страницы

По умолчанию: 20

Диапазон: 1 - 100

mime_type string

Точный фильтр по MIME-типу, например image/png

created_after integer

Возвращает только файлы, созданные не раньше этого времени, Unix timestamp в секундах

created_before integer

Возвращает только файлы, созданные не позже этого времени, Unix timestamp в секундах

Параметры ответа

{
  "object": "list",
  "data": [
    {
      "id": "file_456",
      "object": "file",
      "filename": "reference.png",
      "bytes": 345678,
      "mime_type": "image/png",
      "file_type": "image",
      "source": "upload",
      "dimensions": {
        "width": 1024,
        "height": 768
      },
      "storage_policy": "temporary",
      "created_at": 1784256000,
      "expires_at": 1784860800,
      "url": "https://private.cdn.odirouter.ai/uploads/xxx.png?Expires=..."
    }
  ],
  "total": 1,
  "page": 1,
  "page_size": 20
}

Поле	Тип	Описание
object	string	Всегда list
data	array	Список объектов файлов
total	integer	Общее количество файлов после фильтрации
page	integer	Текущий номер страницы
page_size	integer	Размер страницы

Объект файла

Поле	Тип	Описание
id	string	ID файла в формате file_{id}
object	string	Всегда file
filename	string	Исходное имя файла; если имя не передано, его генерирует платформа
bytes	integer	Размер файла в байтах
mime_type	string	MIME-тип файла
file_type	string	Тип файла. Возможные значения в ответе: image, audio, video, document, text
source	string	Источник файла. Возможные значения в ответе: upload и api. upload означает, что файл создан через API загрузки файлов, а api означает, что файл сгенерирован другим API-вызовом и поддерживается платформой
dimensions	object | null	Размеры файла. Для JPEG, PNG и GIF возвращается ширина и высота; для остальных файлов или неподдерживаемых форматов изображений возвращается null
dimensions.width	integer	Ширина в пикселях; возвращается только если dimensions не равен null
dimensions.height	integer	Высота в пикселях; возвращается только если dimensions не равен null
storage_policy	string	Политика хранения. Сейчас всегда temporary
created_at	integer	Время создания, Unix timestamp в секундах
expires_at	integer	Время истечения, Unix timestamp в секундах. В текущей версии у всех файлов есть конкретное время истечения
url	string	Текущий доступный краткоживущий подписанный URL

Удаленные, истекшие или недоступные файлы не возвращаются в списке.