Kimlik Doğrulama & Token'lar
Cihaz oturum açması ve token. Oturum açıldıktan sonra token ve c-id aynı oturuma ait olmalıdır.
Cihaz oturum açma akışı
Sunucu yapılandırması
https://<host>:<port>/initPOST /init
c-id: clientId · body: empty
sessionKey = Base64Decode(token). Girişte iki taraf da türetir; Bearer olarak göndermeyin. logout veya revokeSession oturumu iptal eder; parola değişikliği etmez.
Cihaz uygulamasında Bağlantılar → API Belirteçleri bölümünden oluşturun. clientId ve token birlikte kopyalanır. Silmek belirteci iptal eder. Bearer yalnızca HTTPS ile gönderilir.
HTTP gövdesi şifrelemesi indirilen web kodunu korumaz. İlk kullanımda güvenilir sunucu kimliği gerekir; tarayıcıda güvenilir HTTPS kullanın.
Çok fazla kimliği doğrulanmamış bağlantı açıksa sunucu, WebSocket yükseltmesinden önce boş gövdeyle HTTP 429 döndürür. Daha sonra tekrar deneyin.
WebSocket /auth · AuthErrorCode · Hatalar
İlk frame: 10 sn. Geçerli ilk frame ardından handshake için 60 sn. Giriş ve onay toplam 300 sn.
INVALID_LOGIN_REQUEST- Oturum açma isteğini kontrol edin ve yeni bir el sıkışma başlatın.
PASSWORD_SETUP_REQUIRED- Önce cihazda bir oturum açma parolası belirleyin.
INVALID_PASSWORD- Parolayı kontrol edip yeniden deneyin.
PEER_IDENTITY_CHANGED- Devam etmeden önce cihaz kimliğini doğrulayın.
REMOTE_ACCESS_DISABLED- Cihazda uzaktan erişimi açın.
REJECTED- Cihaz sahibi girişi reddetti.
TIMEOUT- Yeni bir giriş isteği başlatın.
TOO_MANY_LOGIN_ATTEMPTS- Yeniden denemeden önce bekleyin.
İşlemler
Bearer API belirteci
Gövde şifrelemesi olmadan HTTPS üzerinden JSON göndermek için ayrı API Token kullanın.
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
Çağıran istemcinin mevcut doğrulanmış oturumunu iptal eder.
mutation logout {
logout
}