API Referansı

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ışı

İstemci
https://<host>:<port>/init
Sunucu

POST /init

HTTP request

c-id: clientId · body: empty

Alanın üzerine gelin veya dokunun
1 / 7

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

http

Bearer API belirteci

Gövde şifrelemesi olmadan HTTPS üzerinden JSON göndermek için ayrı API Token kullanın.

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

Çağıran istemcinin mevcut doğrulanmış oturumunu iptal eder.

graphql
mutation logout {
  logout
}