PlainApp
API 참조

인증 및 토큰

기기 로그인과 토큰입니다. 로그인 후 token과 c-id는 같은 세션에 속해야 합니다.

기기 로그인 흐름

클라이언트
https://<host>:<port>/init
서버

POST /init

HTTP request

c-id: clientId · body: empty

필드에 마우스를 올리거나 탭하세요
1 / 7

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
}