Skip to main content

​
Отправить ошибку

POST /errors
Content-Type: application/json
Этот эндпоинт используется SDK. Аутентификация через project_api_key в теле запроса — JWT не нужен.

​
Тело запроса

{
  "project_api_key": "pk_live_ваш_ключ",
  "message": "TypeError: Cannot read properties of undefined",
  "stacktrace": "TypeError: Cannot read properties of undefined\n    at ProductList (ProductList.js:23:18)\n    ...",
  "environment": "production",
  "release": "1.2.0",
  "url": "https://myapp.ru/products",
  "user_agent": "Mozilla/5.0 ...",
  "metadata": {
    "userId": "123",
    "feature": "catalog"
  },
  "breadcrumbs": [
    {
      "timestamp": "2024-01-15T12:34:00Z",
      "type": "navigation",
      "category": "history",
      "data": { "to": "/products" }
    }
  ]
}

​
Параметры

ПолеТипОбязательныйОписание
project_api_keystring✓API Key проекта
messagestring✓Сообщение об ошибке
stacktracestring—Стектрейс
environmentstring—Окружение (production, staging)
releasestring—Версия приложения
urlstring—URL страницы, где произошла ошибка
user_agentstring—User-Agent браузера
metadataobject—Произвольный контекст
breadcrumbsarray—История событий перед ошибкой

​
Ответ

{
  "success": true,
  "error_group_id": 42,
  "fingerprint": "a1b2c3d4...",
  "is_new_group": true
}
is_new_group: true означает, что это первое вхождение данной ошибки — по нему срабатывают уведомления.

​
Список групп ошибок

GET /errors?project_id=1&page=1&size=20
Authorization: Bearer <token>

​
Query параметры

ПараметрТипОписание
project_idintID проекта
environmentstringФильтр по окружению
statusstringactive или resolved
searchstringПоиск по тексту ошибки
pageintНомер страницы (с 1)
sizeintРазмер страницы (до 100)

​
Детали группы ошибок

GET /errors/{group_id}
Authorization: Bearer <token>

​
Изменить статус

PATCH /errors/{group_id}/status
Authorization: Bearer <token>
Content-Type: application/json

{
  "status": "resolved"
}

​
Сгенерировать AI-объяснение

POST /errors/{group_id}/ai-summary
Authorization: Bearer <token>
Расходует 1 единицу лимита AI-объяснений.

​
Получить AI-объяснение

GET /errors/{group_id}/ai-summary
Authorization: Bearer <token>
Возвращает сохранённое объяснение без расхода лимита.