Pular para o conteúdo
Produtos

Início rápido da HTTP API

Este artigo mostra como fazer login na HTTP API do Alta e publicar um canal com curl. Para uma visão geral das funções, dos códigos de resposta e das convenções, leia HTTP API.

  • As requisições vão para o API Server (porta padrão 8100), não para o OTT Server. Saiba mais em Servidor HTTP.
  • Você precisa de um usuário da interface web do Alta com a função admin. Saiba mais em Usuários.

A API suporta dois métodos:

  • Bearer token: obtenha um token com /api/login e envie-o no cabeçalho Authorization: Bearer <token>.
  • HTTP Basic: envie o login e a senha do usuário em cada requisição.

Fazer login:

Terminal window
curl -sS -X POST 'http://alta.example.com:8100/api/login' \
-H 'Content-Type: application/json' \
-d '{"id": "admin", "password": "PASSWORD"}'

A resposta é o token em texto simples. Salve-o em uma variável:

Terminal window
TOKEN=$(curl -sS -X POST 'http://alta.example.com:8100/api/login' \
-H 'Content-Type: application/json' \
-d '{"id": "admin", "password": "PASSWORD"}')

Verifique o token com a requisição de informações da aplicação:

Terminal window
curl -sS -H "Authorization: Bearer $TOKEN" 'http://alta.example.com:8100/api/about'

Com HTTP Basic, use a opção -u do curl no lugar do token:

Terminal window
curl -sS -u 'admin:PASSWORD' 'http://alta.example.com:8100/api/about'

Um canal precisa de um receptor com o stream de entrada. Crie primeiro o receptor e depois o canal que o usa.

1. Crie um receptor:

Terminal window
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. Crie um canal com uma variante:

Terminal window
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" }
}
}'

As duas requisições retornam 204 com o corpo vazio.

3. Abra a playlist em um player. A playlist é servida pelo OTT Server, não pelo API Server:

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

A porta OTT é definida em Settings → HTTP Servers. Saiba mais sobre os endereços das playlists em Formato de URL para acesso HLS.

4. Verifique os espectadores:

Terminal window
curl -sS -H "Authorization: Bearer $TOKEN" 'http://alta.example.com:8100/api/ott/sessions/status'

Para remover o exemplo, exclua primeiro o canal e depois o receptor:

Terminal window
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'
  • Canais: variantes, armazenamento do arquivo, controle de acesso, iniciar e parar.
  • Receptores: origens e importação de uma playlist M3U.
  • Autorizadores: proteja canais com regras de IP ou Securetoken.