Разработчикам

Интегрируйте видеонаблюдение в свои приложения

Получайте видеопотоки, события и снимки через понятный API. Faceter берёт на себя запись, хранение и обработку — вы выстраиваете нужные сценарии.

Документация API Задать вопрос
Примеры интеграций

Что можно собрать на API Faceter

Пять базовых паттернов (snapshot по триггеру, webhook на событие, экспорт архива, внешняя метка в ленту, snapshot по расписанию) закрывают десятки реальных сценариев — вот часть из них по отраслям.

CRM, POS и учётные системы

Видео в карточке клиента и чек, привязанный к записи

Виджет для amoCRM или Bitrix24 показывает live-видео и события прямо в карточке клиента — не нужно переключаться в другое приложение. А в кассовых и учётных системах (1С, POS) каждый чек, скидку или отмену операции можно отправить в Faceter как событие — при споре открывается лента, выбирается нужный чек, видео уже подтянуто к нужному моменту.

Обсудить интеграцию
  • Видеовиджет в карточке клиента CRM
  • Чек или операция POS — как метка на таймлайне
  • Разбор спора за секунды, а не за день
Фитнес-клубам и спортзалам

Занятость зала без датчиков на тренажёрах

Раз в 5 минут забирайте snapshot зоны с тренажёрами и считайте свободные места своей ML-моделью — показывайте загрузку в приложении клуба, чтобы посетители не стояли в очереди в час пик. Второй сценарий — контроль присутствия персонального тренера: система ждёт от Faceter событие о человеке в зоне в слот записи, и если его нет — уведомляет менеджера.

Обсудить интеграцию
  • Загрузка зала в реальном времени в приложении клиента
  • Контроль присутствия тренера на занятии
  • Без установки датчиков — только камера и API
Ветклиникам и груминг-салонам

Прямой эфир из бокса для волнующегося владельца

В личном кабинете клиники — кнопка «посмотреть питомца»: по нажатию клиент получает временную ссылку на живое видео из бокса стационара, не дожидаясь звонка врача. Для груминга — обратная задача: на старте процедуры отправляется метка в Faceter, а при жалобе клиента экспортируется ролик именно этого визита от начала до конца.

Обсудить интеграцию
  • Временная ссылка на live-видео для владельца питомца
  • Видео-доказательство процедуры по конкретному визиту
  • Меньше тревожных звонков в клинику
Автосервисам и шиномонтажу

Прозрачный ремонт без «вы не меняли деталь»

При создании заказ-наряда — метка в ленту Faceter, при выдаче машины — клиенту на почту ролик всего процесса ремонта от начала до конца. Для шиномонтажа тот же приём работает на сезонном хранении: при приёмке шин сканируете QR-наклейку, а при выдаче находите нужный ролик по тому же коду.

Обсудить интеграцию
  • Видео ремонта клиенту — без лишних споров
  • Поиск ролика по номеру заказа или QR-коду
  • Доказательная база при любой претензии
Детским садам и центрам допобразования

Окно в группу для родителя без лишней тревоги

В приложении для родителей — кнопка «посмотреть мою группу», которая по расписанию (например, только в тихий час или на прогулке) открывает live-видео на ограниченное время. В учреждениях допобразования — проще: при отметке «ребёнок пришёл» автоматически отправляется snapshot родителю в push-уведомление, без звонков администратору.

Обсудить интеграцию
  • Ограниченное по времени окно live-видео для родителей
  • Автоматическое подтверждение прихода и ухода ребёнка
  • Меньше тревожных звонков администратору
Каршерингу и аренде оборудования

Доказательная фотофиксация «он уже был битым»

В момент завершения аренды в вашей системе — запрос на экспорт архива за минуту до и минуту после возврата, ролик сохраняется прямо в карточке аренды. Подходит не только для авто: самокаты, генераторы, лодки и каяки на self-service точках — на стойке возврата кнопка отправляет событие и snapshot без участия сотрудника.

Обсудить интеграцию
  • Ролик состояния объекта на каждый возврат
  • Работает и для ночной сдачи без сотрудника на месте
  • Меньше споров о состоянии при возврате
Тепличным комплексам и фермам

Удалённый агроном для сети теплиц

По расписанию — раз в час — забирайте snapshot из каждой теплицы в единый портал: агроном «обходит» десятки точек, не выезжая на объект. Отдельный сценарий для периметра — датчик открытия ворот фермы отправляет push в Telegram вместе со snapshot, чтобы реагировать на визит раньше, чем он станет проблемой.

Обсудить интеграцию
  • Плановый визуальный контроль без выезда на объект
  • Мгновенный snapshot при срабатывании датчика на воротах
  • Один портал на все точки сети
Ресторанам и кухням с доставкой

Контроль выноса заказа и стандартов кухни

При выдаче блюда из кухни на кассе доставки отправляется метка с составом заказа — при жалобе клиента сразу поднимается ролик именно этого момента. Для контроля чек-листа (перчатки, маски, чистота) — snapshot кухни каждые 30 минут прогоняется через внешнюю ML-модель, а результат возвращается в Faceter отдельным событием.

Обсудить интеграцию
  • Видео-подтверждение выдачи каждого заказа
  • Автоматическая проверка стандартов кухни по расписанию
  • Быстрый разбор жалоб на состав или качество
Коворкингам и сервисам бронирования

Реальная загрузка переговорных вместо брони «про запас»

За 5 минут до начала брони запрашивается snapshot переговорной; если через 10 минут после старта зона всё ещё пуста — бронь автоматически освобождается для других. Простой способ побороть привычку бронировать «на всякий случай» без отдельной системы контроля присутствия.

Обсудить интеграцию
  • Автоматическое освобождение неиспользуемой брони
  • Snapshot зоны без постоянной видеотрансляции
  • Больше доступных слотов без покупки новых переговорных
Сервисам аренды складских ячеек

История визита с видео на каждый вход в ячейку

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

Обсудить интеграцию
  • Видео-история каждого визита к ячейке
  • Автоматическая привязка к клиенту по карте доступа
  • Доказательная база при споре о сохранности вещей
Парковкам, АЗС и операторам постаматов

От распознанного номера до открытого шлагбаума

Faceter распознаёт номер на въезде и отправляет webhook в вашу систему — она открывает шлагбаум, выставляет счёт или списывает средства с привязанной карты без участия оператора. Для постаматов работает обратный сценарий: датчик удара или наклона запускает автоматический экспорт 30-секундного ролика до и после инцидента — готовое антивандальное доказательство.

Обсудить интеграцию
  • Webhook с распознанным номером — без оператора на шлагбауме
  • Бесконтактное списание оплаты по номеру
  • Автоматический ролик при попытке вандализма
Гостиницам, аптекам и банковским кассам

Аудит выдачи с привязкой к конкретной операции

При заселении в PMS гостиницы — метка в ленту Faceter со snapshot ресепшена, при жалобе на пропажу вещей находится нужный момент за секунды. Тот же приём — при выдаче рецептурного препарата в аптеке или операции в кассе банка: событие с атрибутами операции ложится на таймлайн рядом с видео.

Обсудить интеграцию
  • Snapshot и метка на каждую чувствительную операцию
  • Быстрый аудит по журналу PMS или АБС
  • Доказательная база без ручного поиска по архиву
Стройплощадкам, производству и рознице

От акта приёмки до пустой полки на выкладке

На стройплощадке к акту приёмки в CRM прикладывается таймлапс дня и snapshot — меньше споров с подрядчиком о фактическом объёме работ. На производственной линии snapshot раз в минуту с проверкой на отсутствие движения сигнализирует об остановке конвейера раньше диспетчера. В рознице тот же принцип контролирует пустые полки: snapshot раз в 15 минут через ML — и алерт в Telegram, если товара нет в наличии.

Обсудить интеграцию
  • Таймлапс дня — доказательство объёма работ на стройке
  • Автоматический алерт об остановке конвейера
  • Контроль пустых полок без обхода зала
Возможности

API для полной интеграции

Faceter берёт на себя запись видео, хранение и обработку, а вы управляете тем, как это встроено в ваш продукт и какие сценарии реализуются для ваших пользователей.

Видео и архив
Получать live-видео в реальном времени
Получать архив: HLS-плейлисты за заданный интервал
Скачивать фрагмент аудио/видео за заданное время
События и уведомления
Получать события (пуллинг — запросом)
Получать события по webhook / колбэку
Добавлять события в Faceter (внешние метки)
Камеры
Получать список камер (все или по ID)
Просматривать данные: наименование, статус, тариф
Получать snapshot в нужный момент
Начало работы

Три шага до первого запроса

1
Зарегистрируйтесь и подключите камеры
Создайте аккаунт в Faceter, добавьте камеры в личный кабинет. Поддерживаются любые IP-камеры по RTSP.
2
Сгенерируйте API-ключ
В личном кабинете в разделе настроек создайте API-ключ. Доступ к данным — только по ключу, без лишних сложностей.
3
Выберите методы и интегрируйте
Изучите документацию, выберите нужные методы и добавьте интеграцию в ваш код. Мы открыты к вопросам и обратной связи.
Задать вопрос Документация API
Сотрудничество

Базовые принципы работы с API

🔑
Доступ по API-ключу
Создаётся в личном кабинете за пару кликов. Никаких сложных согласований — начинайте сразу.
📋
Прозрачность изменений
Все обновления API заранее документируются. Вы знаете о нём до того, как оно вас затронет.
📈
Масштабирование
Условия для высоких нагрузок обсуждаются отдельно. Растёте — растём вместе.
💬
Обратная связь
Открыты к предложениям по новым методам и сценариям. Пишите — рассмотрим и добавим.
Вопросы

Частые технические вопросы

Как устроена авторизация в API Faceter?
Один заголовок X-Integration-Key, который создаётся в личном кабинете и передаётся во всех запросах REST API. Без OAuth-флоу и нескольких версий API — интеграцию можно собрать за день-два, а не за недели.
Какие события отдаёт камера через API?
Faceter присылает события по типам: движение, человек, транспорт, пересечение линии, распознанный номер, животное, лицо и собственные метки (Custom). Их можно как получать (запросом или по webhook), так и добавлять свои — через отправку события камере.
Можно ли добавить в ленту Faceter своё, внешнее событие?
Да — отправкой события с типом Custom и любыми атрибутами (например, номер чека или ID заказа). Метка появится на таймлайне рядом с видео, привязанная к нужному моменту — это основа для связки с CRM, POS и учётными системами.
Как получить фрагмент архива за конкретный интервал?
Двумя способами: синхронно — прямое скачивание mp4 за короткий интервал, либо асинхронно — запрос на экспорт с указанием начала и длительности, готовый ролик приходит по callback-адресу. Второй способ подходит для более длинных фрагментов.
Поддерживается ли ONVIF и RTSP?
API отдаёт статус камеры, доступность архива и её расположение; для локальных потоков и сторонних устройств есть отдельные интеграции — например, открытый проект OpenIPC на GitHub.
Нужен ли собственный сервер для интеграции?
Нет. Faceter — облачное решение: запись, хранение и обработку видео берёт на себя платформа, а со своей стороны вы обращаетесь к REST API. Серверная инфраструктура под видеонаблюдение не нужна.
Что делать, если стандартных методов не хватает под мой сценарий?
Написать в поддержку с описанием сценария. Если кейс распространённый — метод может попасть в ближайший релиз API; для нестандартных объёмов запросов и лимитов условия обсуждаются индивидуально.

Обсудить
интеграцию

Расскажите о своём проекте — поможем выбрать нужные методы и ответим на технические вопросы.

Написать для быстрого ответа

Telegram МАКСМАКС support@faceter.cam

По теме: «API для видеонаблюдения: как связать камеры с CRM, кассой и Telegram-ботом».