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লাইব্রেরি কল
Desktop-এর অংশ। 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: রিপ্লে ক্যাশ ভরে গেছে।