API для разработчиков Карбуш ТВ

Карбуш ТВ предоставляет полноценное REST API для разработчиков, позволяющее интегрировать наш контент и функционал в ваши приложения и сервисы.

Возможности API:

• Доступ к каталогу контента (фильмы, сериалы, мультфильмы)
• Управление пользователями и подписками
• Персонализированные рекомендации
• Аналитика просмотров и статистика
• Управление плейлистами и избранным

API полностью документировано и включает SDK для популярных языков программирования.

Бесплатный доступ для тестирования с лимитом 1000 запросов/день.

Для доступа к API требуется API ключ:

• Зарегистрируйтесь на портале разработчиков
• Создайте новое приложение в личном кабинете
• Получите API ключ и секрет
• Используйте ключ в заголовке Authorization

Формат аутентификации:

• Bearer Token для OAuth 2.0
• API Key в заголовке X-API-Key
• HMAC подпись для критических операций

Ключи можно перевыпускать и отзывать в любое время.

Рекомендуем хранить ключи в безопасном месте.

Базовый URL API:

• Production: https://api.karbushtv.online/v1
• Sandbox: https://sandbox-api.karbushtv.online/v1

Версионирование API:

• Текущая версия: v1 (стабильная)
• Бета версия: v2-beta (тестирование)
• Устаревшая: v0 (прекращена поддержка)

Мы гарантируем обратную совместимость в рамках мажорной версии.

Уведомления об изменениях API за 90 дней до депривации.

Ограничения на количество запросов:

• Free тариф: 1000 запросов/день
• Basic тариф: 10,000 запросов/день
• Pro тариф: 100,000 запросов/день
• Enterprise: индивидуально

Заголовки rate limiting:

• X-RateLimit-Limit: максимальное количество запросов
• X-RateLimit-Remaining: оставшиеся запросы
• X-RateLimit-Reset: время сброса лимита (Unix timestamp)

При превышении лимита возвращается HTTP 429.

Возможность запроса увеличения лимита через поддержку.

Основные endpoints для работы с контентом:

• GET /content — список всего контента
• GET /content/{id} — детали конкретного титула
• GET /content/movies — только фильмы
• GET /content/series — только сериалы
• GET /content/new — новинки
• GET /content/popular — популярное

Параметры фильтрации:

• genre — жанр
• year — год выпуска
• rating — минимальный рейтинг
• limit — количество результатов
• offset — смещение для пагинации

Поддержка сортировки по различным полям.

Управление пользователями через API:

• POST /users — создание пользователя
• GET /users/{id} — получение данных пользователя
• PUT /users/{id} — обновление профиля
• DELETE /users/{id} — удаление аккаунта
• GET /users/{id}/subscriptions — подписки пользователя

Требуемые права доступа:

• user:read — чтение данных пользователя
• user:write — создание и обновление
• user:delete — удаление аккаунта

Соблюдение GDPR при работе с персональными данными.

Двухфакторная аутентификация для критических операций.

API для управления воспроизведением:

• GET /playback/{content_id}/url — получение URL для стриминга
• POST /playback/history — запись истории просмотров
• GET /playback/history — история просмотров пользователя
• PUT /playbook/progress — обновление прогресса просмотра

URL для стриминга:

• Временный доступ (24 часа)
• Привязка к IP-адресу
• Поддержка адаптивного битрейта
• DRM-защищённые потоки

Требуется активная подписка для получения URL.

Лимит одновременных потоков зависит от тарифа.

API возвращает данные в формате JSON:

• Content-Type: application/json
• UTF-8 кодировка
• Даты в формате ISO 8601

Структура ответа:

• status — статус запроса (success/error)
• data — основные данные
• meta — метаданные (пагинация, лимиты)
• errors — массив ошибок (при наличии)

Поддержка gzip сжатия для больших ответов.

Возможность запроса конкретных полей через fields параметр.

Стандартные HTTP коды ответов:

• 200 — успешный запрос
• 201 — ресурс создан
• 400 — неверный запрос
• 401 — неавторизован
• 403 — доступ запрещён
• 404 — ресурс не найден
• 429 — превышен лимит запросов
• 500 — внутренняя ошибка сервера

Формат ответа об ошибке:

• error_code — код ошибки
• error_message — описание ошибки
• error_details — дополнительные детали

Полная документация ошибок доступна на портале.

Webhooks для получения уведомлений о событиях:

• user.subscription.created — новая подписка
• user.subscription.cancelled — отмена подписки
• content.added — новый контент в каталоге
• content.removed — удаление контента

Настройка webhooks:

• Укажите URL endpoint в настройках приложения
• Выберите события для подписки
• Получите секрет для верификации

Подпись webhook в заголовке X-Webhook-Signature.

Повторные попытки доставки при неудаче (3 раза).

Официальные SDK для популярных языков:

• JavaScript/Node.js — npm install @karbush/api
• Python — pip install karbush-api
• PHP — composer require karbush/api-client
• Ruby — gem install karbush_api
• Go — go get github.com/karbush/api-go

Пример использования (JavaScript):

• Инициализация клиента с API ключом
• Вызов методов API через SDK
• Автоматическая обработка ошибок

SDK обновляются вместе с API.

Исходный код SDK открыт на GitHub.

Тестовая среда для разработки:

• Полная копия production API
• Тестовые данные и пользователи
• Без ограничений на запросы
• Без реальных платежей

Доступ к sandbox:

• Отдельный API ключ для sandbox
• Базовый URL: sandbox-api.karbushtv.online
• Те же endpoints что и production

Рекомендуем тестировать в sandbox перед production.

Данные sandbox не влияют на production.

Панель разработчика предоставляет:

• Статистика использования API в реальном времени
• Логи запросов и ответов
• Мониторинг ошибок и сбоев
• Отчёты по потреблению лимитов

Метрики для отслеживания:

• Количество запросов по endpoints
• Время ответа API
• Процент ошибок
• Активные пользователи API

Экспорт данных в CSV и JSON.

Настройка алертов при превышении порогов.

Каналы поддержки для разработчиков:

• Email: api-support@karbushtv.online
• Портал: developers.karbushtv.online
• Slack: сообщество разработчиков
• GitHub: issues и обсуждения

Ресурсы для разработчиков:

• Полная документация API
• Примеры кода и tutorials
• Postman коллекция endpoints
• FAQ и troubleshooting guide

Время ответа: до 24 часов в рабочие дни.

Приоритетная поддержка для Enterprise клиентов.

Важные условия использования API:

• API ключи не подлежат передаче третьим лицам
• Запрещено использование для scraping контента
• Соблюдение rate limits обязательно
• Контент нельзя перепродавать без лицензии

Лицензионное соглашение:

• Коммерческое использование требует отдельной лицензии
• Атрибуция Карбуш ТВ обязательна
• Изменения в условиях уведомляются за 30 дней

Дата последнего обновления: 01.04.2026

Полный текст соглашения на портале разработчиков.

Начните разработку с Карбуш ТВ API сегодня!