Вопросы покупателей о товарах

API для работы с вопросами покупателей о товарах. Покупатели могут задавать вопросы о характеристиках товаров, а продавец — отвечать на них через API. Уточняющие ответы помогают потенциальным покупателям с выбором и снижают риск отказа от товара.

С помощью API вы можете:

• Получить список всех вопросов или отфильтровать по статусу, источнику ответа, периоду
• Ответить на новый вопрос
• Отредактировать свой ответ на вопрос, пока он находится на модерации

Авторизация

Все методы требуют OAuth-токен в заголовке:

Authorization: Bearer {access_token}

Во всех запросах обязателен параметр sellerId. Значение должно соответствовать sellerId из JWT-токена, иначе вернётся ошибка 403.

Методы

1. Получение списка вопросов

GET /api/v2/feedback/questions

Возвращает список вопросов покупателей с возможностью фильтрации, сортировки и группировки по товару.

Параметры запроса

Пример запроса

GET /api/v2/feedback/questions?sellerId=242541217&page=1&limit=25&sort=-createdAt&status=NEW HTTP/1.1
Authorization: Bearer {access_token}

Успешный ответ (200)

{
  "data": [
    {
      "product": {
        "parentSku": "MP002XW0J7E6R",
        "sku": "MP002XW0J7E6R660",
        "externalSku": "77122JSS-8",
        "name": "Тоник для лица",
        "brand": "New Balance"
      },
      "items": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440000",
          "createdAt": "2025-12-20T10:30:15.000Z",
          "dateAnswerUntil": "2025-12-27T10:30:15.000Z",
          "username": "Мария",
          "text": "Подходит ли этот тоник для чувствительной кожи?",
          "canAnswer": true,
          "answerSource": "SELLER",
          "answers": [],
          "status": "NEW"
        }
      ]
    }
  ],
  "meta": {
    "limit": 25,
    "page": 1,
    "total": 120,
    "totalPages": 5
  }
}

Структура объекта product

Структура объекта вопроса (items[])

Структура объекта ответа (answers[])

2. Ответ на вопрос покупателя

POST /api/v2/feedback/questions/{questionId}/answer

Записывает ответ продавца на вопрос покупателя. Также используется для редактирования ответа, который ещё находится на модерации.

Параметры пути

Тело запроса

Пример запроса

POST /api/v2/feedback/questions/550e8400-e29b-41d4-a716-446655440000/answer HTTP/1.1
Authorization: Bearer {access_token}
Content-Type: application/json

{
  "sellerId": "242541217",
  "text": "Да, тоник подходит для чувствительной кожи. Он не содержит спирта и агрессивных ПАВ."
}

Успешный ответ (200)

{
  "questionId": "550e8400-e29b-41d4-a716-446655440000",
  "createdAt": "2025-12-21T14:15:00.000Z",
  "text": "Да, тоник подходит для чувствительной кожи. Он не содержит спирта и агрессивных ПАВ.",
  "source": "SELLER",
  "status": "ON_MODERATION"
}

Структура ответа

Справочники

Статусы вопросов (QuestionStatus)

Статусы ответов (QuestionAnswerStatus)

Источники ответов (QuestionAnswerSource)

Коды ошибок

Пример: типовой сценарий обработки вопросов

Шаг 1. Получите список новых вопросов:

GET /api/v2/feedback/questions?sellerId=242541217&status=NEW&sort=-createdAt&limit=50

Шаг 2. Для каждого вопроса с canAnswer: true отправьте ответ:

POST /api/v2/feedback/questions/{questionId}/answer
{
  "sellerId": "242541217",
  "text": "Ваш ответ на вопрос покупателя"
}

Шаг 3. Отслеживайте статусы ответов. Получите вопросы с отклонёнными ответами:

GET /api/v2/feedback/questions?sellerId=242541217&answerStatus=REJECTED

Шаг 4. При необходимости отредактируйте ответ (пока он на модерации), повторно вызвав метод ответа с новым текстом.

Пагинация

Для получения всех вопросов используйте пагинацию:

// Страница 1
GET /api/v2/feedback/questions?sellerId=242541217&page=1&limit=50

// Страница 2
GET /api/v2/feedback/questions?sellerId=242541217&page=2&limit=50

// Продолжайте, пока page <= meta.totalPages

В ответе поле meta содержит информацию о пагинации:

См. также

• OAuth 2.0 авторизация
• Получение товаров
• Коды ошибок