qub voor ontwikkelaars

De HTTP-API is geversioneerd onder /api/v1; het OpenAPI-document vermeldt momenteel API-versie 1.0.0. Er worden drie integratiepaden ondersteund:

HTTP-API — het volledige externe oppervlak wordt gegenereerd uit bewerkingen die in /api/v1/openapi.json zijn gemarkeerd met x-audience: external. Openbare bewerkingen vereisen geen inloggegevens; schrijfacties in de browser gebruiken Cloudflare Turnstile; Builder-aanroepen gebruiken Authorization: Bearer qub_sk_…. /api/v1/upload accepteert lokaal verzegelde bytes, terwijl /api/v1/seal een expliciet vertrouwd serverpad voor platte tekst is.
MCP-server — tools/qub-mcp is een lokaal Rust-programma voor maak-, lees- en statusbewerkingen. Het verzegelt lokaal en publiceert privé, ingepakte qubs. Publiceren is standaard uitgeschakeld; create_qub vereist zowel QUB_API_KEY als QUB_MCP_ALLOW_CREATE=true. Leesbewerkingen accepteren de volledige bezorg-URL met fragment, of tx_id plus key_base64url.
Insluiten — <qub-embed src="https://qub.social/c/<tx_id>#<key>"> toont de live aftelling en onthulling inline. Openbare qubs gebruiken dezelfde src-vorm zonder fragment. Gebruik de vastgezette loader /embed/v1.js; /embed.js is alleen de meebewegende alias.

Draagbare .qub-bundels verifiëren offline de inhoudsintegriteit, binding aan de drand-ronde en handtekeningen. Bewijzen dat de cijfertekst op een bepaald tijdstip bestond, vereist daarnaast een geverifieerde transactie in permanente opslag of een verankerd bewijs uit het transparantielogboek.

Zie llms.txt voor de agentgerichte samenvatting, llms-full.txt voor het samengevoegde documentatiepakket en de gerenderde OpenAPI-referentie voor schema’s en responsen.