Получить конкретную версию медиа

POST /v1/media/get

POST/v1/media/get

Возвращает одну запись media с одной версией. Поиск по media_id ИЛИ external_id (1:1 с media_id). version=null → последняя активная. include_deleted=true → может вернуть soft-deleted версию.

Тело запроса

media_id
[ "string", "null" ]
Внутренний идентификатор медиа (вариант 1)
external_id
[ "string", "null" ]
Внешний ключ поставщика (вариант 2, 1:1 с media_id)
version
[ "integer", "null" ]
Номер версии (null → последняя активная)
include_deleted
boolean
true — может вернуть soft-deleted версию; false — только активные

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

200Запись медиа
application/json
object
media
object
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
required
Запрошенная версия (всегда 1 элемент)
Данные одной версии медиа (mediaGet)
Показать свойства
version
integer
required
Номер версии
media_version_id
string
required
Идентификатор конкретной версии
external_url
string
required
URL для скачивания файла с серверов маркетплейса
mime_type
string
required
MIME-тип контента (напр. image/jpeg, video/mp4)
created_at
string
required
Время создания версии
deleted
boolean
required
true — версия soft-deleted; false — активна
deleted_at
[ "string", "null" ]
Время soft-delete (null если не удалена)
POST/v1/media/get
1curl https://api.omninet.ru/v1/media/get \2  --request POST \3  --header 'Content-Type: application/json' \4  --data '{5  "media_id": null,6  "external_id": null,7  "version": null,8  "include_deleted": false9}'
{
  "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
      }
    ]
  }
}

Запись медиа