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ị
Cấu hình máy chủ
https://<host>:<port>/initPOST /init
c-id: clientId · body: empty
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
API token Bearer
Dùng API Token riêng để gửi JSON qua HTTPS mà không mã hóa phần thâ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
Thu hồi phiên đã xác thực hiện tại của máy khách gọi.
mutation logout {
logout
}