Emparejamiento
Consultar app.capabilities para comprobar la compatibilidad de funciones y app.access junto con los permisos del anfitrión para la autorización. Los ejemplos usan valores sintéticos; sustituir las rutas, ID, entradas y filtros antes de llamar.
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))Abrir el segmento JSON para consultar la entrada firmada completa de este ejemplo sintético; el receptor verifica con la clave pública del firmante.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 lo muestra y B lo escanea. En LAN, c-id identifica al emisor; BLE usa su propio transporte. PAIR_CANCEL es opcional.
Instantánea sintética en un momento fijo; las firmas y requestIds coinciden. 192.0.2.0/24 está reservado para documentación. 8443 es el puerto HTTPS predeterminado; usar el puerto detectado en solicitudes reales. Estas solicitudes de duración limitada no pueden repetirse tal cual.
Para gestionar un dispositivo nuevo o cuya clave pública haya cambiado, confirma primero que confías en él desde PlainApp Desktop. En este paso no se muestra ningún código y se avisa si la clave ha cambiado. Si no has usado contraseña, compara el mismo código en ambos dispositivos antes de aprobar la solicitud en el otro dispositivo. Si has usado contraseña, el otro dispositivo puede pedir aprobación sin mostrar un código.
Definiciones de tipos
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
}Operaciones
peersChanged
Recibir una señal cuando cambien los registros de pares.
subscription peersChanged {
peersChanged
}pairingRequested
Recibir una solicitud entrante de vinculación pendiente de decisión.
subscription pairingRequested {
pairingRequested { fromIp fromId fromName deviceType verificationCode identityChanged }
}pairingCompleted
Recibir una notificación de finalización de la vinculación de dispositivos.
subscription pairingCompleted {
pairingCompleted { deviceId deviceName ip port deviceType requestId }
}pairingStarted
Recibir una notificación del inicio de un intento de vinculación.
subscription pairingStarted {
pairingStarted { verificationCode deviceId deviceName error }
}pairingFailed
Recibir una notificación de fallo de un intento de vinculación.
subscription pairingFailed {
pairingFailed { verificationCode deviceId deviceName error }
}pairingCanceled
Recibir una notificación de cancelación de un intento de vinculación.
subscription pairingCanceled {
pairingCanceled { verificationCode deviceId deviceName error }
}cancelPairing
Cancelar el emparejamiento actual del dispositivo indicado.
mutation cancelPairing($peerId: ID!) {
cancelPairing(peerId: $peerId)
}deletePeer
Eliminar el dispositivo y su historial de chat individual; conservar el registro si un canal aún lo referencia.
mutation deletePeer($peerId: ID!) {
deletePeer(peerId: $peerId)
}pairPeer
Iniciar el emparejamiento de chat o el acceso de administración; true confirma la recepción.
mutation pairPeer($peerId: ID!, $input: PairPeerInput!) {
pairPeer(peerId: $peerId, input: $input)
}respondToPairing
Aceptar o rechazar la solicitud de emparejamiento o confirmación de confianza pendiente del dispositivo.
mutation respondToPairing($peerId: ID!, $accepted: Boolean!) {
respondToPairing(peerId: $peerId, accepted: $accepted)
}unpairPeer
Desemparejar localmente y retirar el acceso de administración, conservando el historial de chat.
mutation unpairPeer($peerId: ID!) {
unpairPeer(peerId: $peerId)
}peerFileUrl
Crear una URL de descarga con la dirección guardada actual del dispositivo.
query peerFileUrl($peerId: ID!, $fileId: String!) {
peerFileUrl(peerId: $peerId, fileId: $fileId)
}peers
Listar todos los dispositivos guardados, emparejados, desemparejados o referenciados solo por canales.
query peers {
peers { id name ip status port deviceType createdAt updatedAt }
}