Wildberries SDK-клиенты для Python, Node.js, Go, PHP и Rust, постоянно актуальные в соответствии с OpenAPI-спецификациями. 🌐 Русский · English · 简体中文 · Türkçe · Қазақша · Oʻzbekcha 📖 Документация: — справочник по всем операциям API Wildberries с примерами на Python, Node.js, Go, PHP и Rust. 📡 Изменения API в Telegram: @wildberriesapiradar — пост о каждом обновлении спецификаций Wildberries: новые методы, лимиты,…
После установки агент сам находит нужную операцию среди ~350, подбирает модуль, категорию токена и хост и пишет вызов, который действительно работает. Агентам без Claude Code пригодятся AGENTS.md в корне и машиночитаемый перечень операций: llms.txt, llms-full.txt.
Безопасность
SDK выпускается с security-first процессом:
статический анализ кода CodeQL
оценка по OpenSSF Scorecard
сканирование секретов TruffleHog (verified-режим)
аудит зависимостей Python (pip-audit)
npm audit
Composer audit
Cargo audit
проверка уязвимостей Go (govulncheck)
в опубликованных пакетах нет захардкоженных API-токенов
Поддерживаются все доступные на текущий момент команды API Wildberries, разделённые по спецификациям.
Описание SDK-клиентов
Полная типизация запросов и ответов. В каждом языке клиент использует нативную систему типов: pydantic в Python, TypeScript-интерфейсы в Node.js, struct-ы в Go, типизированные классы в PHP, serde-структуры в Rust. Опечатки в полях и неверные типы ловятся ещё при компиляции/линтинге.
Автодополнение в IDE из коробки. Имена методов, параметры, поля моделей и значения enum-ов подсвечиваются и подсказываются — без чтения документации WB.
Описания и docstring-и из спецификаций. Комментарии WB по полям и методам переносятся в код, всплывают при наведении в IDE.
Валидация на стороне клиента. Обязательные поля и типы проверяются до отправки запроса. В Python pydantic дополнительно валидирует форматы, enum-значения и ограничения min/max; в Go, TypeScript, PHP и Rust проверка ограничивается обязательными полями и типами.
Один контракт во всех языках. Имена операций, поля моделей и эндпоинты идентичны в Python, Node.js, Go, PHP и Rust — миграция между стеками без переписывания бизнес-логики.
Никакого дрейфа со спецификациями. Когда WB обновляет API, ваш SDK получает новые методы и модели с PR того же дня — не нужно вручную вычислять, что изменилось.
Готовый transport-слой. Аутентификация, заголовки, базовые URL, сериализация JSON, обработка HTTP-ошибок — реализованы один раз в стандартном api_client и переиспользуются всеми методами.
Автоматическая клиенты поддерживаются в актуальном состоянии с помощью GitHub Actions при обновлении спецификаций.
POST /api/marketplace/v3/fbs/settings/autoreturns/items — Получить настройки автовозврата товаров (postV3FbsSettingsAutoreturnsItems)
PATCH /api/marketplace/v3/fbs/settings/autoreturns/items — Обновить настройки автовозврата товаров (patchV3FbsSettingsAutoreturnsItems)
GET /api/marketplace/v3/fbs/settings/autoreturns/subcategories/restricted — Получить предметы, которые не хранятся на складах WB (getV3FbsSettingsAutoreturnsSubcategoriesRestricted)
GET /api/marketplace/v3/fbs/shipping-points — Получить список пунктов отгрузки поставок (getV3FbsShippingPoints)
PATCH /api/marketplace/v3/fbs/supplies/shipping-method — Установить параметры отгрузки поставок (patchV3FbsSuppliesShippingMethod)
POST /api/marketplace/v3/fbs/supplies/spot/list — Получить данные СПОТ для списка поставок (postV3FbsSuppliesSpotList)
PATCH /api/marketplace/v3/fbs/supplies/{supplyId}/orders/transfer — Перевести сборочные задания из доставки на сборку (patchV3FbsSuppliesSupplyIdOrdersTransfer)
GET /api/marketplace/v3/fbs/supplies/{supplyId}/shipping-points — Получить список пунктов отгрузки поставки (getV3FbsSuppliesSupplyIdShippingPoints)
PUT /api/marketplace/v3/fbs/supplies/{supplyId}/spot — Добавить данные СПОТ в поставку (putV3FbsSuppliesSupplyIdSpot)
GET /api/marketplace/v3/fbs/supplies/{supplyId}/stickers/spot — Получить QR-код СПОТ (getV3FbsSuppliesSupplyIdStickersSpot)
POST /api/marketplace/v3/orders/meta — Получить идентификаторы маркировки сборочных заданий (postV3OrdersMeta)
PUT /api/marketplace/v3/orders/{orderId}/meta/customs-declaration — Закрепить номер ДТ за сборочным заданием (putV3OrdersOrderIdMetaCustomsDeclaration)
GET /api/marketplace/v3/supplies/{supplyId}/order-ids — Получить ID сборочных заданий поставки (getV3SuppliesSupplyIdOrderIds)
PATCH /api/marketplace/v3/supplies/{supplyId}/orders — Добавить сборочные задания к поставке (patchV3SuppliesSupplyIdOrders)
GET /api/v3/orders — Получить информацию о сборочных заданиях (getV3Orders)
POST /api/v3/orders/client — Заказы с информацией по клиенту (postV3OrdersClient)
GET /api/v3/orders/new — Получить список новых сборочных заданий (getV3OrdersNew)
POST /api/v3/orders/status — Получить статусы сборочных заданий (postV3OrdersStatus)
POST /api/v3/orders/status/history — История статусов для сборочных заданий трансграничных поставок (postV3OrdersStatusHistory)
POST /api/v3/orders/stickers — Получить стикеры сборочных заданий (postV3OrdersStickers)
POST /api/v3/orders/stickers/cross-border — Получить стикеры сборочных заданий трансграничных поставок (postV3OrdersStickersCrossBorder)
PATCH /api/v3/dbw/orders/{orderId}/confirm — Перевести на сборку (patchV3DbwOrdersOrderIdConfirm)
PUT /api/v3/dbw/orders/{orderId}/meta/gtin — Закрепить GTIN за сборочным заданием (putV3DbwOrdersOrderIdMetaGtin)
PUT /api/v3/dbw/orders/{orderId}/meta/imei — Закрепить IMEI за сборочным заданием (putV3DbwOrdersOrderIdMetaImei)
PUT /api/v3/dbw/orders/{orderId}/meta/uin — Закрепить УИН за сборочным заданием (putV3DbwOrdersOrderIdMetaUin)
DBS (05-dbs.yaml)
POST /api/marketplace/v3/dbs/orders/b2b/info — Информация о покупателе B2B (postV3DbsOrdersB2bInfo)
POST /api/marketplace/v3/dbs/orders/final-price — Получить цены продавца и суммы к оплате (postV3DbsOrdersFinalPrice)
POST /api/marketplace/v3/dbs/orders/meta/customs-declaration — Закрепить номера ДТ за сборочными заданиями (postV3DbsOrdersMetaCustomsDeclaration)
POST /api/marketplace/v3/dbs/orders/meta/delete — Удалить идентификаторы маркировки сборочных заданий (postV3DbsOrdersMetaDelete)
POST /api/marketplace/v3/dbs/orders/meta/details — Получить идентификаторы маркировки сборочных заданий (postV3DbsOrdersMetaDetails)
POST /api/marketplace/v3/dbs/orders/meta/gtin — Закрепить GTIN за сборочными заданиями (postV3DbsOrdersMetaGtin)
POST /api/marketplace/v3/dbs/orders/meta/imei — Закрепить IMEI за сборочными заданиями (postV3DbsOrdersMetaImei)
POST /api/marketplace/v3/dbs/orders/meta/sgtin — Закрепить коды маркировки Честного знака за сборочными заданиями (postV3DbsOrdersMetaSgtin)
POST /api/marketplace/v3/dbs/orders/meta/uin — Закрепить УИН за сборочными заданиями (postV3DbsOrdersMetaUin)
POST /api/marketplace/v3/dbs/orders/status/cancel — Отменить сборочные задания (postV3DbsOrdersStatusCancel)
POST /api/marketplace/v3/dbs/orders/status/confirm — Перевести сборочные задания на сборку (postV3DbsOrdersStatusConfirm)
POST /api/marketplace/v3/dbs/orders/status/deliver — Перевести сборочные задания в доставку (postV3DbsOrdersStatusDeliver)
POST /api/marketplace/v3/dbs/orders/status/info — Получить статусы сборочных заданий (postV3DbsOrdersStatusInfo)
POST /api/marketplace/v3/dbs/orders/status/receive — Сообщить о получении заказов (postV3DbsOrdersStatusReceive)
POST /api/marketplace/v3/dbs/orders/status/reject — Сообщить об отказе от заказов (postV3DbsOrdersStatusReject)
POST /api/marketplace/v3/dbs/orders/stickers — Получить стикеры для сборочных заданий с доставкой в ПВЗ (postV3DbsOrdersStickers)
POST /api/v3/dbs/groups/info — Получить информацию о платной доставке (postV3DbsGroupsInfo)
GET /api/v3/dbs/orders — Получить информацию о завершенных сборочных заданиях (getV3DbsOrders)
POST /api/v3/dbs/orders/client — Информация о покупателе (postV3DbsOrdersClient)
POST /api/v3/dbs/orders/delivery-date — Получить дату и время доставки (postV3DbsOrdersDeliveryDate)
GET /api/v3/dbs/orders/new — Получить список новых сборочных заданий (getV3DbsOrdersNew)
Самовывоз (06-in-store-pickup.yaml)
POST /api/marketplace/v3/click-collect/orders/final-price — Получить цены продавца и суммы к оплате (postV3ClickCollectOrdersFinalPrice)
POST /api/marketplace/v3/click-collect/orders/meta/customs-declaration — Закрепить номера ДТ за сборочными заданиями (postV3ClickCollectOrdersMetaCustomsDeclaration)
POST /api/marketplace/v3/click-collect/orders/meta/delete — Удалить идентификаторы маркировки сборочных заданий (postV3ClickCollectOrdersMetaDelete)
POST /api/marketplace/v3/click-collect/orders/meta/details — Получить идентификаторы маркировки сборочных заданий (postV3ClickCollectOrdersMetaDetails)
POST /api/marketplace/v3/click-collect/orders/meta/gtin — Закрепить GTIN за сборочными заданиями (postV3ClickCollectOrdersMetaGtin)
POST /api/marketplace/v3/click-collect/orders/meta/imei — Закрепить IMEI за сборочными заданиями (postV3ClickCollectOrdersMetaImei)
POST /api/marketplace/v3/click-collect/orders/meta/sgtin — Закрепить коды маркировки Честного знака за сборочными заданиями (postV3ClickCollectOrdersMetaSgtin)
POST /api/marketplace/v3/click-collect/orders/meta/uin — Закрепить УИН за сборочными заданиями (postV3ClickCollectOrdersMetaUin)
POST /api/marketplace/v3/click-collect/orders/status/cancel — Отменить сборочные задания (postV3ClickCollectOrdersStatusCancel)
POST /api/marketplace/v3/click-collect/orders/status/confirm — Перевести сборочные задания на сборку (postV3ClickCollectOrdersStatusConfirm)
POST /api/marketplace/v3/click-collect/orders/status/info — Получить статусы сборочных заданий (postV3ClickCollectOrdersStatusInfo)
POST /api/marketplace/v3/click-collect/orders/status/prepare — Сообщить, что сборочные задания готовы к выдаче (postV3ClickCollectOrdersStatusPrepare)
POST /api/marketplace/v3/click-collect/orders/status/receive — Сообщить, что заказы приняты покупателями (postV3ClickCollectOrdersStatusReceive)
POST /api/marketplace/v3/click-collect/orders/status/reject — Сообщить об отказе от заказов (postV3ClickCollectOrdersStatusReject)
GET /api/v3/click-collect/orders — Получить информацию о завершённых сборочных заданиях (getV3ClickCollectOrders)
POST /api/v3/click-collect/orders/client — Информация о покупателе (postV3ClickCollectOrdersClient)
POST /api/v3/click-collect/orders/client/identity — Проверить, что заказ принадлежит покупателю (postV3ClickCollectOrdersClientIdentity)
GET /api/v3/click-collect/orders/new — Получить список новых сборочных заданий (getV3ClickCollectOrdersNew)
Поставки FBW (07-orders-fbw.yaml)
GET /api/supplies/v1/discrepancies/{supplyId} — Расхождения в поставке (getV1SuppliesSupplyIdDiscrepanciesQuantity)
GET /api/supplies/v1/drafts — Список черновиков (getV1Drafts)
POST /api/supplies/v1/drafts — Создать черновик (postV1Drafts)
GET /api/feedbacks/v1/pins/count — Количество закреплённых и откреплённых отзывов (getV1PinsCount)
GET /api/feedbacks/v1/pins/limits — Лимиты закреплённых отзывов (getV1PinsLimits)
PATCH /api/v1/claim — Ответ на заявку покупателя (patchV1Claim)
GET /api/v1/claims — Заявки покупателей на возврат (getV1Claims)
GET /api/v1/feedback — Получить отзыв по ID (getV1Feedback)
GET /api/v1/feedbacks — Список отзывов (getV1Feedbacks)
POST /api/v1/feedbacks/answer — Ответить на отзыв (postV1FeedbacksAnswer)
PATCH /api/v1/feedbacks/answer — Отредактировать ответ на отзыв (patchV1FeedbacksAnswer)
GET /api/v1/feedbacks/archive — Список архивных отзывов (getV1FeedbacksArchive)
GET /api/v1/feedbacks/count — Количество отзывов (getV1FeedbacksCount)
GET /api/v1/feedbacks/count-unanswered — Необработанные отзывы (getV1FeedbacksCountUnanswered)
POST /api/v1/feedbacks/order/return — Возврат товара по ID отзыва (postV1FeedbacksOrderReturn)
GET /api/v1/new-feedbacks-questions — Непросмотренные отзывы и вопросы (getV1NewFeedbacksQuestions)
GET /api/v1/question — Получить вопрос по ID (getV1Question)
GET /api/v1/questions — Список вопросов (getV1Questions)
PATCH /api/v1/questions — Работа с вопросами (patchV1Questions)
GET /api/v1/questions/count — Количество вопросов (getV1QuestionsCount)
GET /api/v1/questions/count-unanswered — Неотвеченные вопросы (getV1QuestionsCountUnanswered)
GET /api/v1/seller/chats — Список чатов (getV1SellerChats)
GET /api/v1/seller/download/{id} — Получить файл из сообщения (getV1SellerDownloadId)
GET /api/v1/seller/events — События чатов (getV1SellerEvents)
POST /api/v1/seller/message — Отправить сообщение (postV1SellerMessage)
Тарифы (10-rates.yaml)
GET /api/tariffs/v1/acceptance/coefficients — Тарифы на поставку (getV1AcceptanceCoefficients)
GET /api/v1/tariffs/box — Тарифы для коробов (getV1TariffsBox)
GET /api/v1/tariffs/commission — Комиссия по категориям товаров (getV1TariffsCommission)
GET /api/v1/tariffs/pallet — Тарифы для монопаллет (getV1TariffsPallet)
GET /api/v1/tariffs/return — Тарифы на возврат (getV1TariffsReturn)
Аналитика и данные (11-analytics.yaml)
POST /api/analytics/v1/order-feed — Получить отчёт (postV1OrderFeed)
POST /api/analytics/v1/stocks-report/seller-warehouses — Остатки на складах продавца (postV1StocksReportSellerWarehouses)
POST /api/analytics/v1/stocks-report/wb-warehouses — Остатки на складах WB (postV1StocksReportWbWarehouses)
POST /api/analytics/v2/item-rating — Получить отчёт (postV2ItemRating)
POST /api/analytics/v3/sales-funnel/grouped/history — Статистика групп карточек товаров по дням (postV3SalesFunnelGroupedHistory)
POST /api/analytics/v3/sales-funnel/products — Статистика карточек товаров за период (postV3SalesFunnelProducts)
POST /api/analytics/v3/sales-funnel/products/history — Статистика карточек товаров по дням (postV3SalesFunnelProductsHistory)
GET /api/v2/nm-report/downloads — Получить список отчётов (getV2NmReportDownloads)
POST /api/v2/nm-report/downloads — Создать отчёт (postV2NmReportDownloads)
GET /api/v2/nm-report/downloads/file/{downloadId} — Получить отчёт (getV2NmReportDownloadsFileDownloadId)
POST /api/v2/nm-report/downloads/retry — Сгенерировать отчёт повторно (postV2NmReportDownloadsRetry)
POST /api/v2/search-report/product/orders — Заказы и позиции по поисковым запросам товара (postV2SearchReportProductOrders)
POST /api/v2/search-report/product/search-texts — Поисковые запросы по товару (postV2SearchReportProductSearchTexts)
POST /api/v2/search-report/report — Основная страница (postV2SearchReportReport)
POST /api/v2/search-report/table/details — Пагинация по товарам в группе (postV2SearchReportTableDetails)
POST /api/v2/search-report/table/groups — Пагинация по группам (postV2SearchReportTableGroups)
POST /api/v2/stocks-report/offices — Данные по складам (postV2StocksReportOffices)
POST /api/v2/stocks-report/products/groups — Данные по группам (postV2StocksReportProductsGroups)
POST /api/v2/stocks-report/products/products — Данные по товарам (postV2StocksReportProductsProducts)
POST /api/v2/stocks-report/products/sizes — Данные по размерам (postV2StocksReportProductsSizes)
Отчёты (12-reports.yaml)
GET /api/analytics/v1/deductions — Подмены и неверные вложения (getV1Deductions)
GET /api/analytics/v1/item-returns — Получить отчёт (getV1ItemReturns)
GET /api/analytics/v1/measurement-penalties — Удержания за занижение габаритов упаковки (getV1MeasurementPenalties)
GET /api/analytics/v1/warehouse-measurements — Замеры склада (getV1WarehouseMeasurements)
GET /api/v1/acceptance_report — Создать отчёт (getV1AcceptanceReport)
GET /api/v1/acceptance_report/tasks/{task_id}/download — Получить отчёт (getV1AcceptanceReportTasksTaskIdDownload)
GET /api/v1/acceptance_report/tasks/{task_id}/status — Проверить статус (getV1AcceptanceReportTasksTaskIdStatus)
GET /api/v1/analytics/antifraud-details — Самовыкупы (getV1AnalyticsAntifraudDetails)
GET /api/v1/analytics/banned-products/blocked — Получить отчёт (getV1AnalyticsBannedProducsBlocked)
GET /api/v1/analytics/brand-share — Получить отчёт (getV1AnalyticsBrandShare)
GET /api/v1/analytics/brand-share/brands — Бренды продавца (getV1AnalyticsBrandShareBrands)
GET /api/v1/analytics/brand-share/parent-subjects — Родительские категории бренда (getV1AnalyticsBrandShareParentSubjects)
POST /api/v1/analytics/excise-report — Получить отчёт (postV1AnalyticsExciseReport)
GET /api/v1/analytics/goods-labeling — Маркировка товара (getV1AnalyticsGoodsLabeling)
GET /api/v1/analytics/region-sale — Получить отчёт (getV1AnalyticsRegionSale)
GET /api/v1/paid_storage — Создать отчёт (getV1PaidStorage)
GET /api/v1/paid_storage/tasks/{task_id}/download — Получить отчёт (getV1PaidStorageTasksTaskIdDownload)
GET /api/v1/paid_storage/tasks/{task_id}/status — Проверить статус (getV1PaidStorageTasksTaskIdStatus)
GET /api/v1/supplier/orders — Заказы (getV1SupplierOrders)
GET /api/v1/supplier/sales — Продажи (getV1SupplierSales)
GET /api/v1/warehouse_remains — Создать отчёт (getV1WarehouseRemains)
GET /api/v1/warehouse_remains/tasks/{task_id}/download — Получить отчёт (getV1WarehouseRemainsTasksTaskIdDownload)
GET /api/v1/warehouse_remains/tasks/{task_id}/status — Проверить статус (getV1WarehouseRemainsTasksTaskIdStatus)
Документы и бухгалтерия (13-finances.yaml)
POST /api/finance/v1/acquiring/detailed — Детализации к отчётам об издержках на приём платежей за период (postV1AcquiringDetailed)
POST /api/finance/v1/acquiring/detailed/{reportId} — Детализации к отчётам об издержках на приём платежей по ID отчётов (postV1AcquiringDetailedReportId)
POST /api/finance/v1/acquiring/list — Список отчётов об издержках на приём платежей (postV1AcquiringList)
POST /api/finance/v1/sales-reports/detailed — Детализации к отчётам реализации за период (postV1SalesReportsDetailed)
POST /api/finance/v1/sales-reports/detailed/{reportId} — Детализации к отчётам реализации по ID отчётов (postV1SalesReportsDetailedReportId)
POST /api/finance/v1/sales-reports/list — Список отчётов реализации (postV1SalesReportsList)
GET /api/v1/account/balance — Получить баланс продавца (getV1AccountBalance)
GET /api/v1/documents/categories — Категории документов (getV1DocumentsCategories)
GET /api/v1/documents/download — Получить документ (getV1DocumentsDownload)
POST /api/v1/documents/download/all — Получить документы (postV1DocumentsDownloadAll)
GET /api/v1/documents/list — Список документов (getV1DocumentsList)
评论