Ошибки
Ошибка приходит в виде {"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 | Словарь обновляется — повторите позже. |