Associazione
Verificare app.capabilities per il supporto delle funzionalità e app.access insieme alle autorizzazioni host per l’autorizzazione. Gli esempi usano valori sintetici; sostituire percorsi, ID, input e filtri prima della chiamata.
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))Aprire il segmento JSON per esaminare l’input firmato completo di questo esempio sintetico; il destinatario verifica con la chiave pubblica del firmatario.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 mostra, B scansiona. In LAN c-id identifica il mittente; BLE usa il proprio trasporto. PAIR_CANCEL è facoltativo.
Istantanea sintetica a un istante fisso; firme e requestIds corrispondono. 192.0.2.0/24 è riservato alla documentazione. 8443 è la porta HTTPS predefinita; usare la porta rilevata nelle richieste reali. Queste richieste a validità limitata non possono essere riprodotte così come sono.
In PlainApp Desktop, per gestire un nuovo dispositivo o un dispositivo la cui chiave pubblica è cambiata, conferma prima di ritenerlo attendibile. In questo passaggio non compare alcun codice di confronto; se la chiave è cambiata, viene mostrato un avviso. Se non hai usato una password, confronta il codice mostrato su entrambi i dispositivi prima di approvare la richiesta sull’altro dispositivo. Con la password, l’altro dispositivo può chiedere l’approvazione senza mostrare un codice.
Definizioni di tipo
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
}Operazioni
peersChanged
Ricevere un segnale quando cambiano i record dei peer.
subscription peersChanged {
peersChanged
}pairingRequested
Ricevere una richiesta di associazione in arrivo in attesa di decisione.
subscription pairingRequested {
pairingRequested { fromIp fromId fromName deviceType verificationCode identityChanged }
}pairingCompleted
Ricevere una notifica di completamento dell’associazione dei dispositivi.
subscription pairingCompleted {
pairingCompleted { deviceId deviceName ip port deviceType requestId }
}pairingStarted
Ricevere una notifica di avvio di un tentativo di associazione.
subscription pairingStarted {
pairingStarted { verificationCode deviceId deviceName error }
}pairingFailed
Ricevere una notifica di fallimento di un tentativo di associazione.
subscription pairingFailed {
pairingFailed { verificationCode deviceId deviceName error }
}pairingCanceled
Ricevere una notifica di annullamento di un tentativo di associazione.
subscription pairingCanceled {
pairingCanceled { verificationCode deviceId deviceName error }
}cancelPairing
Annulla l’abbinamento in corso del dispositivo indicato.
mutation cancelPairing($peerId: ID!) {
cancelPairing(peerId: $peerId)
}deletePeer
Elimina il dispositivo e la cronologia della chat individuale; conserva il record se un canale lo usa ancora.
mutation deletePeer($peerId: ID!) {
deletePeer(peerId: $peerId)
}pairPeer
Avvia l’abbinamento chat o l’accesso di gestione; true conferma la ricezione.
mutation pairPeer($peerId: ID!, $input: PairPeerInput!) {
pairPeer(peerId: $peerId, input: $input)
}respondToPairing
Accetta o rifiuta la richiesta di abbinamento o la conferma di fiducia in sospeso del dispositivo.
mutation respondToPairing($peerId: ID!, $accepted: Boolean!) {
respondToPairing(peerId: $peerId, accepted: $accepted)
}unpairPeer
Annulla l’abbinamento locale e rimuovi l’accesso di gestione mantenendo le chat.
mutation unpairPeer($peerId: ID!) {
unpairPeer(peerId: $peerId)
}peerFileUrl
Crea un URL di download con l’indirizzo attualmente salvato del dispositivo.
query peerFileUrl($peerId: ID!, $fileId: String!) {
peerFileUrl(peerId: $peerId, fileId: $fileId)
}peers
Elenca tutti i dispositivi salvati, abbinati, non abbinati o usati solo dai canali.
query peers {
peers { id name ip status port deviceType createdAt updatedAt }
}