# wb-api-client

> Автоматически сгенерированные клиенты Wildberries Seller API для Python, TypeScript, Go, Java, PHP, OneScript, C# и Rust. Одна версия на все восемь экосистем, bearer-токен маскируется по умолчанию.

Любая страница сайта доступна в Markdown по её адресу с суффиксом `.md` — например `guides/quickstart.md`. Это относится и к 310 страницам справочника API, которые ниже не перечислены поштучно: страница модуля перечисляет все свои операции.

## Руководства

- [Быстрый старт](https://valeryverkhoturov.github.io/wb-api-client-docs/guides/quickstart.md): Пять минут: получить токен, установить клиент для своего языка, сделать первый вызов.
- [Аутентификация](https://valeryverkhoturov.github.io/wb-api-client-docs/guides/authentication.md): Каждый вызов Wildberries Seller API требует bearer JWT в заголовке Authorization. Клиенты сами подставляют заголовок; вы передаёте только токен.
- [Обработка ошибок](https://valeryverkhoturov.github.io/wb-api-client-docs/guides/error-handling.md): WB возвращает стандартные HTTP-коды и JSON в теле. Клиенты превращают их в языко-нативные исключения — сырой Response вы получите только если явно об этом…
- [Свои заголовки](https://valeryverkhoturov.github.io/wb-api-client-docs/guides/custom-headers.md): Иногда к каждому запросу нужно добавить заголовок, которого нет в спецификации WB: креденшелы шлюза или корпоративного прокси, стоящего перед API,…

## Клиенты

- [Python](https://valeryverkhoturov.github.io/wb-api-client-docs/languages/python.md): Python-клиент Wildberries Seller API: пакет valeryverkhoturov-wb-api-client с PyPI, 13 категорий API, маскирование токена.
- [TypeScript](https://valeryverkhoturov.github.io/wb-api-client-docs/languages/typescript.md): TypeScript-клиент Wildberries Seller API: пакет @valeryverkhoturov/wb-api-client с npm, типы .d.ts, axios, 13 категорий API.
- [Go](https://valeryverkhoturov.github.io/wb-api-client-docs/languages/go.md): Go-клиент Wildberries Seller API: модуль github.com/ValeryVerkhoturov/wb-api-client-go, 13 категорий API, маскирование bearer-токена.
- [Java](https://valeryverkhoturov.github.io/wb-api-client-docs/languages/java.md): Java-клиент Wildberries Seller API: координаты io.github.valeryverkhoturov:wb-api-client с Maven Central, 13 категорий API, маскирование токена.
- [PHP](https://valeryverkhoturov.github.io/wb-api-client-docs/languages/php.md): PHP-клиент Wildberries Seller API: пакет valeryverkhoturov/wb-api-client с Packagist, Guzzle, 13 категорий API, маскирование токена.
- [OneScript (1С)](https://valeryverkhoturov.github.io/wb-api-client-docs/languages/onescript.md): OneScript-клиент (1С) Wildberries Seller API: пакет wb-api-client с hub.oscript.io, 13 категорий API, маскирование bearer-токена.
- [C#](https://valeryverkhoturov.github.io/wb-api-client-docs/languages/csharp.md): C#-клиент Wildberries Seller API: пакет ValeryVerkhoturov.WbApiClient с NuGet, 13 категорий API, маскирование токена.
- [Rust](https://valeryverkhoturov.github.io/wb-api-client-docs/languages/rust.md): Rust-клиент Wildberries Seller API: крейт wb-api-client на crates.io, 13 категорий API, маскирование bearer-токена.

## Справочник

- [Версионирование](https://valeryverkhoturov.github.io/wb-api-client-docs/guides/versioning.md): Все восемь языковых пакетов делят одну версионную строку на релиз: 1.YYYYMMDD.N.
- [Архитектура](https://valeryverkhoturov.github.io/wb-api-client-docs/guides/architecture.md): Один экран о том, что реально лежит в основном репозитории, чтобы про сгенерированные клиенты ничего не казалось магией.
- [Участие в разработке](https://valeryverkhoturov.github.io/wb-api-client-docs/guides/contributing.md): Баги, странности спецификации, кривости генератора — заводите issue в основном репозитории кода: ValeryVerkhoturov/wb-api-client/issues.

## Справочник API

- [Справочник API](https://valeryverkhoturov.github.io/wb-api-client-docs/reference/api/index.md): Все 310 операций Wildberries Seller API, сгруппированные по 13 модулям пакета. Страницы генерируются из спецификаций OpenAPI и исходников сгенерированных клиентов, поэтому примеры вызова соответствуют коду той же версии.
- [Общее](https://valeryverkhoturov.github.io/wb-api-client-docs/reference/api/general/index.md): Операций модуля `general` — 11.
- [Работа с товарами](https://valeryverkhoturov.github.io/wb-api-client-docs/reference/api/items/index.md): Операций модуля `items` — 55.
- [Заказы FBS](https://valeryverkhoturov.github.io/wb-api-client-docs/reference/api/orders-fbs/index.md): Операций модуля `orders-fbs` — 48.
- [Заказы DBW](https://valeryverkhoturov.github.io/wb-api-client-docs/reference/api/orders-dbw/index.md): Операций модуля `orders-dbw` — 16.
- [DBS](https://valeryverkhoturov.github.io/wb-api-client-docs/reference/api/dbs/index.md): Операций модуля `dbs` — 21.
- [Самовывоз](https://valeryverkhoturov.github.io/wb-api-client-docs/reference/api/in-store-pickup/index.md): Операций модуля `in-store-pickup` — 18.
- [Поставки FBW](https://valeryverkhoturov.github.io/wb-api-client-docs/reference/api/orders-fbw/index.md): Операций модуля `orders-fbw` — 14.
- [Маркетинг и продвижение](https://valeryverkhoturov.github.io/wb-api-client-docs/reference/api/promotion/index.md): Операций модуля `promotion` — 43.
- [Общение с покупателями](https://valeryverkhoturov.github.io/wb-api-client-docs/reference/api/communications/index.md): Операций модуля `communications` — 25.
- [Тарифы](https://valeryverkhoturov.github.io/wb-api-client-docs/reference/api/rates/index.md): Операций модуля `rates` — 5.
- [Аналитика и данные](https://valeryverkhoturov.github.io/wb-api-client-docs/reference/api/analytics/index.md): Операций модуля `analytics` — 20.
- [Отчёты](https://valeryverkhoturov.github.io/wb-api-client-docs/reference/api/reports/index.md): Операций модуля `reports` — 23.
- [Документы и бухгалтерия](https://valeryverkhoturov.github.io/wb-api-client-docs/reference/api/finances/index.md): Операций модуля `finances` — 11.

## Пакеты

- [Python](https://pypi.org/project/valeryverkhoturov-wb-api-client/): `pip install valeryverkhoturov-wb-api-client`
- [TypeScript](https://www.npmjs.com/package/@valeryverkhoturov/wb-api-client): `npm install @valeryverkhoturov/wb-api-client`
- [Go](https://pkg.go.dev/github.com/ValeryVerkhoturov/wb-api-client-go): `go get github.com/ValeryVerkhoturov/wb-api-client-go@latest`
- [Java](https://central.sonatype.com/artifact/io.github.valeryverkhoturov/wb-api-client): `Maven Central: io.github.valeryverkhoturov:wb-api-client`
- [PHP](https://packagist.org/packages/valeryverkhoturov/wb-api-client): `composer require valeryverkhoturov/wb-api-client`
- [OneScript](https://hub.oscript.io/pools/default/packages/wb-api-client): `opm install wb-api-client`
- [C#](https://www.nuget.org/packages/ValeryVerkhoturov.WbApiClient): `dotnet add package ValeryVerkhoturov.WbApiClient`
- [Rust](https://crates.io/crates/wb-api-client): `cargo add wb-api-client`

## Optional

- [llms-full.txt](https://valeryverkhoturov.github.io/wb-api-client-docs/llms-full.txt): Все обзорные страницы одним файлом, без справочника по операциям
- [llms.txt](https://valeryverkhoturov.github.io/wb-api-client-docs/en/llms.txt): The same index in English