Связывание
Поддержку функций проверяйте через app.capabilities, доступ — через app.access и разрешения хоста. Замените тестовые значения перед вызовом.
plainapp://pair?request=<URL-encoded JSON>QR
signature = Base64(Ed25519-Sign(Device A private key, signed))Ed25519-Verify(Device A public key, signed, Base64Decode(signature))Откройте сегмент JSON, чтобы посмотреть полный подписываемый ввод искусственного примера; получатель проверяет его открытым ключом подписавшей стороны.verificationCode = 73939800digest = SHA256(request.signature encoded as UTF-8)digest (hex) = ff44f60497bc235899f050f272165ec094a2f2c685e776d153a0711424b85dc0number = first 8 digest bytes as an unsigned big-endian integerverificationCode = number mod 100000000, padded to 8 decimal digitsQR: A показывает, B сканирует. c-id в LAN определяет отправителя; BLE использует свой транспорт. PAIR_CANCEL необязателен.
Искусственный снимок на фиксированный момент; подписи и requestIds согласованы. 192.0.2.0/24 зарезервирован для документации. 8443 — порт HTTPS по умолчанию; в реальных запросах используйте обнаруженный порт. Эти ограниченные по времени запросы нельзя повторить без изменений.
В PlainApp Desktop перед управлением новым устройством или устройством с изменившимся открытым ключом явно подтвердите, что доверяете ему. На этом этапе код не отображается, но при смене ключа появляется предупреждение. Если пароль не использовался, сравните код на обоих устройствах и только затем подтвердите запрос на другом устройстве. При использовании пароля другое устройство может запросить подтверждение, не показывая код.
Определения типов
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
}Операции
peersChanged
Получает сигнал при изменении записей узлов.
subscription peersChanged {
peersChanged
}pairingRequested
Получает входящий запрос сопряжения, ожидающий решения.
subscription pairingRequested {
pairingRequested { fromIp fromId fromName deviceType verificationCode identityChanged }
}pairingCompleted
Получает уведомление о завершении сопряжения устройств.
subscription pairingCompleted {
pairingCompleted { deviceId deviceName ip port deviceType requestId }
}pairingStarted
Получает уведомление о начале попытки сопряжения.
subscription pairingStarted {
pairingStarted { verificationCode deviceId deviceName error }
}pairingFailed
Получает уведомление о неудачной попытке сопряжения.
subscription pairingFailed {
pairingFailed { verificationCode deviceId deviceName error }
}pairingCanceled
Получает уведомление об отмене попытки сопряжения.
subscription pairingCanceled {
pairingCanceled { verificationCode deviceId deviceName error }
}cancelPairing
Отменить текущее сопряжение указанного устройства.
mutation cancelPairing($peerId: ID!) {
cancelPairing(peerId: $peerId)
}deletePeer
Удалить устройство и историю личного чата; сохранить запись, если на неё ещё ссылается канал.
mutation deletePeer($peerId: ID!) {
deletePeer(peerId: $peerId)
}pairPeer
Начать сопряжение для чата или вход для управления; true означает принятие запроса.
mutation pairPeer($peerId: ID!, $input: PairPeerInput!) {
pairPeer(peerId: $peerId, input: $input)
}respondToPairing
Принять или отклонить ожидающий запрос сопряжения или подтверждение доверия устройства.
mutation respondToPairing($peerId: ID!, $accepted: Boolean!) {
respondToPairing(peerId: $peerId, accepted: $accepted)
}unpairPeer
Отменить сопряжение локально и убрать доступ к управлению, сохранив историю чата.
mutation unpairPeer($peerId: ID!) {
unpairPeer(peerId: $peerId)
}peerFileUrl
Создать ссылку на скачивание по текущему сохранённому адресу устройства.
query peerFileUrl($peerId: ID!, $fileId: String!) {
peerFileUrl(peerId: $peerId, fileId: $fileId)
}peers
Показать все сохранённые устройства: сопряжённые, несопряжённые и используемые только каналами.
query peers {
peers { id name ip status port deviceType createdAt updatedAt }
}