qub voor ontwikkelaars
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 gebruikenAuthorization: Bearer qub_sk_…./api/v1/uploadaccepteert lokaal verzegelde bytes, terwijl/api/v1/sealeen expliciet vertrouwd serverpad voor platte tekst is. - MCP-server —
tools/qub-mcpis een lokaal Rust-programma met vijf tools:create_qub,read_qub,check_status,list_pending_operationsenverify_forecast_series. Het verzegelt lokaal. Standaard zijn qubs privé (ingepakt, met de sleutel in het linkfragment);visibility: "public"is een expliciete opt-in die de timelock behoudt en de afscherming door de link laat vallen. Publiceren is standaard uitgeschakeld;create_qubvereist zowelQUB_API_KEYalsQUB_MCP_ALLOW_CREATE=true. Leesbewerkingen accepteren een bezorg-URL oftx_id, en hebbenkey_base64urlalleen nodig voor privé-qubs. - Insluiten —
<qub-embed src="https://qub.social/c/<tx_id>#<key>">toont de live aftelling en onthulling inline. Openbare qubs gebruiken dezelfdesrc-vorm zonder fragment. Gebruik de vastgezette loader/embed/v1.js;/embed.jsis alleen de meebewegende alias.
Draagbare .qub-bundels verifiëren offline de inhoudsintegriteit, binding aan de drand-ronde en handtekeningen met qub-verify. Dat laat niet zien wanneer een qub is verzegeld. Voor openbare qubs melden qub-verify --timing en de MCP-leestools de bloktijd van de permanente-opslagtransactie van de qub, waarover gateways die niet door qub worden beheerd het eens zijn; bewijsmateriaal voor het tijdstip wordt in deze release niet aangeboden voor privé-qubs.
Een gratis Builder-proef (in totaal 10 publicaties en 10.000 geauthenticeerde leesbewerkingen; alleen uploaden en lezen) wordt op deze pagina aangeboden wanneer de inschrijving open is. Het kan zijn dat die niet open is.
Zie llms.txt voor de agentgerichte samenvatting, llms-full.txt voor het samengevoegde documentatiepakket en de gerenderde OpenAPI-referentie voor schema’s en responsen.