Assinantes¶

Um assinante é um cliente da vitrine: quem ele é, a quais pacotes está assinado e quais canais ficam disponíveis para ele como resultado.

Crie um assinante¶

Na tela Assinantes, digite um nome em Nome do novo assinante e pressione Criar. A busca na lista abrange de uma vez nome, email, telefone e token de reprodução.

A ficha do assinante¶

A aba Configurações:

• Nome, Email, Telefone — campos de vitrine.
• Idioma — o idioma do assinante.
• Token de reprodução — um token único que o Catena gera ao criar o assinante. É o identificador do assinante para a sua integração: é por ele que a vitrine sabe a quem está atendendo. Com esse mesmo token se montam os links para a lista M3U e o XMLTV.

Uma edição paralela do mesmo registro é recusada com Outro usuário alterou este registro: recarregue e tente novamente.

Conta do portal¶

O bloco Conta do portal guarda aquilo com que o assinante entra na vitrine:

• Usuário — sem ele a conta não é salva: é com ele que o assinante entra.
• Senha — de oito caracteres em diante. O campo vazio mantém a senha anterior: o servidor não a devolve e não consegue mostrá-la.

Trocar a senha não desconecta os dispositivos que já entraram: a senha protege a entrada, não os tokens já emitidos. Para cortar um dispositivo é preciso revogá-lo, no bloco abaixo.

Dispositivos¶

O bloco Dispositivos mostra de onde o assinante está assistindo agora. Cada linha traz o nome do dispositivo, a hora da última requisição e o botão Revogar: o dispositivo revogado para de reproduzir na hora e na requisição seguinte recebe a tela de entrada.

Revogar todos apaga a lista inteira de uma vez. É a resposta para «roubaram minha TV e não sei qual das linhas é ela»: o assinante poderá entrar de novo com senha ou com código.

O próprio assinante vê e revoga esses mesmos dispositivos na conta dele. O console serve para quando ele não consegue.

Vinculação do dispositivo¶

O bloco Vinculação do dispositivo é o caminho do suporte para o assinante que não consegue sozinho. O espectador dita o código de seis dígitos da tela da TV, o operador o digita no campo Código na tela e clica em Vincular; a TV entra como aquele assinante.

O código vive dez minutos e se apaga após o primeiro uso. Um código expirado ou alheio responde Código desconhecido ou expirado: peça ao espectador para atualizar a tela.

O caminho normal é outro: o código é confirmado pelo próprio assinante na conta dele, e o operador não participa desse laço.

Assinaturas e canais disponíveis¶

O bloco Assinaturas lista os pacotes a que este cliente está assinado. O bloco Canais disponíveis mostra o resultado: o que o cliente acaba vendo.

A fórmula de acesso é simples:

• os pacotes disponíveis para um cliente = as assinaturas dele mais todos os pacotes marcados como Gratuito;
• um canal está disponível se pertence a pelo menos um desses pacotes.

Daí decorrem duas consequências, as mais fáceis de escapar: um assinante sem nenhuma assinatura ainda vê os canais dos pacotes gratuitos, e um canal que não pertence a nenhum pacote não está disponível para ninguém.

Excluir um assinante limpa as assinaturas dele em cascata.

O que o serviço de assinantes não faz¶

O token de reprodução não é um passe para a reprodução. O serviço de assinantes mantém o catálogo e os direitos, mas sozinho não admite ninguém a um stream nem proíbe nada: a reprodução continua protegida pelo Auth & DRM, e o espectador é admitido por um bilhete do Catena ou pelo seu backend de autorização.

A montagem padrão é assim: a vitrine resolve o token para um assinante, pede ao Catena a lista de canais disponíveis para ele e emite ao espectador um bilhete para um canal permitido. A lista de canais do assinante está disponível pela API — o recurso /catena/api-v1/subscribers/{id}/channels.

A vitrine que vem no produto não precisa de integração própria para isso: ela percorre essa montagem sozinha e entrega ao espectador endereços prontos.

Registro de operações¶

A aba Operações: subscriber_create, subscriber_update, subscriber_delete, além de subscribe e unsubscribe — conceder e retirar uma assinatura, subscriber_credentials — editar a conta, device_link e device_revoke — o surgimento e a revogação de um dispositivo. Como em todo o serviço de assinantes, a entrada do registro vai na mesma transação que a alteração, e o registro não tem retenção.

O que vem depois¶

• Pacotes — aquilo a que uma assinatura é concedida, e o limite de telas.
• Vitrine — o aplicativo em que o assinante entra com esta conta.
• Lista M3U e XMLTV — os mesmos canais para um reprodutor externo.
• Bilhetes do Catena — como transformar o direito de um cliente em admissão à reprodução.