Загрузка фото через API Wildberries: как устроен media/save и почему он заменяет весь набор

Два способа загрузить медиа

Первый — загрузка одного файла в конкретный слот: файл уходит телом запроса, номер слота — в заголовке. Второй — сохранение набора по ссылкам: передаётся список URL, площадка сама скачивает файлы и собирает из них галерею. Ссылка должна оканчиваться именем файла с расширением, а файл — быть доступен без авторизации.

Полная замена набора

Сохранение по ссылкам **заменяет** текущий набор медиа карточки целиком. Передали одну новую ссылку — в карточке останется одно фото, старые исчезнут. Чтобы добавить фото, нужно передать все старые ссылки вместе с новыми в нужном порядке. Это самая частая причина «пропали фото после интеграции».

Поэтому конвейер перед боевой заливкой делает сухой прогон: показывает точный запрос, который уйдёт, — со всеми ссылками и порядком, — и только после подтверждения отправляет. По умолчанию заливка выключена.

Лимиты и повторы

Контент-методы API ограничены примерно сотней запросов в минуту на аккаунт. При массовой выгрузке это упирается быстро; правильная стратегия — очередь с ограничителем скорости и повтор с растущей задержкой при ответе о превышении. Без этого выгрузка каталога на сто товаров обрывается посередине, и часть карточек остаётся без фото.

Проверка перед заливкой

• Все файлы доступны по ссылке без авторизации и оканчиваются расширением.
• Разрешение и формат соответствуют требованиям, профиль sRGB.
• В наборе — старые ссылки плюс новые, в нужном порядке; главное фото первым.
• Сухой прогон просмотрен: видно, что именно уйдёт.