PlainApp
API-referentie

Main GraphQL HTTP

Versleutelde verzoeken voor een aangemelde sessie.

key = Base64Decode(session.token)Geauthenticeerde sessie; c-id = clientId

Client
https://<host>:<port>/graphql
Server

POST /graphql

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

HTTP · binary

JSON({ requestId, query, variables })

requestId is UUIDv7 en bevat de aanvraagtijd. variables, operationName en extensions zijn optioneel.

Gebruik voor elke aanvraag een nieuwe UUIDv7-requestId. De tijd ervan moet binnen ±30 minuten van de servertijd liggen. UUID-waarden worden in het geheugen ontdubbeld.

XChaCha20-Poly1305 · Beweeg over een veld of tik erop
1 / 2

Replaybeveiliging

requestId = UUIDv7()JSON { requestId, query, variables } → authenticated encryption
↓ POST /graphql
Authenticeren en ontsleutelensession.token✕ → Weigeren
↓
UUIDv7-tijd controleren|serverTime − requestId timestamp| ≤ 30 min✕ → Weigeren
↓
requestId vóór uitvoering opslaansession → request-ID set
✓ ↓GraphQL uitvoeren
✕ ↓Hergebruikte requestId weigeren
Bearer-API-token: JSON via HTTPS, zonder bodyversleuteling →
Bibliotheekaanroepen

Desktopfragmenten. graphqlRequestPayload maakt een UUIDv7-requestId. Versleutel JSON met AAD die HTTP_REQUEST, POST en het logische eindpunt bindt; controleer daarna de antwoordbinding.

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: de geauthenticeerde sessie ontbreekt of is ongeldig. Een opgeslagen sessiesleutel blijft na een herstart geldig totdat die wordt ingetrokken of vervangen. 400: onjuiste, verlopen of dubbele requestId. 429: cache voor herhalingsbeveiliging vol.