Autenticación y Tokens
Inicio de sesión del dispositivo y token. Tras iniciar sesión, token y c-id deben pertenecer a la misma sesión.
Flujo de inicio de sesión del dispositivo
Configuración del servidor
https://<host>:<port>/initPOST /init
c-id: clientId · body: empty
sessionKey = Base64Decode(token). Ambos lados la derivan al iniciar sesión; no se envía como Bearer. logout o revokeSession revoca la sesión; cambiar la contraseña no.
Crear en Conexiones → Tokens API de la app del dispositivo. Copiar clientId y token juntos. Eliminar el token lo revoca. Enviar Bearer solo por HTTPS.
Cifrar el cuerpo HTTP no protege el código web descargado. El primer uso requiere una identidad de servidor fiable; usar HTTPS de confianza en el navegador.
Si hay demasiadas conexiones sin autenticar abiertas, el servidor responde con HTTP 429 y un cuerpo vacío antes de actualizar a WebSocket. Vuelve a intentarlo más tarde.
WebSocket /auth · AuthErrorCode · Errores
Primer frame: 10 s. Tras el primer frame válido: 60 s para el handshake. Inicio y aprobación: 300 s en total.
INVALID_LOGIN_REQUEST- Comprueba la solicitud de inicio de sesión e inicia una nueva negociación.
PASSWORD_SETUP_REQUIRED- Configura primero una contraseña de inicio de sesión en el dispositivo.
INVALID_PASSWORD- Comprueba la contraseña y vuelve a intentarlo.
PEER_IDENTITY_CHANGED- Verifica la identidad del dispositivo antes de continuar.
REMOTE_ACCESS_DISABLED- Activa el acceso remoto en el dispositivo.
REJECTED- El propietario rechazó el inicio de sesión.
TIMEOUT- Inicia una nueva solicitud de acceso.
TOO_MANY_LOGIN_ATTEMPTS- Espera antes de volver a intentarlo.
Operaciones
Token de API Bearer
Usar un token de API independiente para enviar JSON por HTTPS sin cifrar el cuerpo.
curl --request POST \
--url 'https://<device-host>:<https-port>/graphql' \
--header 'c-id: <client-id>' \
--header 'Authorization: Bearer <api-token>' \
--header 'Content-Type: application/json' \
--data '{"query":"{ app { deviceName capabilities access } }"}'logout
Revocar la sesión autenticada actual del cliente que realiza la llamada.
mutation logout {
logout
}