युग्मन
सुविधा समर्थन के लिए app.capabilities और प्राधिकरण के लिए app.access तथा होस्ट अनुमतियाँ जाँचें। उदाहरण कृत्रिम मान उपयोग करते हैं; कॉल करने से पहले पथ, ID, इनपुट और फ़िल्टर बदलें।
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 स्कैन करता है। LAN c-id प्रेषक पहचानता है; 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
डिवाइस के वर्तमान सहेजे गए पते से फ़ाइल डाउनलोड URL बनाएँ।
query peerFileUrl($peerId: ID!, $fileId: String!) {
peerFileUrl(peerId: $peerId, fileId: $fileId)
}peers
सभी सहेजे गए डिवाइस सूचीबद्ध करें, जिनमें पेयर किए गए, अनपेयर और केवल चैनल के लिए रखे रिकॉर्ड शामिल हैं।
query peers {
peers { id name ip status port deviceType createdAt updatedAt }
}