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

POST /content/v3/media/save

База: https://content-api.wildberries.ru · Модуль: items · Раздел: Медиафайлы · Документация спецификации ↗

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

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

Требования к ссылкам: * для доступа к файлу по ссылке не нужна авторизация * ссылка ведёт прямо на файл. Убедитесь, что ссылка не ведёт на страницу предпросмотра или авторизации. Ссылка должна заканчиваться на имя файла с расширением — например, /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 запрос в секунду суммарно для всех методов Контента.

Тело запроса

application/json — схема object, обязательно

• nmId integer<int64> — Артикул WB
• data string[] — Ссылки на изображения в том порядке, в котором они будут в карточке товара, и на видео, на любой позиции массива

Ответы

Код	Описание	Схема
200	Успешно	PostV3MediaSaveResponse200
400	Неправильный запрос	mediaErrors
401	Не авторизован	object
402	Требуется платёж	object
403	Доступ запрещён	mediaErrors
409	Ошибка сохранения части ссылок	mediaErrors
422	Отсутствует параметр nmId	mediaErrors
429	Слишком много запросов	object

Структура 200:

• data object
• error boolean — Флаг ошибки
• errorText string — Описание ошибки
• additionalErrors object — Дополнительные ошибки

Структура 400:

• additionalErrors object — Дополнительные ошибки
• data object — Данные ошибки
• error boolean — Флаг ошибки
• errorText string — Описание ошибки

Структура 401:

• title string — Заголовок ошибки
• detail string — Детали ошибки
• code string — Внутренний код ошибки
• requestId string — Уникальный ID запроса
• origin string — ID внутреннего сервиса WB
• status number — HTTP статус-код
• statusText string — Расшифровка HTTP статус-кода
• timestamp string — Дата и время запроса

Структура 402:

• title string — Заголовок ошибки
• detail string — Детали ошибки. Ошибка возвращается только сервисам из Каталога решений для бизнеса

Структура 403:

• additionalErrors object — Дополнительные ошибки
• data object — Данные ошибки
• error boolean — Флаг ошибки
• errorText string — Описание ошибки

Структура 409:

• additionalErrors object — Дополнительные ошибки
• data object — Данные ошибки
• error boolean — Флаг ошибки
• errorText string — Описание ошибки

Структура 422:

• additionalErrors object — Дополнительные ошибки
• data object — Данные ошибки
• error boolean — Флаг ошибки
• errorText string — Описание ошибки

Структура 429:

• title string — Заголовок ошибки
• detail string — Детали ошибки
• code string — Внутренний код ошибки
• requestId string — Уникальный ID запроса
• origin string — ID внутреннего сервиса WB
• status number — HTTP статус-код
• statusText string — Расшифровка HTTP статус-кода
• timestamp string — Дата и время запроса

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

Аргументы показаны именами параметров — подставьте свои значения. Языки, в клиенте которых этой операции нет, не показаны.

Python

from wb_api_client.items import Configuration, ApiClient
from wb_api_client.items.api import ItemsApi

cfg = Configuration(access_token="<ваш JWT WB>")
api = ItemsApi(ApiClient(cfg))

result = api.post_v3_media_save(post_v3_media_save_request=...)
print(result)

TypeScript

import {
  Configuration,
  ItemsApi,
} from "@valeryverkhoturov/wb-api-client/items";

const cfg = new Configuration({});
cfg.setAccessToken("<ваш JWT WB>");
const api = new ItemsApi(cfg);

const { data } = await api.postV3MediaSave(postV3MediaSaveRequest);
console.log(data);

Go

import (
	"context"
	"fmt"

	wbitems "github.com/ValeryVerkhoturov/wb-api-client-go/items"
)

cfg := wbitems.NewConfiguration()
cfg.SetAccessToken("<ваш JWT WB>")
client := wbitems.NewAPIClient(cfg)

result, _, err := client.ItemsAPI.PostV3MediaSave(context.Background()).PostV3MediaSaveRequest(postV3MediaSaveRequest).Execute()
if err != nil {
    panic(err)
}
fmt.Printf("%+v\n", result)

Java

import io.github.valeryverkhoturov.wbapi.items.ApiClient;
import io.github.valeryverkhoturov.wbapi.items.SecretString;
import io.github.valeryverkhoturov.wbapi.items.api.ItemsApi;

ApiClient client = new ApiClient();
client.setAccessToken(new SecretString("<ваш JWT WB>"));
ItemsApi api = new ItemsApi(client);

System.out.println(api.postV3MediaSave(postV3MediaSaveRequest));

PHP

use ValeryVerkhoturov\WbApiClient\Items\Configuration;
use ValeryVerkhoturov\WbApiClient\Items\SecretString;
use ValeryVerkhoturov\WbApiClient\Items\Api\ItemsApi;
use GuzzleHttp\Client;

$config = (new Configuration())
    ->setAccessTokenSecret(new SecretString('<ваш JWT WB>'));
$api = new ItemsApi(new Client(), $config);

print_r($api->postV3MediaSave($post_v3_media_save_request));

OneScript

#Использовать "wb-api-client"

Настройки = Новый Конфигурация();
Настройки.УстановитьТокен("<ваш JWT WB>");
Клиент = Новый ItemsApi(Настройки);

Сообщить(Клиент.PostV3MediaSave(Тело).Тело);

C#

using ValeryVerkhoturov.WbApiClient.Items.Api;
using ValeryVerkhoturov.WbApiClient.Items.Client;

var config = new Configuration();
config.AccessTokenSecret = new SecretString("<ваш JWT WB>");
var api = new ItemsApi(config);

Console.WriteLine(api.PostV3MediaSave(postV3MediaSaveRequest));

Rust

use wb_api_client::items::apis::{configuration::Configuration, items_api};

#[tokio::main]
async fn main() {
    let mut cfg = Configuration::new();
    cfg.set_access_token("<ваш JWT WB>");

    let result = items_api::post_v3_media_save(&cfg, post_v3_media_save_request).await;
    println!("{:#?}", result);
}