Ошибки

Формат ошибки GraphQL

Как и в любом GraphQL API, ошибки запроса приходят в поле errors ответа. Проверяйте его наличие, а не только HTTP-статус.

{
  "errors": [
    {
      "message": "Неверный пароль",
      "path": ["login"],
      "extensions": {
        "code": "wrong_password",
        "correlation_id": "..."
      }
    }
  ],
  "data": null
}

Язык message определяется параметром запроса ?lang=ru|en, заголовком X-Lang или Accept-Language; по умолчанию — русский.

Коды extensions.code

Список кодов может пополняться: обрабатывайте неизвестные коды как общую ошибку.

Типичные ошибки

Аутентификация

Неверный или отозванный токен не приводит к HTTP-ошибке: запрос выполняется как неавторизованный и защищённые методы возвращают unauthorized.

Тариф

Посмотреть тариф и лимиты можно в разделе Тарифы.

Посты

Ошибки публикации в соцсеть

Ошибка, возникшая при отправке поста в конкретную соцсеть, не делает ошибочным сам GraphQL-запрос. Пост получает статус FAIL, а причина записывается в results[].errorMsg соответствующего аккаунта (на языке пользователя). Типичные причины:

Инструкции по подключению и устранению проблем конкретной соцсети — в разделе Аккаунты.

HTTP-статусы и лимиты

• GraphQL-ошибки приходят в поле errors; не полагайтесь на HTTP-статус для определения успеха запроса.
• 429 Too Many Requests — превышен лимит запросов. Для API-токенов по умолчанию действует 600 запросов в минуту на токен (окно — календарная минута UTC). Подождите до следующей минуты и повторите запрос. Токены, полученные мутацией login, этим лимитом не ограничиваются.

Также существует интервал между публикациями постов (Настройки → Посты), но он не вызывает ошибок: время отправки просто сдвигается. Подробнее — в создании поста.