API 참조
인증 및 토큰
기기 로그인과 토큰입니다. 로그인 후 token과 c-id는 같은 세션에 속해야 합니다.
기기 로그인 흐름
서버 설정
클라이언트
https://<host>:<port>/init서버
POST /init
HTTP request
c-id: clientId · body: empty
필드에 마우스를 올리거나 탭하세요
sessionKey = Base64Decode(token). 로그인 시 양쪽에서 파생하며 Bearer로 전송하지 않습니다. logout 또는 revokeSession으로 철회합니다. 비밀번호 변경만으로는 철회되지 않습니다.
기기 앱의 연결 → API 토큰에서 생성하고 clientId와 token을 함께 복사하세요. 토큰을 삭제하면 철회됩니다. Bearer는 HTTPS로만 전송하세요.
HTTP 본문 암호화는 다운로드한 웹 코드를 보호하지 못합니다. 최초 사용 시 신뢰할 서버 신원이 필요하며 브라우저에서는 신뢰할 HTTPS를 사용하세요.
인증되지 않은 연결이 너무 많으면 서버는 WebSocket으로 업그레이드하기 전에 본문이 없는 HTTP 429를 반환합니다. 나중에 다시 시도하세요.
WebSocket /auth · AuthErrorCode · 오류
첫 프레임 10초. 유효한 첫 프레임 후 60초 내 핸드셰이크 완료. 로그인 및 승인 대기 총 300초.
INVALID_LOGIN_REQUEST- 로그인 요청을 확인한 후 새 핸드셰이크를 시작하세요.
PASSWORD_SETUP_REQUIRED- 먼저 기기에서 로그인 비밀번호를 설정하세요.
INVALID_PASSWORD- 비밀번호를 확인하고 다시 시도하세요.
PEER_IDENTITY_CHANGED- 계속하기 전에 기기의 신원을 확인하세요.
REMOTE_ACCESS_DISABLED- 기기에서 원격 접근을 켜세요.
REJECTED- 기기 소유자가 로그인을 거부했습니다.
TIMEOUT- 로그인 요청을 새로 시작하세요.
TOO_MANY_LOGIN_ATTEMPTS- 잠시 후 다시 시도하세요.
작업
http
Bearer API 토큰
별도 API Token으로 본문 암호화 없이 HTTPS를 통해 JSON을 전송합니다.
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
호출 클라이언트의 현재 인증된 세션을 취소합니다.
graphql
mutation logout {
logout
}