Работа с Seller API — это не только HTTP-запросы. Нужно следить за версиями методов, описывать сотни типов, обрабатывать пагинацию, тайм-ауты и ошибки. А ещё — проверять реальные ответы API, потому что одних TypeScript-типов для этого недостаточно.

🎯 Какую проблему решает Seller SDK Официальная документация маркетплейса описывает HTTP-контракты, но не снимает с команды работу по интеграции. Для каждого метода приходится повторять авторизацию, описывать request и response, следить за deprecated-версиями, настраивать повторы и не допускать утечки credentials в логи и ошибки.

Если SDK покрывает только часть API, недостающие операции всё равно приходится вызывать вручную. Из-за этого в одном проекте появляются два разных способа работы с одним и тем же API.

Seller SDK собирает эту инфраструктуру в открытые ESM-пакеты для Node.js 20.10 и новее.

📚 Полное покрытие официальных контрактов В текущей версии описаны все операции из проверенных официальных контрактов Ozon и Wildberries. Это не выборка из наиболее популярных методов, а полные каталоги, которые проект сверяет с официальными источниками.

📦 @seller-sdk/ozon — 461 операция Ozon Seller API 📦 @seller-sdk/wb — 286 операций из 13 официальных OpenAPI-разделов Wildberries 🧩 seller-sdk — единая точка входа для приложений, которые работают с обеими площадками

Можно установить только нужную интеграцию: Для Ozon: npm i @seller-sdk/ozon Для Wildberries: npm i @seller-sdk/wb Для обеих площадок: npm i seller-sdk

Публичный API следует предметным областям самого маркетплейса. Например, товары Ozon доступны через ozon.products, а FBS-отправления — через ozon.postings.fbs. IDE подсказывает обязательные поля и допустимые значения.

🔎 Строгие типы и подсказки IntelliSense 🛡️ Проверка сетевых ответов через SafeShape ⏱️ Тайм-ауты, дедлайны и отмена запросов ♻️ Автоматические повторы только для безопасных операций 📄 Ленивые async-итераторы для пагинации 🚪 rawRequest для новых операций, которые ещё не попали в SDK 🔐 Безопасное представление ошибок без API-ключей и токенов

Seller SDK не пытается свести отличающиеся API к одной искусственной модели. Каждый пакет сохраняет семантику своего маркетплейса, а общий клиент только выбирает нужную реализацию.

🗺️ В планах — добавить отдельный пакет для API Яндекс Маркета. Сейчас SDK поддерживает Ozon и Wildberries.

Релиз 0.2.0 уже доступен в npm. Проект распространяется по лицензии MIT и не связан с Ozon или Wildberries. 🔗 GitHub: https://github.com/dev-ik/seller-sdk 🔗 Ozon: https://www.npmjs.com/package/@seller-sdk/ozon 🔗 Wildberries: https://www.npmjs.com/package/@seller-sdk/wb

#SellerSDK #TypeScript #NodeJS #API #Ozon #Wildberries #маркетплейсы #OpenSource #npm