qub för utvecklare

HTTP-API:t versionshanteras under /api/v1; dess OpenAPI-dokument anger för närvarande API-version 1.0.0. Tre integrationsvägar stöds:

HTTP-API — hela den externa ytan genereras från operationer som märkts med x-audience: external i /api/v1/openapi.json. Offentliga operationer kräver inga autentiseringsuppgifter; skrivningar från webbläsaren använder Cloudflare Turnstile; Builder-anrop använder Authorization: Bearer qub_sk_…. /api/v1/upload tar emot lokalt förseglade byte, medan /api/v1/seal är en uttryckligen betrodd klartextväg på serversidan.
MCP-server — tools/qub-mcp är ett lokalt Rust-binärprogram för att skapa, läsa och kontrollera status. Det förseglar lokalt och publicerar privata, inpackade qubbar. Publicering är inaktiverad som standard; create_qub kräver både QUB_API_KEY och QUB_MCP_ALLOW_CREATE=true. Läsningar tar antingen den fullständiga leverans-URL:en med fragment eller tx_id tillsammans med key_base64url.
Inbäddning — <qub-embed src="https://qub.social/c/<tx_id>#<key>"> visar den direktsända nedräkningen och avslöjandet på sidan. Offentliga qubbar använder samma src-form utan fragment. Använd den fasta laddaren /embed/v1.js; /embed.js är endast det rörliga aliaset.

Portabla .qub-paket verifierar innehållets integritet, bindningen till drand-rundan och signaturer offline. För att bevisa att chiffertexten fanns vid en viss tidpunkt krävs dessutom en verifierad transaktion i permanent lagring eller ett förankrat bevis från transparensloggen.

Se llms.txt för den agentinriktade sammanfattningen, llms-full.txt för det sammanfogade dokumentationspaketet och den renderade OpenAPI-referensen för scheman och svar.