Список вопросов

http

GET /api/v1/questions

База: https://feedbacks-api.wildberries.ru · Модуль: communications · Раздел: Вопросы · Документация спецификации ↗

Метод возвращает список вопросов по заданным фильтрам. Вы можете:

получить данные отвеченных и неотвеченных вопросов
сортировать вопросы по дате
настроить пагинацию и количество вопросов в ответе

Можно получить максимум 10 000 вопросов в одном ответе

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

Тип	Период	Лимит	Интервал	Всплеск
Персональный	1 сек	3 запроса	333 мс	6 запросов
Сервисный	1 сек	3 запроса	333 мс	6 запросов
Базовый с секретом	1 сек	3 запроса	333 мс	6 запросов
Базовый	1 ч	5 запросов	12 мин	1 запрос

Параметры

Имя	Где	Тип	Обяз.	Описание
`isAnswered`	query	`boolean`	да	Есть ли ответ на вопрос: - `true` — да - `false` — нет
`nmId`	query	`integer<int64>`	нет	Артикул WB
`take`	query	`integer<int64>`	да	Количество запрашиваемых вопросов (максимально допустимое значение для параметра - 10 000, при этом сумма значений параметров `take` и `skip` не должна превышать 10 000)
`skip`	query	`integer<int64>`	да	Количество вопросов для пропуска (максимально допустимое значение для параметра - 10 000, при этом сумма значений параметров `take` и `skip` не должна превышать 10 000)
`order`	query	`string`	нет	Сортировка вопросов по дате (`dateAsc`/`dateDesc`)
`dateFrom`	query	`integer<int64>`	нет	Дата начала периода в формате Unix timestamp
`dateTo`	query	`integer<int64>`	нет	Дата конца периода в формате Unix timestamp

Ответы

Код	Описание	Схема
`200`	Успешно	`GetV1QuestionsResponse200`
`400`	Неправильный запрос	`responseFeedbackQuestionErr`
`401`	Не авторизован	`object`
`402`	Требуется платёж	`object`
`403`	Доступ запрещён	`responseFeedbackQuestionErr`
`429`	Слишком много запросов	`object`

Структура 200:

data object
- countUnanswered integer<int64> — Количество неотвеченных вопросов
- countArchive integer<int64> — Количество отвеченных вопросов
- questions object[] — Вопросы
  - id string — id вопроса
  - text string — Текст вопроса
  - createdDate string — Дата и время создания вопроса
  - state string — Статус вопроса: - none — вопрос отклонён продавцом (такой вопрос не отображается на портале покупателей) - wbRu — ответ предоставлен, вопрос отображается на сайте покупателей - suppliersPortalSynch - новый вопрос
  - answer object — Структура ответа
    - text string — Текст ответа
    - editable boolean — Можно ли отредактировать ответ (false - нельзя, true - можно)
    - createDate string — Дата и время создания ответа
  - productDetails object — Информация о товаре
    - nmId integer<int64> — Артикул WB
    - imtId integer<int64> — ID для объединённых карточек товаров
    - productName string — Название товара
    - supplierArticle string — Артикул продавца
    - supplierName string — Имя продавца
    - brandName string — Название бренда
  - wasViewed boolean — Просмотрен ли вопрос
  - isWarned boolean — Признак подозрительного вопроса. Если true, то вопрос опубликован, но на портале продавцов вы увидите баннер **Сообщение подозрительное**
error boolean — Есть ли ошибка
errorText string — Описание ошибки
additionalErrors string[] — Дополнительные ошибки

Структура 400:

data object
error boolean — Есть ли ошибка
errorText string — Описание ошибки
additionalErrors string[] — Дополнительные ошибки
requestId string

Структура 401:

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

Структура 402:

title string — Заголовок ошибки
detail string — Детали ошибки. Ошибка возвращается только сервисам из Каталога решений для бизнеса

Структура 403:

data object
error boolean — Есть ли ошибка
errorText string — Описание ошибки
additionalErrors string[] — Дополнительные ошибки
requestId 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.communications import Configuration, ApiClient
from wb_api_client.communications.api import CommunicationsApi

cfg = Configuration(access_token="<ваш JWT WB>")
api = CommunicationsApi(ApiClient(cfg))

result = api.get_v1_questions(is_answered=..., take=..., skip=..., nm_id=..., order=..., date_from=..., date_to=...)
print(result)

import {
  Configuration,
  CommunicationsApi,
} from "@valeryverkhoturov/wb-api-client/communications";

const cfg = new Configuration({});
cfg.setAccessToken("<ваш JWT WB>");
const api = new CommunicationsApi(cfg);

const { data } = await api.getV1Questions(isAnswered, take, skip, nmId, order, dateFrom, dateTo);
console.log(data);

import (
	"context"
	"fmt"

	wbcommunications "github.com/ValeryVerkhoturov/wb-api-client-go/communications"
)

cfg := wbcommunications.NewConfiguration()
cfg.SetAccessToken("<ваш JWT WB>")
client := wbcommunications.NewAPIClient(cfg)

result, _, err := client.CommunicationsAPI.GetV1Questions(context.Background()).IsAnswered(isAnswered).Take(take).Skip(skip).Execute()
if err != nil {
    panic(err)
}
fmt.Printf("%+v\n", result)

java

import io.github.valeryverkhoturov.wbapi.communications.ApiClient;
import io.github.valeryverkhoturov.wbapi.communications.SecretString;
import io.github.valeryverkhoturov.wbapi.communications.api.CommunicationsApi;

ApiClient client = new ApiClient();
client.setAccessToken(new SecretString("<ваш JWT WB>"));
CommunicationsApi api = new CommunicationsApi(client);

System.out.println(api.getV1Questions(isAnswered, take, skip, nmId, order, dateFrom, dateTo));

php

use ValeryVerkhoturov\WbApiClient\Communications\Configuration;
use ValeryVerkhoturov\WbApiClient\Communications\SecretString;
use ValeryVerkhoturov\WbApiClient\Communications\Api\CommunicationsApi;
use GuzzleHttp\Client;

$config = (new Configuration())
    ->setAccessTokenSecret(new SecretString('<ваш JWT WB>'));
$api = new CommunicationsApi(new Client(), $config);

print_r($api->getV1Questions($is_answered, $take, $skip));

bsl

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

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

Сообщить(Клиент.GetV1Questions(isAnswered, take, skip).Тело);

csharp

using ValeryVerkhoturov.WbApiClient.Communications.Api;
using ValeryVerkhoturov.WbApiClient.Communications.Client;

var config = new Configuration();
config.AccessTokenSecret = new SecretString("<ваш JWT WB>");
var api = new CommunicationsApi(config);

Console.WriteLine(api.GetV1Questions(isAnswered, take, skip));

rust

use wb_api_client::communications::apis::{configuration::Configuration, communications_api};

#[tokio::main]
async fn main() {
    let mut cfg = Configuration::new();
    cfg.set_access_token("<ваш JWT WB>");

    let result = communications_api::get_v1_questions(&cfg, is_answered, take, skip, nm_id, order, date_from, date_to).await;
    println!("{:#?}", result);
}

Список вопросов ​

Параметры ​

Ответы ​

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

Список вопросов

Параметры

Ответы

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