qub für Entwickler
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: externalmarkierten Operationen generiert. Öffentliche Operationen benötigen keine Zugangsdaten; Schreibzugriffe im Browser verwenden Cloudflare Turnstile; Builder-Aufrufe verwendenAuthorization: Bearer qub_sk_…./api/v1/uploadnimmt lokal versiegelte Bytes entgegen, während/api/v1/sealein ausdrücklich vertrauenswürdiger serverseitiger Klartextpfad ist. - MCP-Server —
tools/qub-mcpist ein lokales Rust-Binary mit fünf Werkzeugen:create_qub,read_qub,check_status,list_pending_operationsundverify_forecast_series. Es versiegelt lokal. qubs sind standardmäßig privat (verpackt, mit dem Schlüssel im Link-Fragment);visibility: "public"muss ausdrücklich gewählt werden: Der Timelock bleibt erhalten, der Schutz durch den Link entfällt. Die Veröffentlichung ist standardmäßig deaktiviert;create_quberfordert sowohlQUB_API_KEYals auchQUB_MCP_ALLOW_CREATE=true. Lesezugriffe nehmen eine Liefer-URL odertx_identgegen und benötigenkey_base64urlnur für private qubs. - Embed —
<qub-embed src="https://qub.social/c/<tx_id>#<key>">rendert den Live-Countdown und die Enthüllung inline. Öffentliche qubs verwenden dieselbesrc-Form ohne Fragment. Verwenden Sie den fest angehefteten Loader/embed/v1.js;/embed.jsist nur der bewegliche Alias.
Portable .qub-Bündel verifizieren Inhaltsintegrität, Bindung an die drand-Runde und Signaturen offline mit qub-verify. Das zeigt nicht, wann ein qub versiegelt wurde. Für öffentliche qubs melden qub-verify --timing und die MCP-Lesewerkzeuge die Blockzeit der Transaktion des qubs im dauerhaften Speicher, wie sie Gateways, die qub nicht betreibt, übereinstimmend angeben; für private qubs wird in diesem Release kein Zeitbeleg angeboten.
Ein kostenloser Builder-Testzugang (insgesamt 10 Veröffentlichungen und 10.000 authentifizierte Lesezugriffe; nur Upload und Lesen) wird auf dieser Seite angeboten, wenn die Registrierung geöffnet ist. Sie ist möglicherweise nicht geöffnet.
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.