Suscriptores¶
Un suscriptor es un cliente de la vitrina: quién es, a qué paquetes está suscrito y qué canales le quedan disponibles como resultado.
Cree un suscriptor¶
En la pantalla Suscriptores, escriba un nombre en Nombre del nuevo suscriptor y pulse Crear. La búsqueda en la lista abarca a la vez nombre, email, teléfono y token de reproducción.
La ficha del suscriptor¶
La pestaña Ajustes:
- Nombre, Email, Teléfono — campos de vitrina.
- Idioma — el idioma del abonado.
- Token de reproducción — un token único que Catena genera al crear el suscriptor. Es el identificador del abonado para su integración: por él la vitrina sabe a quién está sirviendo. Con ese mismo token se componen los enlaces a la lista M3U y el XMLTV.
Una edición paralela del mismo registro se rechaza con Otro usuario modificó este registro: recargue y reintente.
Cuenta del portal¶
El bloque Cuenta del portal contiene aquello con lo que el suscriptor entra en la vitrina:
- Usuario — sin él la cuenta no se guarda: es con lo que el suscriptor entra.
- Contraseña — de ocho caracteres en adelante. El campo vacío deja la contraseña anterior: el servidor no la devuelve y no puede mostrarla.
Cambiar la contraseña no desconecta los dispositivos que ya han entrado: la contraseña protege la entrada, no los tokens ya emitidos. Para cortar un dispositivo hay que revocarlo, en el bloque de abajo.
Dispositivos¶
El bloque Dispositivos muestra desde dónde está viendo el abonado ahora mismo. Cada fila lleva el nombre del dispositivo, la hora de su última petición y el botón Revocar: el dispositivo revocado deja de reproducir de inmediato y en su siguiente petición recibe la pantalla de entrada.
Revocar todos apaga la lista entera de golpe. Es la respuesta a «me robaron el televisor y no sé cuál de las filas es»: el abonado podrá volver a entrar con contraseña o con código.
El propio abonado ve y revoca esos mismos dispositivos en su cuenta. La consola sirve para cuando él no puede hacerlo.
Vinculación del dispositivo¶
El bloque Vinculación del dispositivo es el camino de soporte para el abonado que no se apaña solo. El espectador dicta el código de seis dígitos de la pantalla del televisor, el operador lo escribe en el campo Código en pantalla y pulsa Vincular; el televisor entra como ese suscriptor.
El código vive diez minutos y se apaga tras el primer uso. Un código caducado o ajeno responde Código desconocido o caducado: pida al espectador que actualice la pantalla.
El camino normal es otro: el código lo confirma el propio abonado en su cuenta, y el operador no participa en ese lazo.
Suscripciones y canales disponibles¶
El bloque Suscripciones lista los paquetes a los que este cliente está suscrito. El bloque Canales disponibles muestra el resultado: lo que el cliente acaba viendo.
La fórmula de acceso es simple:
- los paquetes disponibles para un cliente = sus suscripciones más todos los paquetes marcados como Gratuito;
- un canal está disponible si pertenece al menos a uno de esos paquetes.
De ahí se siguen dos consecuencias, las más fáciles de pasar por alto: un suscriptor sin ninguna suscripción sigue viendo los canales de los paquetes gratuitos, y un canal que no pertenece a ningún paquete no está disponible para nadie.
Eliminar un suscriptor limpia sus suscripciones en cascada.
Lo que el servicio de abonados no hace¶
El token de reproducción no es un pase a la reproducción. El servicio de abonados mantiene el catálogo y los derechos, pero por sí solo no admite a nadie a un stream ni prohíbe nada: la reproducción sigue protegida por Auth & DRM, y al espectador lo admite un billete de Catena o su backend de autorización.
El montaje estándar es así: la vitrina resuelve el token a un suscriptor, pide a Catena la lista de canales disponibles para él y emite al espectador un billete para un canal permitido. La lista de canales del suscriptor está disponible por API — el recurso /catena/api-v1/subscribers/{id}/channels.
La vitrina que viene con el producto no necesita integración propia para esto: recorre ese montaje ella misma y entrega al espectador direcciones ya listas.
Registro de operaciones¶
La pestaña Operaciones: subscriber_create, subscriber_update, subscriber_delete, más subscribe y unsubscribe — conceder y retirar una suscripción, subscriber_credentials — editar la cuenta, device_link y device_revoke — la aparición y la revocación de un dispositivo. Como en todo el servicio de abonados, la entrada del registro va en la misma transacción que el cambio, y el registro no tiene retención.
Qué sigue¶
- Paquetes — aquello a lo que se concede una suscripción, y el límite de pantallas.
- Vitrina — la aplicación en la que el abonado entra con esta cuenta.
- Lista M3U y XMLTV — los mismos canales para un reproductor externo.
- Billetes de Catena — cómo convertir el derecho de un cliente en admisión a la reproducción.