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 →
লাইব্রেরি কল

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