Eşleştirme
Özellik desteği için app.capabilities, yetkilendirme için app.access ve ana makine izinlerini kontrol edin. Çağrıdan önce örnek değerleri değiştirin.
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))Bu sentetik örneğin tam imzalı girdisini incelemek için JSON bölümünü açın; alıcı imzalayanın açık anahtarıyla doğrular.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 gösterir, B tarar. LAN c-id göndereni tanımlar; BLE kendi aktarımını kullanır. PAIR_CANCEL isteğe bağlıdır.
Sabit zamandaki sentetik anlık görüntü; imzalar ve requestIds eşleşir. 192.0.2.0/24 belgelere ayrılmıştır. 8443 varsayılan HTTPS portudur; gerçek isteklerde keşfedilen portu kullanın. Bu zaman sınırlı istekler aynen yeniden oynatılamaz.
PlainApp Desktop’ta yeni bir cihazı ya da açık anahtarı değişmiş bir cihazı yönetmeden önce ona güvendiğinizi açıkça onaylayın. Bu adımda karşılaştırma kodu gösterilmez; anahtar değişmişse uyarı gösterilir. Parola kullanmadıysanız, diğer cihazda onay vermeden önce iki cihazda görünen kodun aynı olduğunu kontrol edin. Parolayla doğrulama yaptıysanız, diğer cihaz kod göstermeden de onay isteyebilir.
Tip Tanımları
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
}İşlemler
peersChanged
Eş kayıtları değiştiğinde değişiklik sinyali alır.
subscription peersChanged {
peersChanged
}pairingRequested
Karar bekleyen gelen eşleştirme isteğini alır.
subscription pairingRequested {
pairingRequested { fromIp fromId fromName deviceType verificationCode identityChanged }
}pairingCompleted
Cihaz eşleştirmesinin tamamlandığı bildirimini alır.
subscription pairingCompleted {
pairingCompleted { deviceId deviceName ip port deviceType requestId }
}pairingStarted
Eşleştirme denemesinin başladığı bildirimini alır.
subscription pairingStarted {
pairingStarted { verificationCode deviceId deviceName error }
}pairingFailed
Eşleştirme denemesinin başarısız olduğu bildirimini alır.
subscription pairingFailed {
pairingFailed { verificationCode deviceId deviceName error }
}pairingCanceled
Eşleştirme denemesinin iptal edildiği bildirimini alır.
subscription pairingCanceled {
pairingCanceled { verificationCode deviceId deviceName error }
}cancelPairing
Belirtilen cihazın devam eden eşleştirmesini iptal eder.
mutation cancelPairing($peerId: ID!) {
cancelPairing(peerId: $peerId)
}deletePeer
Cihazı ve bire bir sohbet geçmişini siler; bir kanal hâlâ kullanıyorsa kanal kaydını korur.
mutation deletePeer($peerId: ID!) {
deletePeer(peerId: $peerId)
}pairPeer
Sohbet eşleştirmesini veya yönetim girişini başlatır; true isteğin alındığını belirtir.
mutation pairPeer($peerId: ID!, $input: PairPeerInput!) {
pairPeer(peerId: $peerId, input: $input)
}respondToPairing
Cihazın bekleyen eşleştirme isteğini veya güven onayını kabul eder ya da reddeder.
mutation respondToPairing($peerId: ID!, $accepted: Boolean!) {
respondToPairing(peerId: $peerId, accepted: $accepted)
}unpairPeer
Yerel eşleştirmeyi kaldırır ve yönetim erişimini temizler; sohbet geçmişini korur.
mutation unpairPeer($peerId: ID!) {
unpairPeer(peerId: $peerId)
}peerFileUrl
Cihazın güncel kayıtlı adresiyle dosya indirme URL’si oluşturur.
query peerFileUrl($peerId: ID!, $fileId: String!) {
peerFileUrl(peerId: $peerId, fileId: $fileId)
}peers
Eşleştirilmiş, eşleştirilmemiş ve yalnızca kanalların kullandığı tüm kayıtlı cihazları listeler.
query peers {
peers { id name ip status port deviceType createdAt updatedAt }
}