Riferimento API

Autenticazione e Token

Accesso al dispositivo e token. Dopo l’accesso, token e c-id devono appartenere alla stessa sessione.

Flusso di accesso al dispositivo

Client
https://<host>:<port>/init
Server

POST /init

HTTP request

c-id: clientId · body: empty

Passare il puntatore o toccare un campo
1 / 7

sessionKey = Base64Decode(token). Derivata da entrambe le parti al login; non inviarla come Bearer. logout o revokeSession revoca la sessione; cambiare password non basta.

Crea in Connessioni → Token API dell’app del dispositivo. Copia clientId e token insieme. Elimina il token per revocarlo. Invia Bearer solo via HTTPS.

La cifratura del corpo HTTP non protegge il codice web scaricato. Al primo uso serve un’identità server attendibile; nel browser usa HTTPS attendibile.

Se sono aperte troppe connessioni non autenticate, il server restituisce HTTP 429 con un corpo vuoto prima del passaggio a WebSocket. Riprova più tardi.

WebSocket /auth · AuthErrorCode · Errori

Primo frame: 10 s. Poi 60 s per completare il handshake. Login e approvazione: 300 s totali.

INVALID_LOGIN_REQUEST
Controlla la richiesta di accesso e avvia un nuovo handshake.
PASSWORD_SETUP_REQUIRED
Imposta prima una password di accesso sul dispositivo.
INVALID_PASSWORD
Controlla la password e riprova.
PEER_IDENTITY_CHANGED
Verifica l’identità del dispositivo prima di continuare.
REMOTE_ACCESS_DISABLED
Attiva l’accesso remoto sul dispositivo.
REJECTED
Il proprietario ha rifiutato l’accesso.
TIMEOUT
Avvia una nuova richiesta di accesso.
TOO_MANY_LOGIN_ATTEMPTS
Attendi prima di riprovare.

Operazioni

http

Token API Bearer

Usare un token API separato per inviare JSON tramite HTTPS senza cifrare il corpo.

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

Revocare la sessione autenticata corrente del client chiamante.

graphql
mutation logout {
  logout
}