bravia-apilisted
Install: claude install-skill salvatejero/myclaude-skills
# Protocolo BRAVIA
Fuentes: la documentación pública de Sony "BRAVIA Professional Displays — IP Control /
REST API" (pro-bravia.sony.net).
## Transporte
- HTTP en el puerto 80, sin TLS. En una app de iOS, en el Info.plist hacen falta `NSAllowsLocalNetworking`
y `NSLocalNetworkUsageDescription`.
- JSON-RPC: `POST http://<ip>/sony/<servicio>` con el cuerpo
`{"method": "...", "params": [...], "id": 1, "version": "1.0"}`.
- Si va bien, devuelve `{"result": [...], "id": 1}`; si falla, `{"error": [código, "mensaje"], "id": 1}`.
Un error puede llegar con HTTP 200, así que hay que mirar siempre la clave `error`.
## Autenticación (una de las dos)
- **PSK**: se envía la cabecera `X-Auth-PSK: <clave>` en todas las peticiones, JSON y SOAP.
- **PIN**: `POST /sony/accessControl` con `actRegister` y estos params:
`[{"clientid": "<app>:<uuid>", "nickname": "<nombre>", "level": "private"}, [{"value": "yes", "function": "WOL"}]]`.
- Sin `Authorization` → la TV responde **401** y muestra un PIN de 4 dígitos.
- Se repite con `Authorization: Basic base64(":" + pin)` → 200 y cookie `auth`.
URLSession la guarda y la reenvía sola; caduca y se renueva con otro `actRegister`.
- El `clientid` tiene que ser estable (se guarda un UUID), porque
si cambia se pide otro PIN.
## Servicios y métodos útiles
| Servicio | Método | Notas |
|---|---|---|
| system | `getRemoteControllerInfo` | `result = [{bundled,type}, [{name, value}]]`: nombre de tecla → código IRCC. **Varía según el mode