Характеристики предмета

GET /content/v2/object/charcs/{subjectId}

База: https://content-api.wildberries.ru · Модуль: items · Раздел: Категории, предметы и характеристики · Документация спецификации ↗

Метод возвращает параметры характеристик предмета: названия, типы данных, единицы измерения и так далее. В запросе необходимо указать ID предмета.

Для получения значений характеристик Цвет, Пол, Страна производства, Сезон, Ставка НДС и ТНВЭД-код используйте отдельные методы

Лимит запросов на один профиль продавца для всех методов категории Контент:

Период	Лимит	Интервал	Всплеск
1 мин	100 запросов	600 мс	5 запросов
Исключение — методы:

• создания карточек товаров
• создания карточек товаров с присоединением
• редактирования карточек товаров
• восстановления карточек товаров из корзины
• получения списка рекомендаций в карточках товаров
• установки рекомендаций для товаров

---

В песочнице — максимум 1 запрос в секунду суммарно для всех методов Контента.

Параметры

Имя	Где	Тип	Обяз.	Описание
subjectId	path	integer<int64>	да	ID предмета
locale	query	string	нет	Язык полей ответа subjectName и name: - ru — русский - en — английский - zh — китайский Не используется в песочнице. Данные песочницы возвращаются только на русском языке

Ответы

Код	Описание	Схема
200	Успешно	GetV2ObjectCharcsSubjectIdResponse200
400	Неправильный запрос	object
401	Не авторизован	object
403	Доступ запрещён	responseBodyContentError403
429	Слишком много запросов	object

Структура 200:

• data object[] — Данные
  • charcID integer<int64> — ID характеристики
  • subjectName string — Название предмета
  • subjectID integer<int64> — ID предмета
  • name string — Название характеристики
  • required boolean — - true — характеристику необходимо обязательно указать в карточке товара - false — характеристику необязательно указывать
  • unitName string — Единица измерения
  • maxCount integer<int64> — Максимальное количество значений, которое можно присвоить характеристике при создании или редактировании карточек товаров. Используется только для характеристик с "charcType":1 — массив строк. Характеристикам с "charcType":4 — число, можно присвоить только одно значение. Если "maxCount":0, количество значений не ограничено
  • popular boolean — Характеристика популярна у пользователей (true - да, false - нет)
  • charcType integer<int64> — Тип данных характеристики, который необходимо использовать при создании или редактировании карточек товаров: - 1 — массив строк - 4 — число (целое либо с десятичной дробью) - 0 — характеристика не используется
  • hasFilter boolean — Ключевая характеристика. Является ли характеристика значимой для покупателей: - true — да - false — нет
  • isVariable boolean — Признак меняющейся характеристики. Значение размечает характеристики, по которым варианты отличаются друг от друга: - true — варианты товара отличаются по этой характеристике - false — варианты товара не отличаются по этой характеристике
  • existNamedField boolean — Как передать характеристику в запросах на cоздание, создание с присоединением и редактирование карточек товара: - true — в соответствующем параметре запроса - false — внутри массива characteristics
• error boolean — Флаг наличия ошибки
• errorText string — Описание ошибки
• additionalErrors string — Дополнительные ошибки

Структура 400:

• один из вариантов: responseBodyContentError400, responseBodyContentError400InvalidSyntax

Структура 401:

• title string — Заголовок ошибки
• detail string — Детали ошибки
• code string — Внутренний код ошибки
• requestId string — Уникальный ID запроса
• origin string — ID внутреннего сервиса WB
• status number — HTTP статус-код
• statusText string — Расшифровка HTTP статус-кода
• timestamp string — Дата и время запроса

Структура 403:

• data object — Данные ошибки
• error boolean — Флаг ошибки
• errorText string — Описание ошибки
• additionalErrors string — Дополнительные ошибки

Структура 429:

• title string — Заголовок ошибки
• detail string — Детали ошибки
• code string — Внутренний код ошибки
• requestId string — Уникальный ID запроса
• origin string — ID внутреннего сервиса WB
• status number — HTTP статус-код
• statusText string — Расшифровка HTTP статус-кода
• timestamp string — Дата и время запроса

Примеры вызова

Аргументы показаны именами параметров — подставьте свои значения. Языки, в клиенте которых этой операции нет, не показаны.

Python

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_object_charcs_subject_id(subject_id=..., locale=...)
print(result)

TypeScript

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.getV2ObjectCharcsSubjectId(subjectId, locale);
console.log(data);

Go

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.GetV2ObjectCharcsSubjectId(context.Background(), subjectId).Execute()
if err != nil {
    panic(err)
}
fmt.Printf("%+v\n", result)

Java

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.getV2ObjectCharcsSubjectId(subjectId, locale));

PHP

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->getV2ObjectCharcsSubjectId($subject_id));

OneScript

#Использовать "wb-api-client"

Настройки = Новый Конфигурация();
Настройки.УстановитьТокен("<ваш JWT WB>");
Клиент = Новый ItemsApi(Настройки);

Сообщить(Клиент.GetV2ObjectCharcsSubjectId(subjectId).Тело);

C#

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.GetV2ObjectCharcsSubjectId(subjectId));

Rust

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_object_charcs_subject_id(&cfg, subject_id, locale).await;
    println!("{:#?}", result);
}