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.
Requisitos
Seção intitulada “Requisitos”- 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.
Fazer login
Seção intitulada “Fazer login”A API suporta dois métodos:
- Bearer token: obtenha um token com
/api/logine envie-o no cabeçalhoAuthorization: Bearer <token>. - HTTP Basic: envie o login e a senha do usuário em cada requisição.
Fazer login:
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:
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:
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:
curl -sS -u 'admin:PASSWORD' 'http://alta.example.com:8100/api/about'Publicar um canal
Seção intitulada “Publicar um canal”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:
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:
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.m3u8A 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:
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:
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'Próximos passos
Seção intitulada “Próximos passos”- 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.