qub para programadores

A API HTTP tem versões sob /api/v1; o respetivo documento OpenAPI indica atualmente a versão de API 1.0.0. São suportadas três vias de integração:

API HTTP — toda a superfície externa é gerada a partir das operações marcadas com x-audience: external em /api/v1/openapi.json. As operações públicas não exigem credenciais; as escritas no navegador usam Cloudflare Turnstile; as chamadas Builder usam Authorization: Bearer qub_sk_…. /api/v1/upload aceita bytes selados localmente, enquanto /api/v1/seal é uma via de texto simples no servidor, explicitamente de confiança.
Servidor MCP — tools/qub-mcp é um binário Rust local para operações de criação, leitura e estado. Sela localmente e publica qubs privados encapsulados. A publicação está desativada por predefinição; create_qub requer QUB_API_KEY e QUB_MCP_ALLOW_CREATE=true. As leituras aceitam o URL de entrega completo com fragmento, ou tx_id juntamente com key_base64url.
Incorporação — <qub-embed src="https://qub.social/c/<tx_id>#<key>"> apresenta em linha a contagem decrescente e a revelação em direto. Os qubs públicos usam a mesma forma de src sem fragmento. Use o carregador fixo /embed/v1.js; /embed.js é apenas o alias móvel.

Os pacotes .qub portáteis verificam offline a integridade do conteúdo, a vinculação à ronda drand e as assinaturas. Provar que o texto cifrado existia até determinado momento exige ainda uma transação verificada de armazenamento permanente ou uma prova ancorada no registo de transparência.

Consulte llms.txt para o resumo destinado a agentes, llms-full.txt para o pacote de documentação concatenado e a referência OpenAPI renderizada para os esquemas e as respostas.