Получить размеры товара с ценами
GET /api/v2/list/goods/size/nmБаза: https://discounts-prices-api.wildberries.ru · Модуль: items · Раздел: Цены и скидки · Документация спецификации ↗
Метод возвращает информацию обо всех размерах одного товара: цены, валюту, общие скидки и скидки для WB Клуба.
Работает только для товаров из категорий, где можно устанавливать цены отдельно для разных размеров. Для таких товаров "editableSizePrice":true.
Чтобы получить информацию о самом товаре, используйте отдельный метод.
Лимит запросов на один профиль продавца для всех методов категории Цены и скидки:
| Тип | Период | Лимит | Интервал | Всплеск |
|---|---|---|---|---|
| Персональный | 6 сек | 10 запросов | 600 мс | 5 запросов |
| Сервисный | 6 сек | 10 запросов | 600 мс | 5 запросов |
| Базовый с секретом | 6 сек | 10 запросов | 600 мс | 5 запросов |
| Базовый | 1 ч | 4 запроса | 15 мин | 1 запрос |
В песочнице — максимум 1 запрос в секунду суммарно для всех методов Контента.
Ответы
| Код | Описание | Схема |
|---|---|---|
200 | Успешно | object |
400 | Неправильный запрос | ResponseError |
401 | Не авторизован | object |
402 | Требуется платёж | object |
403 | Доступ запрещён | ResponseError |
429 | Слишком много запросов | object |
Структура 200:
dataobject— Данные ответаlistGoodsSizeGood[]— Размеры товараnmIDinteger<int64>— Артикул WBsizeIDinteger<int64>— ID размера. Можно получить с помощью метода Получение списка товаров по артикулам, полеsizeID. В методах Контента это полеchrtIDvendorCodestring— Артикул продавцаpriceinteger<int64>— ЦенаcurrencyIsoCode4217string— Валюта, по стандарту ISO 4217discountedPricenumber— Цена со скидкойclubDiscountedPricenumber— Цена со скидкой, включая скидку WB Клубаdiscountinteger<int64>— Скидка, %clubDiscountinteger<int64>— Скидка WB Клуба, %techSizeNamestring— Размер товараeditableSizePriceboolean— Можно ли устанавливать цены отдельно для разных размеров (зависит от категории товара): -true— можно -false— нельзя
errorboolean— Флаг ошибкиerrorTextstring— Описание ошибки
Структура 400:
dataobject— Данные ошибкиerrorboolean— Флаг ошибкиerrorTextstring— Описание ошибки
Структура 401:
titlestring— Заголовок ошибкиdetailstring— Детали ошибкиcodestring— Внутренний код ошибкиrequestIdstring— Уникальный ID запросаoriginstring— ID внутреннего сервиса WBstatusnumber— HTTP статус-кодstatusTextstring— Расшифровка HTTP статус-кодаtimestampstring— Дата и время запроса
Структура 402:
titlestring— Заголовок ошибкиdetailstring— Детали ошибки. Ошибка возвращается только сервисам из Каталога решений для бизнеса
Структура 403:
dataobject— Данные ошибкиerrorboolean— Флаг ошибкиerrorTextstring— Описание ошибки
Структура 429:
titlestring— Заголовок ошибкиdetailstring— Детали ошибкиcodestring— Внутренний код ошибкиrequestIdstring— Уникальный ID запросаoriginstring— ID внутреннего сервиса WBstatusnumber— HTTP статус-кодstatusTextstring— Расшифровка HTTP статус-кодаtimestampstring— Дата и время запроса
Примеры вызова
Аргументы показаны именами параметров — подставьте свои значения. Языки, в клиенте которых этой операции нет, не показаны.
from wb_api_client.items import Configuration, ApiClient
from wb_api_client.items.api import ItemsApi
cfg = Configuration(access_token="<ваш JWT WB>")
api = ItemsApi(ApiClient(cfg))
result = api.get_v2_list_goods_size_nm(limit=..., nm_id=..., offset=...)
print(result)import {
Configuration,
ItemsApi,
} from "@valeryverkhoturov/wb-api-client/items";
const cfg = new Configuration({});
cfg.setAccessToken("<ваш JWT WB>");
const api = new ItemsApi(cfg);
const { data } = await api.getV2ListGoodsSizeNm(limit, nmID, offset);
console.log(data);import (
"context"
"fmt"
wbitems "github.com/ValeryVerkhoturov/wb-api-client-go/items"
)
cfg := wbitems.NewConfiguration()
cfg.SetAccessToken("<ваш JWT WB>")
client := wbitems.NewAPIClient(cfg)
result, _, err := client.ItemsAPI.GetV2ListGoodsSizeNm(context.Background()).Execute()
if err != nil {
panic(err)
}
fmt.Printf("%+v\n", result)import io.github.valeryverkhoturov.wbapi.items.ApiClient;
import io.github.valeryverkhoturov.wbapi.items.SecretString;
import io.github.valeryverkhoturov.wbapi.items.api.ItemsApi;
ApiClient client = new ApiClient();
client.setAccessToken(new SecretString("<ваш JWT WB>"));
ItemsApi api = new ItemsApi(client);
System.out.println(api.getV2ListGoodsSizeNm(limit, nmID, offset));use ValeryVerkhoturov\WbApiClient\Items\Configuration;
use ValeryVerkhoturov\WbApiClient\Items\SecretString;
use ValeryVerkhoturov\WbApiClient\Items\Api\ItemsApi;
use GuzzleHttp\Client;
$config = (new Configuration())
->setAccessTokenSecret(new SecretString('<ваш JWT WB>'));
$api = new ItemsApi(new Client(), $config);
print_r($api->getV2ListGoodsSizeNm($limit, $nm_id));#Использовать "wb-api-client"
Настройки = Новый Конфигурация();
Настройки.УстановитьТокен("<ваш JWT WB>");
Клиент = Новый ItemsApi(Настройки);
Сообщить(Клиент.GetV2ListGoodsSizeNm(limit, nmID).Тело);using ValeryVerkhoturov.WbApiClient.Items.Api;
using ValeryVerkhoturov.WbApiClient.Items.Client;
var config = new Configuration();
config.AccessTokenSecret = new SecretString("<ваш JWT WB>");
var api = new ItemsApi(config);
Console.WriteLine(api.GetV2ListGoodsSizeNm(limit, nmID));use wb_api_client::items::apis::{configuration::Configuration, items_api};
#[tokio::main]
async fn main() {
let mut cfg = Configuration::new();
cfg.set_access_token("<ваш JWT WB>");
let result = items_api::get_v2_list_goods_size_nm(&cfg, limit, nm_id, offset).await;
println!("{:#?}", result);
}