Что нужно для начала

Прежде чем отправить первый запрос, убедитесь, что у вас есть:

• Токен доступа — создайте его в личном кабинете WB Партнёры. Подробная инструкция — в статье «Создание, обновление и удаление токена». Для безопасного тестирования подойдёт тестовый токен — он работает с песочницей и не затрагивает реальные данные
• Инструмент для отправки запросов — curl (командная строка), Postman, Swagger на портале или любой HTTP-клиент в вашем языке программирования

---

Шаг 1. Проверьте подключение (/ping)

Начните с простейшего запроса — метод /ping проверяет, что токен работает и API доступен. Он не возвращает данных и не изменяет ничего в магазине.

curl -X GET "https://common-api.wildberries.ru/ping" \
  -H "Authorization: Bearer ВАШ_ТОКЕН"

Если всё настроено правильно, API вернёт:

{
  "Status": "OK",
  "TS": "2026-04-03T10:00:00Z"
}

Если вы получили ошибку — проверьте:

Подробнее об ошибках — в статье «Расшифровка кодов ошибок WB API».

---

Шаг 2. Найдите нужный метод

Откройте документацию на портале разработчиков и выберите категорию API, соответствующую вашей задаче. Для каждого метода в документации указаны:

• HTTP-метод (GET, POST, PUT, PATCH, DELETE)
• URL — домен категории + путь
• Параметры — query-параметры (в URL) и/или тело запроса (JSON)
• Ответ — структура данных, которую вернёт API

Подробнее о навигации по документации — в статье «Как пользоваться документацией WB API».

---

Шаг 3. Отправьте GET-запрос

GET-запросы получают данные, не изменяя ничего. Параметры передаются в URL.

Пример: получить информацию о продавце

curl -X GET "https://common-api.wildberries.ru/api/v1/seller-info" \
  -H "Authorization: Bearer ВАШ_ТОКЕН"

API вернёт JSON с данными:

{
  "name": "ООО Пример",
  "sid": "abc123-..."
}

Пример: GET с параметрами

Многие GET-методы принимают фильтры через query-параметры. Они указываются в URL после ?, разделяются &:

curl -X GET "https://common-api.wildberries.ru/api/communications/v2/news?from=2026-04-01&limit=10" \
  -H "Authorization: Bearer ВАШ_ТОКЕН"

---

Шаг 4. Отправьте POST-запрос

POST-запросы создают или передают данные. Параметры передаются в теле запроса в формате JSON.

Пример: POST с JSON-телом

curl -X POST "https://content-api.wildberries.ru/content/v2/get/cards/list" \
  -H "Authorization: Bearer ВАШ_ТОКЕН" \
  -H "Content-Type: application/json" \
  -d '{
    "settings": {
      "cursor": {
        "limit": 10
      },
      "filter": {
        "withPhoto": -1
      }
    }
  }'

Обратите внимание на дополнительный заголовок Content-Type: application/json — он обязателен для POST-запросов с телом в формате JSON.

---

Шаг 5. Прочитайте ответ

Каждый ответ API содержит:

HTTP-код статуса — число, указывающее результат:

• 200 — успех, данные в теле ответа
• 201 — ресурс создан
• 204 — действие выполнено, тело ответа пустое
• 4XX — ошибка в вашем запросе
• 5XX — ошибка на стороне сервера

Тело ответа — данные в формате JSON (для кодов 200, 201) или описание ошибки (для кодов 4XX).

Заголовки ответа — служебная информация. Особенно полезен X-Ratelimit-Remaining — количество запросов, которые можно отправить без паузы. Подробнее — в статье «Лимиты запросов WB API».

---

Частые ошибки при первых запросах

---

Что дальше

• Попробуйте Swagger — интерактивная документация позволяет отправлять запросы прямо в браузере. Подробнее — в статье «Swagger: интерактивная документация WB API»
• Разберитесь с пагинацией — если API возвращает много данных, их нужно получать порциями. Подробнее — в статье «Пагинация и работа с большими данными»
• Изучите лимиты — каждый метод имеет ограничения на количество запросов. Подробнее — в статье «Лимиты запросов WB API»
• Настройте обработку ошибок — коды ответов и форматы сообщений. Подробнее — в статье «Расшифровка кодов ошибок WB API»