Koppelen
Controleer app.capabilities voor functieondersteuning en app.access plus hostrechten voor autorisatie. Voorbeelden gebruiken synthetische waarden; vervang paden, ID’s, invoer en filters vóór aanroepen.
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))Open het JSON-segment om de volledige ondertekende invoer van dit synthetische voorbeeld te bekijken; de ontvanger controleert met de openbare sleutel van de ondertekenaar.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 toont, B scant. LAN c-id identificeert de afzender; BLE gebruikt een eigen transport. PAIR_CANCEL is optioneel.
Synthetische momentopname op een vast tijdstip; handtekeningen en requestIds komen overeen. 192.0.2.0/24 is gereserveerd voor documentatie. 8443 is de standaard-HTTPS-poort; gebruik in echte aanvragen de ontdekte poort. Deze tijdgebonden aanvragen kunnen niet ongewijzigd worden herhaald.
Bevestig in PlainApp Desktop eerst uitdrukkelijk dat je een nieuw apparaat of een apparaat met een gewijzigde openbare sleutel vertrouwt. Bij deze stap verschijnt geen vergelijkingscode; bij een gewijzigde sleutel zie je een waarschuwing. Gebruik je geen wachtwoord? Vergelijk dan de code die op beide apparaten verschijnt en keur het verzoek daarna op het andere apparaat goed. Bij verificatie met een wachtwoord kan het andere apparaat ook zonder code om goedkeuring vragen.
Typedefinities
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
}Bewerkingen
peersChanged
Een wijzigingssignaal ontvangen als peerrecords veranderen.
subscription peersChanged {
peersChanged
}pairingRequested
Een binnenkomende koppelingsaanvraag ontvangen die op een beslissing wacht.
subscription pairingRequested {
pairingRequested { fromIp fromId fromName deviceType verificationCode identityChanged }
}pairingCompleted
Een melding ontvangen dat apparaatkoppeling is voltooid.
subscription pairingCompleted {
pairingCompleted { deviceId deviceName ip port deviceType requestId }
}pairingStarted
Een melding ontvangen dat een koppelingspoging is gestart.
subscription pairingStarted {
pairingStarted { verificationCode deviceId deviceName error }
}pairingFailed
Een melding ontvangen dat een koppelingspoging is mislukt.
subscription pairingFailed {
pairingFailed { verificationCode deviceId deviceName error }
}pairingCanceled
Een melding ontvangen dat een koppelingspoging is geannuleerd.
subscription pairingCanceled {
pairingCanceled { verificationCode deviceId deviceName error }
}cancelPairing
De huidige koppeling van het opgegeven apparaat annuleren.
mutation cancelPairing($peerId: ID!) {
cancelPairing(peerId: $peerId)
}deletePeer
Apparaat en privéchatgeschiedenis verwijderen; het kanaalrecord behouden als een kanaal het nog gebruikt.
mutation deletePeer($peerId: ID!) {
deletePeer(peerId: $peerId)
}pairPeer
Chatkoppeling of beheerlogin starten; true bevestigt ontvangst.
mutation pairPeer($peerId: ID!, $input: PairPeerInput!) {
pairPeer(peerId: $peerId, input: $input)
}respondToPairing
Het openstaande koppelverzoek of de vertrouwensbevestiging van het apparaat accepteren of weigeren.
mutation respondToPairing($peerId: ID!, $accepted: Boolean!) {
respondToPairing(peerId: $peerId, accepted: $accepted)
}unpairPeer
Lokaal ontkoppelen en beheertoegang verwijderen met behoud van chatgeschiedenis.
mutation unpairPeer($peerId: ID!) {
unpairPeer(peerId: $peerId)
}peerFileUrl
Een download-URL maken met het huidige opgeslagen apparaatadres.
query peerFileUrl($peerId: ID!, $fileId: String!) {
peerFileUrl(peerId: $peerId, fileId: $fileId)
}peers
Alle opgeslagen apparaten tonen, gekoppeld, ontkoppeld of uitsluitend voor kanalen.
query peers {
peers { id name ip status port deviceType createdAt updatedAt }
}