Коды ошибок

HTTP-статусы

Код	Значение
200	Успех
201	Создан (POST share)
204	Без содержимого (DELETE)
400	Ошибка валидации запроса
401	Не авторизован
403	Нет доступа
404	Ресурс не найден
422	Ошибка формата тела запроса
429	Превышен лимит запросов
500	Внутренняя ошибка сервера

Бизнес-ошибки (внутри SSE FAILURE)

Возникают внутри state: "FAILURE" потока статуса задачи.

{
  "state": "FAILURE",
  "error": {
    "code": 1001,
    "message": "Failed to parse page: connection timeout"
  }
}

Код	Название	Описание
1001	PARSER_FAILURE	Не удалось загрузить или разобрать страницу
1002	ANALYSIS_SERVICE_FAILURE	Внутренняя ошибка сервиса анализа
1003	CRITICAL_OWN_PAGE_FAILURE	Ваша страница недоступна или вернула ошибку
1004	REPORT_GENERATION_FAILURE	Не удалось сформировать отчёт
1005	TRIPLET_ANALYSIS_FAILURE	Ошибка при извлечении графа знаний
9999	UNKNOWN_ERROR	Неизвестная ошибка

Пример обработки ошибок

import requests, json

with requests.get(stream_url, headers=HEADERS, stream=True) as resp:
    for line in resp.iter_lines():
        if not line or not line.startswith(b"data: "):
            continue
        event = json.loads(line[6:])
        if event["state"] == "FAILURE":
            err = event.get("error", {})
            code = err.get("code", 9999)
            msg = err.get("message", "Unknown error")
            raise RuntimeError(f"Analysis failed [{code}]: {msg}")

Валидационные ошибки (422)

{
  "detail": [
    {
      "loc": ["body", "competitor_urls"],
      "msg": "ensure this value has at most 20 items",
      "type": "value_error.list.max_items"
    }
  ]
}