Загрузить файл (multipart, асинхронный)

POST /v1/media/upload

POST/v1/media/upload

Загрузка бинарного файла на серверы маркетплейса. Multipart/form-data: поле file (бинарное содержимое) + поле metadata (JSON). external_id — внешний ключ поставщика, постоянный для media_id (1:1). Если external_id уже существует — создаётся новая версия media_id, при этом создание новой версии автоматически помечает предыдущую как deleted (soft-delete). Если external_id новый — создаётся новый media_id с version=1. target — опциональный способ упорядочивания, не связь с сущностями. mime_type — MIME-тип контента (напр. image/jpeg, video/mp4), используется витриной для дообработки. external_url в ответе — URL, по которому можно скачать файл с серверов маркетплейса.

Тело запроса

file
string
required
Бинарное содержимое файла
metadata
object
required
Метаданные загрузки
Показать свойства
request_key
[ "string", "null" ]
Ключ идемпотентности (опц.)
external_id
string
required
Внешний ключ поставщика (1:1 с media_id, постоянный)
target
[ "object", "null" ]
Способ упорядочивания (опц., не связь с сущностями)
Показать свойства
type
string
required
Допустимые значения
skuspu
id
string
required
mime_type
string
required
MIME-тип контента (напр. image/jpeg, video/mp4), используется витриной для дообработки

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

200Принят
application/json
object
request_id
string
required
Идентификатор запроса
request_key
[ "string", "null" ]
Ключ идемпотентности (эхо, опц.)
media_id
string
required
Внутренний идентификатор медиа (1:1 с external_id)
external_id
string
required
Внешний ключ поставщика (эхо)
version
integer
required
Номер версии (1 для нового media_id, 2,3... для повторных загрузок с тем же external_id)
media_version_id
string
required
Идентификатор конкретной версии
external_url
string
required
URL от витрины для скачивания файла с серверов маркетплейса
mime_type
string
required
MIME-тип контента (эхо, напр. image/jpeg, video/mp4)
created_at
string
required
Время создания версии
idempotent
[ "boolean", "null" ]
true — сработала идемпотентность (повторный request_key); null/отсутствует — обычный запрос
POST/v1/media/upload
1curl https://api.omninet.ru/v1/media/upload \2  --request POST \3  --header 'Content-Type: application/json' \4  --data '{5  "file": "string",6  "metadata": {7    "request_key": null,8    "external_id": "string",9    "target": {10      "type": "string",11      "id": "string"12    },13    "mime_type": "string"14  }15}'
{
  "request_id": "string",
  "request_key": null,
  "media_id": "string",
  "external_id": "string",
  "version": 0,
  "media_version_id": "string",
  "external_url": "string",
  "mime_type": "string",
  "created_at": "string",
  "idempotent": null
}

Принят