Wildberries API на Python: выгружаем остатки товаров в CSV

Wildberries API можно освоить на одном небольшом проекте, если сразу видеть вход, действие и результат. Остатки из API можно превратить в обычный CSV, который открывается в Excel и подходит для первого полезного проекта автоматизации. Ниже вы соберёте работающий пример и проверите обычный и граничный сценарии.

Токен продавца нельзя вставлять в пример, а реальная структура ответа, пагинация и лимиты отличаются между методами API. Поэтому отделим настройку, входные данные, основное действие и проверку. В этой статье вы соберёте скрипт с отдельной функцией преобразования ответа в строки CSV и безопасным сетевым слоем. Проверка: фикстура JSON превращается в таблицу, пустой список создаёт только заголовок, а HTTP-ошибка не затирает прошлый файл.

Как устроен учебный проект Wildberries API

Wildberries API разделяет подготовку, основное действие, проверку ответа и сохранение результата. Держите ввод, логику и отображение раздельно: тогда каждый этап можно проверить отдельно.

Контрольные точки: метод, запрос, преобразование и csv. Следующий шаг начинается после совпадения с ожидаемым результатом.

От входных данных до видимого результата. Сначала проверяется вход, затем действие и только потом интерфейс.

Собираем рабочий пример шаг за шагом

Материал сверялся с официальной документацией сервиса 21 октября 2026 года. Установите httpx, задайте WB_API_TOKEN и сверьте endpoint с текущим разделом официальной документации. Проверьте текущую папку через pwd или Get-Location. Вставьте пример целиком, выполните один раз, затем разбирайте по частям.

import csv
import os
from pathlib import Path
import httpx

TOKEN = os.environ["WB_API_TOKEN"]
URL = os.environ["WB_STOCKS_URL"]

def rows_from_payload(payload: list[dict]):
    for item in payload:
        yield {
            "nm_id": item.get("nmId"),
            "warehouse": item.get("warehouseName", ""),
            "quantity": item.get("quantity", 0),
            "in_way": item.get("inWayToClient", 0),
        }

def download() -> list[dict]:
    response = httpx.get(URL, headers={"Authorization": TOKEN}, timeout=30)
    response.raise_for_status()
    return response.json()

def save_csv(items: list[dict], filename='wb-stocks.csv'):
    target = Path(filename)
    temp = target.with_suffix('.tmp')
    fields = ['nm_id', 'warehouse', 'quantity', 'in_way']
    with temp.open('w', newline='', encoding='utf-8-sig') as file:
        writer = csv.DictWriter(file, fieldnames=fields)
        writer.writeheader(); writer.writerows(rows_from_payload(items))
    temp.replace(target)

if __name__ == '__main__':
    save_csv(download())

Код держит подготовку отдельно от внешнего действия, поэтому ошибку можно найти на конкретном шаге. Найдите в примере вход, проверку и место формирования результата.

Что отличает устойчивый проект от случайного запуска. Явные границы делают ошибку локальной и понятной.

Что происходит внутри и почему это работает

HTTP-слой получает сырые данные, генератор rows_from_payload нормализует поля, а CSV-слой ничего не знает о токене и сети. Логику держите отдельно от вывода: функция получает аргумент и возвращает значение, а интерфейс показывает его. Секреты и персональные данные не должны попадать в репозиторий, журнал или публичный скриншот.

Не угадывайте endpoint по старому блогу: WB API разделён на категории и меняется. Храните URL или версию рядом с конфигурацией, а поля ответа сверяйте с текущей схемой метода. Не прячьте поток в одном обработчике: сохраните вход, проверьте его, вызовите операцию и только затем обновите интерфейс.

Проверяем проект и добавляем свою функцию

Добавьте колонку доступного остатка, фильтр quantity ниже порога и отдельный CSV дефицита. До правки запишите ожидаемое поведение одним предложением. После граничного теста повторите обычный сценарий.

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

Четыре проверки перед следующим шагом. Каждый следующий этап начинается после наблюдаемого результата.

Что запомнить и куда двигаться дальше

Для расписания добавьте безопасный секрет CI, повтор только временных ошибок и отметку времени отчёта. Для закрепления откройте в анализе CSV через pandas, в автоматизации Excel и в отчёте Ozon Seller.

Как изучить тему в Кодике

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

Перепишите ключевую функцию по памяти и проверьте её на корректном, пустом и ошибочном вводе. Базовый синтаксис закрепите через курс Python.

Что получится в итоге

Финальный экран показывает результат, состояние запроса и понятное сообщение об ошибке без раскрытия секретов.