qub für Entwickler

Die HTTP-API ist unter /api/v1 versioniert; ihr OpenAPI-Dokument weist derzeit die API-Version 1.0.0 aus. Drei Integrationswege werden unterstützt:

HTTP-API — Die vollständige externe Oberfläche wird aus den in /api/v1/openapi.json mit x-audience: external markierten Operationen generiert. Öffentliche Operationen benötigen keine Zugangsdaten; Schreibzugriffe im Browser verwenden Cloudflare Turnstile; Builder-Aufrufe verwenden Authorization: Bearer qub_sk_…. /api/v1/upload nimmt lokal versiegelte Bytes entgegen, während /api/v1/seal ein ausdrücklich vertrauenswürdiger serverseitiger Klartextpfad ist.
MCP-Server — tools/qub-mcp ist ein lokales Rust-Binary für Erstellungs-, Lese- und Statusoperationen. Es versiegelt lokal und veröffentlicht private verpackte qubs. Die Veröffentlichung ist standardmäßig deaktiviert; create_qub erfordert sowohl QUB_API_KEY als auch QUB_MCP_ALLOW_CREATE=true. Lesezugriffe nehmen entweder die vollständige Liefer-URL mit Fragment oder tx_id plus key_base64url entgegen.
Embed — <qub-embed src="https://qub.social/c/<tx_id>#<key>"> rendert den Live-Countdown und die Enthüllung inline. Öffentliche qubs verwenden dieselbe src-Form ohne Fragment. Verwenden Sie den fest angehefteten Loader /embed/v1.js; /embed.js ist nur der bewegliche Alias.

Portable .qub-Bündel verifizieren Inhaltsintegrität, Bindung an die drand-Runde und Signaturen offline. Der Nachweis, dass der Chiffretext zu einem bestimmten Zeitpunkt bereits existierte, erfordert zusätzlich eine verifizierte Transaktion im dauerhaften Speicher oder einen verankerten Transparenz-Log-Beweis.

Siehe llms.txt für die agentenorientierte Zusammenfassung, llms-full.txt für das zusammengefügte Dokumentationsbündel und die gerenderte OpenAPI-Referenz für Schemata und Antworten.