Для разработчиков

API ТутОтвет

REST API и MCP-сервер для отзывов Wildberries, Ozon и Яндекс Маркета: читать, отвечать, управлять правилами, смотреть статистику и тариф.

Справочник методов Выпустить ключ

Обзор

Базовый адрес: https://lk.tutotvet.ru/api/v1. Данные — JSON в UTF-8, для POST добавьте заголовок Content-Type: application/json.

Если вам не нужен код, а нужно подключить ChatGPT или Claude, смотрите страницу API и нейросети.

Быстрый старт

Выпустите ключ в кабинете: Настройки → API и нейросети. Затем проверьте его, получите отзывы и ответьте на один из них.

# 1. Кто я и какие организации в ключе
curl https://lk.tutotvet.ru/api/v1/me -H "Authorization: Bearer tt_ВАШ_КЛЮЧ"

# 2. Отзывы, которые ждут ответа
curl "https://lk.tutotvet.ru/api/v1/reviews?status=needs_answer&limit=20" -H "Authorization: Bearer tt_ВАШ_КЛЮЧ"

# 3. Ответить на отзыв (mp = wb | ozon | ym, id - из списка)
curl -X POST https://lk.tutotvet.ru/api/v1/reviews/wb/ID_ОТЗЫВА/answer \
  -H "Authorization: Bearer tt_ВАШ_КЛЮЧ" -H "Content-Type: application/json" \
  -d '{"text": "Анна, спасибо за отзыв! Рады, что товар понравился."}'

Авторизация

Ключ передаётся в каждом запросе заголовком Authorization: Bearer tt_.... Ключ действует для одной организации или для всех организаций владельца. Для коннекторов есть вход через OAuth 2.1, ключ там не нужен.

Право	Что разрешает
`read`	Читать отзывы, статистику, историю, правила, тариф и цены
`answer`	Отвечать на отзывы, отклонять и переписывать черновики
`rules`	Создавать и менять правила, запускать мастер, менять настройки
`billing`	Тарифы и оплата: подключить тариф с баланса, автопродление, промокод, ссылка на оплату, счёт. Отдельное право, тратит деньги, по умолчанию выключено

Основные понятия

Организация (org_id): магазин владельца. Список организаций ключа отдаёт GET /me, параметр org в списках оставляет только одну.
Маркетплейс (mp): wb, ozon или ym.
Статус отзыва: needs_answer, unanswered, moderation, failed, sending, published, all.
Модерация: черновик ждёт решения: опубликовать, отклонить или переписать.

Справочник методов

Справочник генерируется из кода, поэтому всегда совпадает с работающим API.

Справочник (Swagger)
Схема OpenAPI: для Actions своего GPT, Postman и генераторов клиентов
Инструкция для нейросети: методы, примеры, правила хорошего ответа
llms.txt: указатель на документацию для нейросетей и агентов

MCP-сервер

Адрес: https://lk.tutotvet.ru/mcp, транспорт Streamable HTTP. Возможности те же, что у REST API. Инструменты видны по правам ключа, денежные — только с правом billing.

Вход двумя способами: заголовок Authorization: Bearer tt_... или OAuth. Токен OAuth живёт час и обновляется сам, токен обновления — 90 дней.

Ошибки и лимиты

Код	Что значит
`401`	Нет ключа или ключ отозван
`403`	У ключа нет нужного права
`404`	Отзыв не найден
`409`	На отзыв уже ответили или ответ уже отправляется
`422`	Текст не прошёл проверку, причина в поле `detail`
`429`	Слишком много запросов: повторите после паузы из заголовка `Retry-After`

120 запросов в минуту на ключ
Ответ до 3000 символов, без ссылок, почты и телефонов
Длинное тире в ответе заменяется дефисом
Работает для подключений через API: Wildberries, Ozon через Ozon API, Яндекс Маркет

Безопасность

Храните ключ на сервере, а не в коде фронтенда и не в репозитории
Один ключ — одна интеграция
Выдавайте минимальные права
При утечке нажмите «Отозвать» в кабинете

Версии

Текущая версия — v1. Несовместимые изменения выходят только в новой версии v2.

Поддержка

Вопросы по API присылайте на o@tutotvet.ru.