wb-api-client

README

wb-api-client

OpenAPI-first Go client for Wildberries API (v1 scope):

• General
• Product Management
• FBS Orders
• DBW Orders
• DBS Orders

Architecture

• specs/wb/: pinned Swagger/OpenAPI specs.
• internal/generated/<category>: generated clients (source of truth).
• client/: ergonomic service facade over generated clients.
• transport/: retry/rate-limit middleware + unified API errors.
• internal/testkit/: HTTP/JSON test helpers.

Facade Coverage

• Products:
  • Create and update cards (/content/v2/cards/upload, /content/v2/cards/update, /content/v2/cards/upload/add)
  • Get cards list
  • Get products with prices (/api/v2/list/goods/filter, GET and POST)
  • Get size prices by article (/api/v2/list/goods/size/nm)
  • Set prices and size prices (/api/v2/upload/task, /api/v2/upload/task/size)
  • Track processed price uploads (/api/v2/history/goods/task)
  • Get and update inventory (/api/v3/stocks/{warehouseId})
• FBS Orders:
  • Get new orders and orders list
  • Get order statuses and status history
  • Cancel order
• DBW Orders:
  • Get new orders and completed orders list
  • Get order statuses
  • Confirm, assemble and cancel orders
• DBS Orders:
  • Get new orders and completed orders list
  • Get order statuses (status/info)
  • Confirm, deliver, receive, reject and cancel orders

By default, generated server mappings are preserved (including multi-host categories like Products). With*BaseURL options explicitly override all operation servers in that category.

Public Types

External projects should import only github.com/benice2me11/wb-api-client/client. The facade exposes request/response aliases in client (for example, client.ContentV2GetCardsListPostRequest), so there is no need to import internal/generated/*.

Regenerate Client Code

Requirements:

• Docker

Run:

make generate

The generator is pinned in scripts/generate.sh (openapitools/openapi-generator-cli:v7.13.0).

To ensure generated files are up-to-date:

make verify-generated