Перейти к содержимому
Продукты

Быстрый старт с HTTP API

В этой статье показано, как войти в HTTP API Alta и опубликовать канал с помощью curl. Обзор ролей, кодов ответа и соглашений читайте в разделе HTTP API.

  • Запросы отправляются на API Server (порт по умолчанию 8100), а не на OTT Server. Подробнее в разделе HTTP-сервер.
  • Нужен пользователь веб-интерфейса Alta с ролью admin. Подробнее в разделе Пользователи.

API поддерживает два метода:

  • Bearer token: получите токен через /api/login и передавайте его в заголовке Authorization: Bearer <token>.
  • HTTP Basic: передавайте логин и пароль пользователя в каждом запросе.

Вход:

Окно терминала
curl -sS -X POST 'http://alta.example.com:8100/api/login' \
-H 'Content-Type: application/json' \
-d '{"id": "admin", "password": "PASSWORD"}'

В ответе приходит токен в виде простого текста. Сохраните его в переменную:

Окно терминала
TOKEN=$(curl -sS -X POST 'http://alta.example.com:8100/api/login' \
-H 'Content-Type: application/json' \
-d '{"id": "admin", "password": "PASSWORD"}')

Проверьте токен запросом информации о приложении:

Окно терминала
curl -sS -H "Authorization: Bearer $TOKEN" 'http://alta.example.com:8100/api/about'

Для HTTP Basic вместо токена используйте опцию -u команды curl:

Окно терминала
curl -sS -u 'admin:PASSWORD' 'http://alta.example.com:8100/api/about'

Каналу нужен ресивер с входным потоком. Сначала создайте ресивер, затем канал, который его использует.

1. Создайте ресивер:

Окно терминала
curl -sS -X POST 'http://alta.example.com:8100/api/ott/receiver' \
-H "Authorization: Bearer $TOKEN" \
-H 'Content-Type: application/json' \
-d '{
"id": "news-source",
"name": "News source",
"source": "udp://239.1.1.1:1234",
"enable": true
}'

2. Создайте канал с одним вариантом:

Окно терминала
curl -sS -X POST 'http://alta.example.com:8100/api/ott/channel' \
-H "Authorization: Bearer $TOKEN" \
-H 'Content-Type: application/json' \
-d '{
"id": "news",
"name": "News",
"enable": true,
"variants": {
"main": { "enable": true, "receiver": "news-source" }
}
}'

Оба запроса возвращают 204 с пустым телом.

3. Откройте плейлист в плеере. Плейлист отдаёт OTT Server, а не API Server:

http://alta.example.com:<ott-port>/news/index.m3u8

Порт OTT задаётся в Settings → HTTP Servers. Подробнее об адресах плейлистов в разделе Формат URL для доступа по HLS.

4. Проверьте зрителей:

Окно терминала
curl -sS -H "Authorization: Bearer $TOKEN" 'http://alta.example.com:8100/api/ott/sessions/status'

Чтобы удалить пример, сначала удалите канал, затем ресивер:

Окно терминала
curl -sS -X DELETE -H "Authorization: Bearer $TOKEN" 'http://alta.example.com:8100/api/ott/channel?id=news'
curl -sS -X DELETE -H "Authorization: Bearer $TOKEN" 'http://alta.example.com:8100/api/ott/receiver?id=news-source'
  • Каналы: варианты, хранилище архива, контроль доступа, запуск и остановка.
  • Ресиверы: источники и импорт из плейлиста M3U.
  • Авторизаторы: защита каналов правилами по IP или Securetoken.