Получить список медиа

POST /v1/media/list

POST/v1/media/list

Возвращает список медиа-файлов с курсор-пагинацией. include_versions=false (по умолчанию) — только последняя активная версия каждого media_id; include_versions=true — все версии, включая soft-deleted при include_deleted=true. Фильтры комбинируются по И (AND).

Тело запроса

filter
[ "object", "null" ]
Показать свойства
target
[ "object", "null" ]
Фильтр по способу упорядочивания
Показать свойства
type
string
required
Допустимые значения
skuspu
id
string
required
external_id
[ "string", "null" ]
Фильтр по внешнему ключу поставщика (1:1 с media_id)
mime_type
[ "string", "null" ]
Фильтр по MIME-типу (точное совпадение, напр. image/jpeg)
include_deleted
boolean
true — включать soft-deleted версии; false — только активные
include_versions
boolean
false — только последняя активная версия каждого media_id; true — все версии (включая soft-deleted при include_deleted=true)
pagination
object
Cursor-пагинация. Первый запрос - без cursor (или пустой). Для получения следующей страницы - передать cursor из ответа (pagination.next_cursor). Если has_next: false - достигнут конец списка.
Показать свойства
cursor
[ "string", "null" ]
Курсор для следующей страницы (opaque-токен, генерируется сервером). Пусто или отсутствие - первая страница.
limit
integer
required
Лимит элементов на странице

Успешный ответ

200Список медиа
application/json
object
media
array
required
Список медиа-файлов
Данные медиа-файла (одна запись media, возможно с версиями)
Показать свойства
media_id
string
required
Внутренний идентификатор медиа (1:1 с external_id)
external_id
string
required
Внешний ключ поставщика
target
[ "object", "null" ]
Способ упорядочивания (опц., не связь с сущностями)
Показать свойства
type
string
required
Допустимые значения
skuspu
id
string
required
current_version
integer
required
Последняя активная версия
versions
[ "array", "null" ]
Все версии (только если include_versions=true; иначе null). При include_deleted=true включает soft-deleted версии.
Показать свойства
Свойства не описаны
pagination
object
required
Результат cursor-пагинации
Показать свойства
next_cursor
[ "string", "null" ]
Курсор для следующей страницы. Передать в pagination.cursor следующего запроса. Пусто (или null), если has_next: false (достигнут конец списка).
has_next
boolean
required
true - есть следующая страница; false - достигнут конец списка.
total
[ "integer", "null" ]
Общее количество элементов (опционально). Может быть неточным (приблизительная оценка на момент запроса). Не возвращается, если сервер не может оценить общее количество.
POST/v1/media/list
1curl https://api.omninet.ru/v1/media/list \2  --request POST \3  --header 'Content-Type: application/json' \4  --data '{5  "filter": {6    "target": {7      "type": "string",8      "id": "string"9    },10    "external_id": null,11    "mime_type": null,12    "include_deleted": false,13    "include_versions": false14  },15  "pagination": {16    "cursor": null,17    "limit": 10018  }19}'
{
  "media": [
    {
      "media_id": "string",
      "external_id": "string",
      "target": {
        "type": "string",
        "id": "string"
      },
      "current_version": 0,
      "versions": [
        {
          "version": 0,
          "media_version_id": "string",
          "external_url": "string",
          "mime_type": "string",
          "created_at": "string",
          "deleted": true,
          "deleted_at": null
        }
      ]
    }
  ],
  "pagination": {
    "next_cursor": null,
    "has_next": true,
    "total": null
  }
}

Список медиа