PlainApp
API 참조

페어링

기능 지원은 app.capabilities, 인가는 app.access와 호스트 권한으로 확인하세요. 예제는 합성 값을 사용합니다. 호출 전에 경로, ID, 입력, 필터를 바꾸세요.

Device A
plainapp://pair?request=<URL-encoded JSON>
Device B

QR

QR payload

QR: A가 표시하고 B가 스캔합니다. LAN c-id는 발신자를 식별하며 BLE는 자체 전송을 사용합니다. PAIR_CANCEL은 선택 사항입니다.

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

고정 시각의 합성 스냅샷이며 서명과 requestIds가 일치합니다. 192.0.2.0/24는 문서용으로 예약되어 있습니다. 8443은 기본 HTTPS 포트이며 실제 요청에서는 검색된 포트를 사용하세요. 시간이 제한된 이 요청들을 그대로 재사용할 수 없습니다.

PlainApp Desktop에서 새 기기나 공개 키가 변경된 기기를 관리하려면 먼저 해당 기기를 신뢰할지 명시적으로 확인합니다. 이 단계에는 비교 코드가 없으며, 공개 키가 변경된 경우 경고가 표시됩니다. 비밀번호를 사용하지 않았다면 두 기기에 표시된 코드가 일치하는지 확인한 뒤 관리 대상 기기에서 승인하세요. 비밀번호로 인증했더라도 관리 대상 기기에서 코드 없이 승인을 요청할 수 있습니다.

타입 정의

graphql
type Subscription {
  peersChanged: Boolean!
  pairingRequested: PairingRequestNotice!
  pairingCompleted: PairingCompletedNotice!
  pairingStarted: PairingProgressNotice!
  pairingFailed: PairingProgressNotice!
  pairingCanceled: PairingProgressNotice!
}

type Mutation {
  cancelPairing(peerId: ID!): Boolean!
  deletePeer(peerId: ID!): Boolean!
  pairPeer(peerId: ID!, input: PairPeerInput!): Boolean!
  respondToPairing(peerId: ID!, accepted: Boolean!): Boolean!
  unpairPeer(peerId: ID!): Boolean!
}

type Query {
  peerFileUrl(peerId: ID!, fileId: String!): String!
  peers: [Peer!]!
}

enum DeviceType {
	COMPUTER
	PHONE
	TABLET
	TV
	NAS
	OTHER
}

scalar Instant

input PairPeerInput {
	mode: PairingMode!
	password: String
}

type PairingCompletedNotice {
	deviceId: ID!
	deviceName: String!
	ip: String!
	port: Int
	deviceType: DeviceType
	requestId: String
}

enum PairingErrorCode {
	TIMEOUT
	REJECTED
	PASSWORD_REQUIRED
	INVALID_PASSWORD
	PEER_IDENTITY_CHANGED
	TOO_MANY_LOGIN_ATTEMPTS
	INTERNAL_ERROR
}

enum PairingMode {
	CHAT
	MANAGE
}

type PairingProgressNotice {
	verificationCode: String
	deviceId: ID!
	deviceName: String!
	error: PairingErrorCode
}

type PairingRequestNotice {
	fromIp: String!
	fromId: ID!
	fromName: String!
	deviceType: DeviceType!
	verificationCode: String!
	identityChanged: Boolean!
}

type Peer {
	id: ID!
	name: String!
	ip: String!
	status: PeerStatus!
	port: Int
	deviceType: DeviceType!
	createdAt: Instant!
	updatedAt: Instant!
	online: Boolean!
	managed: Boolean!
	key: String!
	publicKey: String!
	token: String!
}

enum PeerStatus {
	PAIRED
	UNPAIRED
	CHANNEL
}

작업

subscription

peersChanged

피어 레코드 변경 시 변경 신호를 받습니다.

graphql
subscription peersChanged {
  peersChanged
}
subscription

pairingRequested

결정을 기다리는 수신 페어링 요청을 받습니다.

graphql
subscription pairingRequested {
  pairingRequested { fromIp fromId fromName deviceType verificationCode identityChanged }
}
subscription

pairingCompleted

기기 페어링 완료 알림을 받습니다.

graphql
subscription pairingCompleted {
  pairingCompleted { deviceId deviceName ip port deviceType requestId }
}
subscription

pairingStarted

페어링 시도 시작 알림을 받습니다.

graphql
subscription pairingStarted {
  pairingStarted { verificationCode deviceId deviceName error }
}
subscription

pairingFailed

페어링 시도 실패 알림을 받습니다.

graphql
subscription pairingFailed {
  pairingFailed { verificationCode deviceId deviceName error }
}
subscription

pairingCanceled

페어링 시도 취소 알림을 받습니다.

graphql
subscription pairingCanceled {
  pairingCanceled { verificationCode deviceId deviceName error }
}
mutation

cancelPairing

지정한 기기에서 진행 중인 페어링을 취소합니다.

graphql
mutation cancelPairing($peerId: ID!) {
  cancelPairing(peerId: $peerId)
}
mutation

deletePeer

기기와 일대일 채팅 기록을 삭제합니다. 채널이 참조하면 채널용 기기 기록을 유지합니다.

graphql
mutation deletePeer($peerId: ID!) {
  deletePeer(peerId: $peerId)
}
mutation

pairPeer

채팅 페어링 또는 관리 로그인을 시작합니다. true는 요청이 접수되었음을 뜻합니다.

graphql
mutation pairPeer($peerId: ID!, $input: PairPeerInput!) {
  pairPeer(peerId: $peerId, input: $input)
}
mutation

respondToPairing

기기의 대기 중인 페어링 요청이나 신뢰 확인을 수락하거나 거절합니다.

graphql
mutation respondToPairing($peerId: ID!, $accepted: Boolean!) {
  respondToPairing(peerId: $peerId, accepted: $accepted)
}
mutation

unpairPeer

이 기기에서 페어링을 해제하고 관리 권한을 제거하며 채팅 기록은 유지합니다.

graphql
mutation unpairPeer($peerId: ID!) {
  unpairPeer(peerId: $peerId)
}
query

peerFileUrl

기기의 현재 저장된 주소로 파일 다운로드 URL을 만듭니다.

graphql
query peerFileUrl($peerId: ID!, $fileId: String!) {
  peerFileUrl(peerId: $peerId, fileId: $fileId)
}
query

peers

페어링됨, 페어링 해제됨, 채널 전용 기록을 포함한 모든 저장된 기기를 나열합니다.

graphql
query peers {
  peers { id name ip status port deviceType createdAt updatedAt }
}