Référence de l'API

Authentification et jetons

Connexion à l’appareil et jeton. Après la connexion, token et c-id doivent appartenir à la même session.

Déroulement de connexion à l’appareil

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

POST /init

HTTP request

c-id: clientId · body: empty

Survoler ou toucher un champ
1 / 7

sessionKey = Base64Decode(token). Dérivée des deux côtés à la connexion ; ne pas envoyer comme Bearer. logout ou revokeSession révoque la session, pas le changement de mot de passe.

Créer dans Connexions → Jetons API de l’appareil. Copier clientId et token ensemble. Supprimer le jeton le révoque. Envoyer Bearer uniquement par HTTPS.

Le chiffrement HTTP ne protège pas le code web téléchargé. La première connexion exige une identité serveur fiable ; utiliser HTTPS de confiance dans le navigateur.

Si trop de connexions non authentifiées sont ouvertes, le serveur renvoie HTTP 429 avec un corps vide avant le passage à WebSocket. Réessayez plus tard.

WebSocket /auth · AuthErrorCode · Erreurs

Premier frame : 10 s. Puis 60 s pour finir le handshake. Connexion et approbation : 300 s au total.

INVALID_LOGIN_REQUEST
Vérifiez la demande de connexion et démarrez une nouvelle négociation.
PASSWORD_SETUP_REQUIRED
Définissez d’abord un mot de passe de connexion sur l’appareil.
INVALID_PASSWORD
Vérifiez le mot de passe et réessayez.
PEER_IDENTITY_CHANGED
Vérifiez l’identité de l’appareil avant de continuer.
REMOTE_ACCESS_DISABLED
Activez l’accès distant sur l’appareil.
REJECTED
Le propriétaire a refusé la connexion.
TIMEOUT
Lancez une nouvelle demande de connexion.
TOO_MANY_LOGIN_ATTEMPTS
Patientez avant de réessayer.

Opérations

http

Jeton d’API Bearer

Utiliser un jeton d’API distinct pour envoyer du JSON via HTTPS sans chiffrement du corps.

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

Révoquer la session authentifiée actuelle du client appelant.

graphql
mutation logout {
  logout
}