Referencia de la API

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

Cliente
https://<host>:<port>/init
Servidor

POST /init

HTTP request

c-id: clientId · body: empty

Pasar el cursor o tocar un campo
1 / 7

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

http

Token de API Bearer

Usar un token de API independiente para enviar JSON por HTTPS sin cifrar el cuerpo.

bash
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 } }"}'
mutation

logout

Revocar la sesión autenticada actual del cliente que realiza la llamada.

graphql
mutation logout {
  logout
}