Tham chiếu API

Auth & Token

Đăng nhập thiết bị và token. Sau đăng nhập, token và c-id phải thuộc cùng phiên.

Luồng đăng nhập thiết bị

Máy khách
https://<host>:<port>/init
Máy chủ

POST /init

HTTP request

c-id: clientId · body: empty

Di chuột hoặc chạm một trường
1 / 7

sessionKey = Base64Decode(token). Hai bên tự suy ra khi đăng nhập; không gửi dưới dạng Bearer. logout hoặc revokeSession thu hồi phiên; đổi mật khẩu không tự thu hồi.

Tạo trong Kết nối → Token API của ứng dụng thiết bị. Sao chép clientId và token cùng nhau. Xóa để thu hồi token. Chỉ gửi Bearer qua HTTPS.

Mã hóa nội dung HTTP không bảo vệ mã trang web đã tải. Lần đầu cần danh tính máy chủ đáng tin; trình duyệt nên dùng HTTPS đáng tin cậy.

Nếu có quá nhiều kết nối chưa xác thực đang mở, máy chủ trả về HTTP 429 với nội dung rỗng trước khi nâng cấp lên WebSocket. Hãy thử lại sau.

WebSocket /auth · AuthErrorCode · Lỗi

Khung đầu: 10 giây. Sau khung hợp lệ đầu tiên: 60 giây để hoàn tất bắt tay. Đăng nhập và phê duyệt tổng cộng 300 giây.

INVALID_LOGIN_REQUEST
Kiểm tra yêu cầu đăng nhập và bắt đầu một lượt bắt tay mới.
PASSWORD_SETUP_REQUIRED
Hãy đặt mật khẩu đăng nhập trên thiết bị trước.
INVALID_PASSWORD
Kiểm tra mật khẩu rồi thử lại.
PEER_IDENTITY_CHANGED
Xác minh danh tính thiết bị trước khi tiếp tục.
REMOTE_ACCESS_DISABLED
Bật truy cập từ xa trên thiết bị.
REJECTED
Chủ thiết bị đã từ chối đăng nhập.
TIMEOUT
Bắt đầu yêu cầu đăng nhập mới.
TOO_MANY_LOGIN_ATTEMPTS
Chờ trước khi thử lại.

Thao tác

http

API token Bearer

Dùng API Token riêng để gửi JSON qua HTTPS mà không mã hóa phần thâ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

Thu hồi phiên đã xác thực hiện tại của máy khách gọi.

graphql
mutation logout {
  logout
}