Перейти к содержанию

Загрузить медиафайл

POST /content/v3/media/file

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

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

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

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

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

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

Параметры

Имя Расположение Тип Обязательный Описание
X-Nm-Id header string да Артикул WB
X-Photo-Number header integer да Номер медиафайла на загрузку, начинается с 1. При загрузке видео всегда указывайте 1. Чтобы добавить изображение к уже загруженным, номер медиафайла должен быть больше количества уже загруженных медиафайлов.

Ответ: object

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

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_file(X-Nm-Id=..., X-Photo-Number=...)
print(result)

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

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

cfg := items.NewConfiguration()
cfg.AddDefaultHeader("Authorization", os.Getenv("WB_API_TOKEN"))
client := items.NewAPIClient(cfg)
result, _, err := client.DefaultApi.PostV3MediaFile(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->postV3MediaFile(..., ...);

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_file(&config, ...).await?;