Быстрый старт с 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.