Загрузить медиафайлы по ссылкам

POST /content/v3/media/save

Метод загружает набор медиафайлов в карточку товара через указание ссылок в запросе.

Новые медиафайлы полностью заменяют старые. Чтобы добавить новые медиафайлы, укажите в запросе ссылки одновременно на новые и старые медиафайлы.

Требования к ссылкам: * для доступа к файлу по ссылке не нужна авторизация * ссылка ведёт прямо на файл. Убедитесь, что ссылка не ведёт на страницу предпросмотра или авторизации. Ссылка должна заканчиваться на имя файла с расширением — например, /file_name.jpg. Если по ссылке открывается текстовая страница TXT или HTML, ссылка считается некорректной.
Помните, что некоторые хранилища не формируют прямые ссылки и поэтому не подходят для использования. К таким хранилищам относится, например, Google Drive, который формирует ссылки только на предпросмотр файла либо на служебные страницы.

Требования к изображениям: * максимум изображений для одной карточки товара — 30 * минимальное разрешение — 700×900 px * максимальный размер — 32 Мб * минимальное качество — 65% * форматы — JPG, PNG, BMP, GIF (статичные), WebP

Требования к видео: * максимум одно видео для одной карточки товара * максимальный размер — 50 Мб * форматы — MOV, MP4

Если видео или хотя бы одно изображение в запросе не соответствует требованиям, то даже при успешном ответе (200) ни одно изображение/видео не загрузится.

Лимит запросов на один профиль продавца для всех методов Медиафайлов:

Тип	Период	Лимит	Интервал	Всплеск
Персональный	1 мин	100 запросов	600 мс	5 запросов
Сервисный	1 мин	100 запросов	600 мс	5 запросов
Базовый с секретом	1 мин	100 запросов	600 мс	5 запросов
Базовый	1 ч	2 запроса	30 мин	1 запрос

---

В песочнице — максимум 1 запрос в секунду суммарно для всех методов Контента.

Тело запроса: object

Ответ: object

Примеры вызова

PythonNode.jsGoPHPRust

import os
from wildberries_sdk import items

token = os.getenv("WB_API_TOKEN")
api = items.DefaultApi(
    items.ApiClient(items.Configuration(api_key={"HeaderApiKey": token}))
)
result = api.post_v3_media_save(object=...)
print(result)

import { Configuration, DefaultApi } from 'wildberries-sdk';

const api = new DefaultApi(new Configuration({ apiKey: process.env.WB_API_TOKEN }));
const result = await api.postV3MediaSave({ ... });
console.log(result);

cfg := items.NewConfiguration()
cfg.AddDefaultHeader("Authorization", os.Getenv("WB_API_TOKEN"))
client := items.NewAPIClient(cfg)
result, _, err := client.DefaultApi.PostV3MediaSave(context.Background()).Execute()

<?php
$config = Wildberries\Sdk\Items\Configuration::getDefaultConfiguration()
    ->setApiKey('Authorization', getenv('WB_API_TOKEN'));
$api = new Wildberries\Sdk\Items\Api\DefaultApi(new GuzzleHttp\Client(), $config);
$result = $api->postV3MediaSave(...);

use wildberries_sdk_items::apis::{configuration::Configuration, configuration::ApiKey, default_api};

let mut config = Configuration::new();
config.api_key = Some(ApiKey { prefix: None, key: std::env::var("WB_API_TOKEN").unwrap() });
let result = default_api::post_v3_media_save(&config, ...).await?;