Написать разработчику

Обращение к разработчику API: вопрос, ошибка в выдаче, просьба подключить площадку.

Номер аккаунта, почту и тариф добавляем сами, по ключу, которым сделан запрос. Писать их в тексте не нужно – достаточно описать, что происходит.

Тело запроса

subjectстрокаобязательный

О чём обращение, одной строкой. От 2 до 200 символов.

messageстрокаобязательный

Текст обращения. От 5 до 5000 символов.

contactстрока

Как с вами связаться, если почта аккаунта не подходит – телефон, телеграм, другой адрес. Необязательное поле.

Ответ

statusстрока

Всегда accepted – обращение принято.

curl -X POST "https://example.com/v3/support/message" \  -H "Content-Type: application/json" \  -d '{    "subject": "Пустая выдача по объекту 20",    "message": "Со вчерашнего дня GET /v3/reviews по объекту 20 возвращает total: 0, хотя на площадке отзывы есть. Ключ read_only, тот же запрос работал в понедельник.",    "contact": "телеграм @petrov"  }'

{  "status": "accepted"}

Что важно знать

Работает с любым ключом. В том числе с read_only: сообщить о поломке – не запись данных, и упереться в права доступа в такой момент неправильно. Из личного кабинета метод тоже доступен.

contact необязателен. Без него мы отвечаем на почту аккаунта. Поле пригодится, если ключ общий на несколько человек или ответ нужен не на почту: тогда напишите в contact, как вас найти.

Ответ 202, а не 200. Он означает «обращение принято», а не «на него уже ответили». Ответ приходит письмом.

Не больше 10 обращений в час с одного аккаунта. Одиннадцатое получает 429 с кодом rate_limited – это защита от цикла в вашем коде, а не ограничение на общение. Если обращений действительно нужно больше, напишите об этом в первом.

Если отправка временно недоступна, метод отвечает 503 с кодом email_unavailable – обращение при этом не сохранено, повторите позже.

Коды ошибок общие для всего API и описаны на странице Ошибки.