PlayerOFF
v1.2.0

PlayerOFF API​

Descargar Documento OpenAPI

API pública y abierta para enviar videos a un TV o navegador desde cualquier app. No hace falta registrarse ni pedir una API key.

Cómo funciona

  1. El receptor (la app de PlayerOFF en el TV o en el navegador) se abre y muestra un código de 6 caracteres y un QR con playeroff://connect?code=<CÓDIGO>.
  2. Tu app canjea el código con POST /v1/sessions y recibe un sessionToken. Cada código sirve una sola vez; si otra persona se conecta después, tu sesión termina (410 session_ended).
  3. Tu app envía un video con POST /v1/casts usando Authorization: Bearer <sessionToken>. El TV lo reproduce al instante y reemplaza lo que estuviera reproduciendo.
  4. Tu app controla la reproducción con POST /v1/sessions/commands (pausa, salto, volumen, subtítulos, audio, detener) y sigue lo que pasa en el TV con GET /v1/sessions/events (SSE) o GET /v1/sessions/playback.

Nada se guarda: los códigos duran 5 minutos, los envíos no entregados caducan a los 5 minutos y la sesión dura 2 horas desde la última petición o hasta que se cierre el TV.

Se aceptan URLs de la red local (http://192.168.x.x, *.local): el servidor nunca abre la URL, solo la reenvía al TV.

Errores

Todos los errores tienen la forma { "error": { "code": "...", "message": "..." } }. Códigos: validation_error, unauthorized, invalid_code, not_found, session_ended, nothing_playing, cast_mismatch, payload_too_large, rate_limited.

Elige una operación en el menú lateral para ver sus parámetros, respuestas y ejemplos, y probarla desde aquí.

PlayerOFF · API abierta para enviar videos a cualquier pantalla.