Документация

Документация ДАРА

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

Адрес API: https://core.daratech.ru/api/v1
Ключ: Authorization: Bearer ck_XXXXXXXX… — выдаётся в кабинете после подключения
Формат: JSON в UTF-8, время ISO-8601 с Z
Описание API: /api/v1/openapi.json — OpenAPI без авторизации

Начало

Быстрый старт Как получить доступ к API ДАРА и отправить первые три запроса — объект, события и ленту — на curl, PHP и Python. Понятия Проект, объект и медиа, шаги анализа, типы событий, конечные пользователи и их идентификаторы, поверхность и снимок выдачи.

Руководства

Объекты Создание, изменение и удаление объектов — поля и проверки, что переобрабатывается, статусы анализа, пакеты, переобработка и сверка каталога. Результаты анализа Транскрипт с таймкодами, кадры и дубли, сводка, модерация и её категории, субтитры — что возвращает GET /items/{id} и как читать поля. События и заказы Приём событий, пресеты и режимы учёта, дедупликация, досмотр и дочитывание, заказы и отмены, товары вне каталога, приглушение купленного. Пользователи Идентификаторы пользователей, как ДАРА определяет пользователя, склейка при входе, общие устройства, узнавание без входа и удаление данных. Данные о пользователях Профиль пользователя — поля, как они влияют на выдачу, что присылать нельзя, контрольная группа и советы по идентификаторам. DARA Fingerprint Подключение DARA Fingerprint к проекту — что даёт, SDK и cookie dara_visitor, отдельный секретный ключ, фоновая проверка, спорные и общие устройства, узнавание без входа, статусы подключения. ДАРА АНАЛИТИКА Подключение ДАРА АНАЛИТИКИ к проекту — что даёт, где выпустить ключ API сайта, о чём ДАРА спрашивает сеть и что хранит, влияние на выдачу, чувствительные темы, смена ключа, состояния, отключение и удаление. Рекомендации Лента, похожие и «дополните заказ», переранжирование, фильтры по свойствам, пагинация и recommendation_id, что не показывается, метрики выдачи, запасная выдача и таймауты. Поиск POST /search — поиск по смыслу и словам с фрагментами и временем в видео: поля запроса, ответ, страницы, метрики, ошибки и примеры кода. Вебхуки Уведомления о готовности анализа на ваш адрес: события, заголовки и тело, проверка подписи на PHP и Python, повторы и журнал доставок. Модели Задачи анализа, облачные и локальные модели, вариант «Не выполнять», что уходит внешнему поставщику, ориентиры скорости и лимиты. Импорт файлов Загрузка каталога, профилей, заказов и событий из CSV и Excel в кабинете: шаблоны и колонки, кодировки и даты, проверка, отчёт об ошибках, повторные загрузки. Ошибки и лимиты Формат ошибок API, HTTP-статусы и коды, ошибки полей, лимиты частоты и размеров, какие запросы повторять.

Справочник

Справочник API Методы API v1 с параметрами, телами запросов, ответами и схемами данных — собирается из описания OpenAPI. Изменения Журнал изменений API ДАРА с датами и правила совместимости версии v1.

Доступа ещё нет? Оставьте заявку — ответим на email и обсудим подключение.