Main GraphQL HTTP
लॉगिन सत्र के लिए एन्क्रिप्ट किए गए अनुरोध।
key = Base64Decode(session.token)प्रमाणित सत्र; c-id = clientId
https://<host>:<port>/graphqlPOST /graphql
c-id: 706c6169-3b80-8f42-9a61-4e312e54d001
JSON({ requestId, query, variables })
requestId, UUIDv7 है और अनुरोध का समय शामिल करता है। variables, operationName और extensions वैकल्पिक हैं।
हर अनुरोध के लिए नया UUIDv7 requestId उपयोग करें। उसका समय सर्वर से ±30 मिनट के भीतर होना चाहिए। UUID के दोहराव मेमोरी में हटाए जाते हैं।
रीप्ले से सुरक्षा
requestId = UUIDv7()JSON { requestId, query, variables } → authenticated encryptionsession.token✕ → अस्वीकार करें|serverTime − requestId timestamp| ≤ 30 min✕ → अस्वीकार करेंsession → request-ID setलाइब्रेरी कॉल
डेस्कटॉप अंश। graphqlRequestPayload, UUIDv7 requestId बनाता है। HTTP_REQUEST, POST और तार्किक एंडपॉइंट को बाँधने वाले AAD से JSON एन्क्रिप्ट करें, फिर प्रतिक्रिया का बंधन सत्यापित करें।
// 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: रीप्ले कैश भर गया है।