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.

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

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.

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. 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.
• Bilhetes do Catena — como transformar o direito de um cliente em admissão à reprodução.