Изменения

Правила совместимости#

Адрес версии — /api/v1. Внутри v1 изменения только совместимые:

• добавляются методы, необязательные поля запросов и новые поля ответов;
• добавляются значения перечислений — например, новые reason в выдаче или коды отказа событий;
• существующие поля не удаляются и не меняют смысл.

Поэтому игнорируйте неизвестные поля в ответах и обрабатывайте неизвестные значения перечислений как «прочее». Несовместимые изменения выйдут новой версией API с отдельным адресом и заранее объявленным сроком перехода.

В журнале — только методы, которые уже работают: новый метод появляется здесь с датой, с которой его можно вызывать. Полный список действующих методов — в справочнике API.

28 февраля 2026 — версия 4.0.8#

• Выпуск 4.0.8 — его номер отдаёт описание API (GET /openapi.json, поле info.version). Методы, поля и коды API не изменились.
• Вход в кабинет: «Кабинет» на сайте открывает окно входа поверх страницы; код из письма отправляется сам, как только введена шестая цифра, — без кнопки «Войти».

28 февраля 2026 — версия 4.0.7#

• Выпуск 4.0.7 — его номер отдаёт описание API (GET /openapi.json, поле info.version). Методы, поля и коды API не изменились.
• Кабинет: даты и время везде в виде ГГГГ-ММ-ДД ЧЧ:ММ (24 часа), поле дня в «Расходе» — текстовое, ГГГГ-ММ-ДД.
• Кабинет и сайт на телефоне: длинные email, адреса и идентификаторы больше не раздвигают страницу; кнопки, пункты меню, вкладки и флажки — не меньше 44 px по высоте.

28 февраля 2026 — версия 4.0.6#

• Выпуск 4.0.6 — его номер отдаёт описание API (GET /openapi.json, поле info.version). Методы, поля и коды API не изменились.
• Форма заявки на сайте: заявка, исправленная после ошибки и сразу отправленная повторно, теперь принимается; если отправить слишком быстро, форма попросит подождать секунду.

28 февраля 2026 — версия 4.0.5#

• Выпуск 4.0.5 — его номер отдаёт описание API (GET /openapi.json, поле info.version). Методы, поля и коды API не изменились.
• Форма заявки на сайте: согласие на обработку персональных данных и согласие на получение информационных материалов по email — теперь два отдельных флажка; второй необязателен и по умолчанию не отмечен.

24 февраля 2026 — версия 4.0.4#

• Выпуск 4.0.4 — его номер отдаёт описание API (GET /openapi.json, поле info.version). Методы, поля и коды API не изменились.
• Медиа из HLS: media[].url видео и аудио может указывать на плейлист HLS (.m3u8): ДАРА сама скачивает одну ступень (не выше 720p по короткой стороне) и анализирует её как файл. Сегменты — MPEG-TS на том же хосте, что и плейлист, без шифрования; трансляции не поддерживаются. Требования и тексты ошибок — в разделе Объекты. DASH по-прежнему не поддерживается.

20 февраля 2026 — версия 4.0.3#

• Выпуск 4.0.3 — его номер отдаёт описание API (GET /openapi.json, поле info.version). Методы, поля и коды API не изменились.
• Вход в кабинет: лимит неверных кодов (20 за сутки) теперь считается для пары «IP-адрес и почта»: неверные коды, введённые с другого IP-адреса, больше не закрывают вход по коду вашему адресу.

17 февраля 2026 — версия 4.0.2#

• Выпуск 4.0.2 — его номер отдаёт описание API (GET /openapi.json, поле info.version). Методы, поля и коды API не изменились.
• Вход в кабинет: после 20 неверных кодов из письма на один адрес за сутки (или 50 с одного IP за час) вход по коду временно закрывается — с сообщением «Слишком много попыток. Попробуйте позже.».
• Загрузка файлов импорта принимается только от вошедшего в кабинет: без входа nginx сразу уводит на страницу входа, не принимая файл.

2 февраля 2026 — номер версии 4.0.1#

• Нумерация 4.x.x. ДАРА, ДАРА АНАЛИТИКА и ДАРА ОТПЕЧАТОК перешли на общую нумерацию выпусков: этот выпуск — 4.0.1, его номер отдаёт описание API (GET /openapi.json, поле info.version). Методы, поля и коды не изменились; адрес версии API — по-прежнему /api/v1.

25 января 2026 — ДАРА АНАЛИТИКА#

• Подключение ДАРА АНАЛИТИКИ: ключ API её сайта вводится в кабинете, и ДАРА берёт из сети данные о ваших пользователях — пол, возрастную группу, город, интересы и категории покупок. Новых методов у API нет. Раздел ДАРА АНАЛИТИКА.
• Идентификатор analytics_id принимается в объекте user событий, заказов, профиля, склейки и выдачи; пользователя он не определяет, неверный формат даёт код invalid_user.
• Данные сети в ответе GET /users/profile — отдельным блоком network, рядом с полями профиля и не заменяя их. Раздел Данные о пользователях.
• Удаление: POST /users/delete удаляет и данные сети об этом пользователе; в самой ДАРА АНАЛИТИКЕ при этом не удаляется ничего.

20 января 2026 — поиск, субтитры, вебхуки и импорт файлов#

• Поиск: POST /search — поиск по смыслу и словам с фрагментами и временем в видео, фильтрами, страницами по снимку и полем identity, как в выдаче. Лимит частоты у поиска и выдачи общий. Раздел Поиск.
• Субтитры: GET /items/{id}/subtitles — готовый файл WebVTT или SRT по транскрипту медиа, параметры media и format. Раздел Результаты анализа.
• Вебхуки: ДАРА сообщает о готовности анализа запросом на ваш адрес — события item.processed и item.failed, проверочная доставка webhook.test из кабинета; подпись в заголовке X-Core-Signature, повторы при неудаче, журнал доставок за 30 дней. Раздел Вебхуки.
• Импорт файлов: каталог, профили, заказы и события загружаются в кабинете из CSV и Excel — с проверкой файла, отчётом об ошибках и продолжением после сбоя. Номера документов 1С переводятся в ключи заказов. Раздел Импорт файлов.
• Ошибки и лимиты: у 404 появились свои причины у профиля пользователя и субтитров, у 503 — разные Retry-After у поиска.

17 января 2026 — рекомендации и DARA Fingerprint#

• Рекомендации: лента POST /recommendations/feed, похожие и «дополните заказ» POST /recommendations/similar, переранжирование POST /recommendations/rerank. Фильтры по свойствам объектов, пагинация по снимку выдачи, запасная выдача при сбоях — раздел Рекомендации.
• Метрики выдачи: показы, открытия и цели с recommendation_id, surface и position считаются в кабинете по поверхностям; цели без recommendation_id приписываются открытию из выдачи за 2 часа.
• DARA Fingerprint: подключение в кабинете по секретному ключу, фоновая проверка fingerprint_uuid, узнавание пользователей без входа (identity: recognized) — раздел DARA Fingerprint.
• Лимиты частоты: лимит на ключ допускает кратковременный всплеск — до трёх секунд темпа.

15 июля 2025 — первая версия API v1#

• Объекты: PUT, PATCH, DELETE /items/{id}, пакет POST /items/batch, объект с результатами анализа GET /items/{id}, переобработка POST /items/{id}/reprocess, сверка каталога GET /items.
• События и заказы: POST /events, GET /event-types, POST /orders, POST /orders/batch.
• Пользователи: склейка POST /users/link, профиль POST /users/profile и пакет POST /users/profile/batch, сверка GET /users/profile, удаление POST /users/delete.
• Служебное: GET /health, описание API GET /openapi.json.