Main GraphQL HTTP
Solicitações criptografadas para uma sessão autenticada.
key = Base64Decode(session.token)Sessão autenticada; c-id = clientId
https://<host>:<port>/graphqlPOST /graphql
c-id: 706c6169-3b80-8f42-9a61-4e312e54d001
JSON({ requestId, query, variables })
requestId é UUIDv7 e contém a hora do pedido. variables, operationName e extensions são opcionais.
Usar um requestId UUIDv7 novo para cada pedido. A sua hora deve estar a ±30 minutos da do servidor. Os UUID são desduplicados em memória.
Proteção contra repetição
requestId = UUIDv7()JSON { requestId, query, variables } → authenticated encryptionsession.token✕ → Rejeitar|serverTime − requestId timestamp| ≤ 30 min✕ → Rejeitarsession → request-ID setChamadas à biblioteca
Trechos do Desktop. graphqlRequestPayload cria um requestId UUIDv7. Criptografe o JSON com AAD vinculando HTTP_REQUEST, POST e o endpoint lógico; depois valide o vínculo da resposta.
// 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: sessão autenticada ausente ou inválida. A chave de sessão guardada continua válida após reiniciar até ser revogada ou substituída. 400: requestId malformado, expirado ou duplicado. 429: cache de proteção contra repetição cheia.