API संदर्भ

Main GraphQL HTTP

लॉगिन सत्र के लिए एन्क्रिप्ट किए गए अनुरोध।

key = Base64Decode(session.token)प्रमाणित सत्र; c-id = clientId

क्लाइंट
https://<host>:<port>/graphql
सर्वर

POST /graphql

c-id: 706c6169-3b80-8f42-9a61-4e312e54d001

HTTP · binary

JSON({ requestId, query, variables })

requestId, UUIDv7 है और अनुरोध का समय शामिल करता है। variables, operationName और extensions वैकल्पिक हैं।

हर अनुरोध के लिए नया UUIDv7 requestId उपयोग करें। उसका समय सर्वर से ±30 मिनट के भीतर होना चाहिए। UUID के दोहराव मेमोरी में हटाए जाते हैं।

XChaCha20-Poly1305 · फ़ील्ड पर होवर या टैप करें
1 / 2

रीप्ले से सुरक्षा

requestId = UUIDv7()JSON { requestId, query, variables } → authenticated encryption
↓ POST /graphql
प्रमाणित करें और डिक्रिप्ट करेंsession.token✕ → अस्वीकार करें
↓
UUIDv7 का समय जाँचें|serverTime − requestId timestamp| ≤ 30 min✕ → अस्वीकार करें
↓
चलाने से पहले requestId दर्ज करेंsession → request-ID set
✓ ↓GraphQL चलाएँ
✕ ↓दोबारा इस्तेमाल किए गए requestId को अस्वीकार करें
Bearer API Token: बॉडी एन्क्रिप्शन के बिना HTTPS पर JSON →
लाइब्रेरी कॉल

डेस्कटॉप अंश। graphqlRequestPayload, UUIDv7 requestId बनाता है। HTTP_REQUEST, POST और तार्किक एंडपॉइंट को बाँधने वाले AAD से JSON एन्क्रिप्ट करें, फिर प्रतिक्रिया का बंधन सत्यापित करें।

typescript
// plain-desktop/src/lib/api/gql-client.ts
const payload = graphqlRequestPayload(query, variables)
const requestBody = chachaEncrypt(key, payload, httpRequestAad('/graphql'))
const response = await httpRequest(url, {
  method: 'POST', headers: { 'c-id': clientId }, body: requestBody
})
if (!response.ok) throw new Error(String(response.status))
const bytes = new Uint8Array(await response.arrayBuffer())
const result = JSON.parse(decryptGraphqlResponse(key, requestBody, bytes))
// Feature error codes are carried in extensions.code; message is diagnostic text.
if (result.errors?.length) throw GqlError.fromGraphql(result.errors[0])

HTTP 401: प्रमाणित सेशन मौजूद नहीं है या अमान्य है। सहेजी गई कुंजी रीस्टार्ट के बाद भी, रद्द या बदले जाने तक, मान्य रहती है। 400: requestId गलत प्रारूप में है, पुराना है या दोहराया गया है। 429: रीप्ले कैश भर गया है।