Integración en la nube y LAN

Elige el canal

Usa el servicio en la nube del proyecto para redes distintas o una conexión LAN para un controlador local. Ambas comparten los datos de los comandos. El endpoint, la identidad del producto y las credenciales se entregan con el despliegue; la otra API de dispositivos de este sitio es una integración distinta.

Los mensajes incluyen un mid de ocho caracteres y ts en milisegundos. Las respuestas conservan mid. Úsalo para relacionar solicitudes, respuestas y eventos; una confirmación no prueba que el contenido sea visible.

{"device":123,"mid":"ab12cd34","data":{"screen":{"action":"list"}},"ts":1793664000000}

Conecta por la red local

El reproductor prueba el puerto 9756 y los nueve siguientes si está ocupado. GET /ping informa del puerto real. Se prefiere WebSocket /order; POST /order queda como compatibilidad antigua. El token LAN es el código de seis dígitos; si está vacío o desactivado, se rechaza ese acceso.

• Los clientes nativos pueden usar X-SS-Token, X-SS-Remote-Id y X-SS-Remote-Name. Mantén privado el código y no expongas el puerto LAN a Internet.
• Una página HTTPS no puede asumir acceso a HTTP o WS sin cifrar en LAN: se aplican las restricciones de contenido mixto. Usa la aplicación suministrada o un servicio local adecuado. En LAN, system se limita a info y reg.

GET http://<device-ip>:<port>/ping
ws://<device-ip>:<port>/order?token=<control-code>&rid=<remote-id>&rname=<remote-name>

{"mid":"ab12cd34","data":{"screen":{"action":"list"}},"ts":1793664000000}

Respuestas y errores

Las acciones correctas devuelven ret: ok; las consultas pueden devolver datos directamente. Los fallos incluyen ret: error y msg. Revisa invalid param, invalid state, unsupported, queue full y device is in remote mode. Consulta el estado antes de repetir una acción de resultado desconocido.

{"mid":"ab12cd34","ret":"ok"}
{"mid":"ab12cd34","ret":"error","msg":"unsupported"}