войти

Ошибки

Ошибка приходит в виде {"detail": "текст"}. Ошибка в поле запроса приходит списком — у каждого поля свой путь loc:

{"detail": [{"type": "string_too_long", "loc": ["body", "content"],
             "msg": "String should have at most 1000000 characters", "input": "…"}]}

Коды ответов

ОтветЧто случилось
401Нет заголовка Authorization, ключ не sk_…, неверный или отключённый ключ — причина в detail. См. «Ключи и авторизация».
403Запрос не оплачен — причина в detail: «Для серверного API нужен действующий тариф сайта или пакет проверок API» или «Проверки API на этот месяц закончились». См. «Лимиты и расход».
404Нет такого адреса — проверьте путь метода.
405Метод HTTP не подходит к адресу: например, GET к /api/mark.
413Тело запроса больше 2 МБ. Отвечает веб-сервер: тело — страница HTML, а не JSON. Разбейте текст на части — «Размер запроса».
422Ошибка в поле запроса: нет обязательного поля, текст длиннее 1 000 000 символов, неизвестный код реестра или вид пометки, одиночные суррогаты в тексте.
500Ошибка на нашей стороне. Повторите запрос; если повторяется — напишите на mail@brain-pro.ru с телом запроса.
503Словарь реестров пересобирается или сервис обновляется — обычно несколько минут. Повторите позже.

Ошибки метода виджета

/api/widget/mark отвечает {"error": "текст"} и всегда отдаёт заголовок Access-Control-Allow-Origin, чтобы скрипт в браузере увидел причину.

ОтветЧто случилось
400Неверный запрос: не JSON или нет полей key, text.
403Неизвестный публичный ключ, ключ не привязан к домену из заголовка Origin или тариф сайта не оплачен.
413Текст длиннее 200 000 символов.
429Больше 1 200 запросов в минуту с сайта или 120 с одного адреса читателя.
503Словарь обновляется — повторите позже.