Документация API v2.4

Интеграция
на уровне
архитектуры

Строгий RESTful API для автоматизации управления контентом и дисплеями. Прямой доступ к логике платформы WallKit для разработчиков корпоративного уровня.

Синтаксис API запроса в темном редакторе кода

Введение в
API WallKit

Единый вход для управления всей экосистемой. Наш API построен на принципах идемпотентности и безопасности данных.

Базовый URL для всех запросов: https://api.wallkit.io/v2. Мы поддерживаем форматы JSON и XML, обеспечивая гибкость для интеграции с легаси-системами и современными SPA-приложениями.

Каждый запрос требует валидной сессии. Мы рекомендуем использовать rate-limiting и кэширование для оптимизации нагрузки на кластер.

Смотреть примеры запросов →
Безопасность

Аутентификация и доступ

🔒

API Keys

Статические ключи доступа для серверных интеграций. Генерируйте уникальные пары Public/Private ключей в панели администратора для каждого проекта.

🔐

OAuth 2.0

Стандартная авторизация для клиентских приложений. Поддержка Scope-based access (read, write, admin) для ограничения прав доступа сторонних сервисов.

🛡

Web Tokens

Краткосрочные токены доступа с TTL до 24 часов. Идеально для микро-сервисов и автоматизированных скриптов деплоя контента.

Управление
контентом

CRUD-операции для медиа-библиотеки и расписаний.

Используйте метод POST /assets/upload для загрузки видеопотоков и изображений. Система автоматически обрабатывает конвертацию в 4K/HDR.

Метод PATCH /schedules позволяет менять тайминги показа на лету без перезагрузки плеера на устройстве. Поддерживается массовая отправка запросов (Batch API) для обновления сотен экранов одновременно.

Устройства

Remote Control

💻

Диагностика

Получение статуса устройств (CPU, RAM, Temp) через GET /devices/{id}/status. Мгновенная реакция на сбои.

🔌

Удаленный перезапуск

Сброс плеера или перезагрузка ОС через API. Функция POST /devices/reboot для восстановления работы без выезда инженера.

📡

OTA Обновления

Программное обновление прошивок устройств. Указывайте версии софта и расписание внедрения обновлений через эндпоинты.

Webhooks
и События

Реактивная архитектура для ваших сервисов.

Настройте подписки на события в реальном времени. WallKit отправляет JSON-пакеты на ваш URL при наступлении триггеров:

  • device.offline — потеря связи с дисплеем
  • content.failed — ошибка при декодировании медиафайла
  • analytics.daily — ежедневный отчет о просмотрах

Все хуки подписаны цифровой подписью для подтверждения подлинности источника.

Тестируйте в безопасной среде

Используйте нашу интерактивную песочницу для отладки интеграций. Получите тестовые API-ключи и попробуйте управлять виртуальным кластером дисплеев.

Перейти в песочницу Связаться с техподдержкой