qub for udviklere

HTTP-API'et er versionsinddelt under /api/v1; dets OpenAPI-dokument angiver i øjeblikket API-version 1.0.0. Der understøttes tre integrationsveje:

HTTP API — den komplette eksterne overflade genereres ud fra operationer, der er markeret med x-audience: external i /api/v1/openapi.json. Offentlige operationer kræver ingen legitimationsoplysninger; browserskrivninger bruger Cloudflare Turnstile; Builder-kald bruger Authorization: Bearer qub_sk_…. /api/v1/upload accepterer lokalt forseglede bytes, mens /api/v1/seal er en udtrykkeligt betroet serversideklartekststi.
MCP-server — tools/qub-mcp er en lokal Rust-binær til create/read/status-operationer. Den forsegler lokalt og udgiver private indpakkede qubs. Udgivelse er som standard deaktiveret; create_qub kræver både QUB_API_KEY og QUB_MCP_ALLOW_CREATE=true. Læsninger modtager enten den fulde leverings-URL med fragment eller tx_id plus key_base64url.
Embed — <qub-embed src="https://qub.social/c/<tx_id>#<key>"> gengiver live-nedtællingen og afsløringen inline. Offentlige qubs bruger samme src-form uden et fragment. Brug den fastgjorte loader /embed/v1.js; /embed.js er kun det bevægelige alias.

Portable .qub-bundter verificerer indholdsintegritet, binding til drand-runden og signaturer offline. Bevis for, at ciphertext eksisterede på et bestemt tidspunkt, kræver desuden en verificeret transaktion på permanent lager eller et forankret bevis fra transparensloggen.

Se llms.txt for den agentorienterede oversigt, llms-full.txt for det sammenkædede dokumentationsbundt og den renderede OpenAPI-reference for skemaer og svar.