qub for utviklere

HTTP-API-et er versjonert under /api/v1; OpenAPI-dokumentet rapporterer for tiden API-versjon 1.0.0. Tre integrasjonsveier støttes:

HTTP API — hele den eksterne overflaten genereres fra operasjoner merket x-audience: external i /api/v1/openapi.json. Offentlige operasjoner trenger ingen legitimasjon; nettleserskrivinger bruker Cloudflare Turnstile; Builder-kall bruker Authorization: Bearer qub_sk_…. /api/v1/upload tar imot lokalt forseglede bytes, mens /api/v1/seal er en uttrykkelig betrodd server-side klartekstbane.
MCP-server — tools/qub-mcp er en lokal Rust-binær for opprettings-, lese- og statusoperasjoner. Den forsegler lokalt og publiserer private innpakkede qub-er. Publisering er deaktivert som standard; create_qub krever både QUB_API_KEY og QUB_MCP_ALLOW_CREATE=true. Lesinger tar enten den fullstendige leverings-URL-en med fragment eller tx_id sammen med key_base64url.
Innebygging — <qub-embed src="https://qub.social/c/<tx_id>#<key>"> gjengir den direkte nedtellingen og avsløringen inline. Offentlige qub-er bruker den samme src-formen uten fragment. Bruk den festede lasteren /embed/v1.js; /embed.js er bare det bevegelige aliaset.

Portable .qub-bundler verifiserer innholdsintegritet, binding til drand-runden og signaturer frakoblet. Bevis for at chifferteksten eksisterte på et bestemt tidspunkt, krever i tillegg en verifisert transaksjon i permanent lagring eller et forankret transparensloggbevis.

Se llms.txt for det agentrettede sammendraget, llms-full.txt for den sammenkoblede dokumentasjonspakken og den gjengitte OpenAPI-referansen for skjemaer og svar.