Ошибки и лимиты

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

Ошибка запроса целиком приходит с HTTP-кодом 4xx или 5xx и телом:

{"error": {"code": "validation_failed", "message": "Поле date_from обязательно"}}

• code — машинный код из таблицы ниже. Проверяйте в коде именно его.
• message — пояснение для человека; текст может меняться.
• details — необязательный объект с подробностями, например о полях, которые не прошли проверку.

Каждый ответ содержит заголовок X-Request-ID — сохраняйте его в логах.

Проверка отчёта#

POST /reports с неверным определением отвечает 422 с кодом validation_failed. В details — поле и код причины:

{"error": {"code": "validation_failed", "message": "Неизвестная метрика", "details": [{"field": "metrics[1]", "code": "unknown_metric"}]}}

Если отчёт не уложился во время даже по выборке, ответ — 503 с кодом unavailable: сократите период.

Ошибки отдельных записей#

Методы пачек отвечают 202 Accepted, даже если часть записей не принята. Непринятые записи перечислены в ответе.

index — номер записи в пачке, с нуля. duplicates в ответе POST /conversions и POST /orders — записи, которые уже были учтены: это не ошибка.

Ошибка формы хотя бы одного элемента POST /visitors/attributes или записи POST /users — неверный тип, длина, UUID, нет идентификатора — отклоняет весь запрос ответом 422 с кодом validation_failed, а в details — поле с номером элемента, например visitors[3].visitor_id или users[3].email. POST /users отвечает 503 с кодом unavailable, если приём временно недоступен: пачка не сохранена, её нужно отправить ещё раз.

Повторы#

• Повторяйте при сетевой ошибке, 429, 500 и 503 — с растущей паузой, а при Retry-After — не раньше указанного времени.
• Не повторяйте без исправления остальные ответы 4xx: результат будет тем же.
• Пачки конверсий и заказов можно отправлять повторно без риска задвоить данные: конверсии узнаются по id, заказы — по transaction_id.
• Пачку POST /users тоже можно повторить: поля заменяются теми же значениями. Только interests при каждом повторе снова усиливают свои темы.

Лимиты запросов#

Сверх лимита, в том числе при третьем одновременном запросе отчёта, сразу приходит ответ 429 с кодом rate_limited и заголовком Retry-After. Ответ /visitors/* из кеша тоже расходует лимит.

Размеры пачек#

Квоты сайта#

Сервис бесплатный, нагрузку ограничивают квоты. Администратор ДАРА может изменить квоты для сайта или пользователя.

Роботы учитываются в квоте хитов: они тоже нагружают сервер. Как считаются отчёты сверх квоты — в разделе Отчёты и метрики.

Пределы тега#

Посетитель, который превысил лимиты запросов, получает отметку робота с причиной «Частота», а лишние события отбрасываются.

Лишние элементы children и interests и строки длиннее предела тег обрезает, а поля dara('user') с неверным значением не отправляет — остальные поля команды уходят. В POST /users пределы строк шире — phone до 64 символов, city до 200 — а превышение даёт 422.

Пределы отчётов#