qub per sviluppatori

L'API HTTP è versionata sotto /api/v1; il suo documento OpenAPI riporta attualmente la versione API 1.0.0. Sono supportati tre percorsi di integrazione:

API HTTP — la superficie esterna completa è generata dalle operazioni contrassegnate con x-audience: external in /api/v1/openapi.json. Le operazioni pubbliche non richiedono credenziali; le scritture dal browser usano Cloudflare Turnstile; le chiamate Builder usano Authorization: Bearer qub_sk_…. /api/v1/upload accetta byte sigillati localmente, mentre /api/v1/seal è un percorso di plaintext lato server esplicitamente fidato.
Server MCP — tools/qub-mcp è un binario Rust locale per le operazioni di creazione, lettura e stato. Sigilla localmente e pubblica qub privati avvolti. La pubblicazione è disabilitata per default; create_qub richiede sia QUB_API_KEY sia QUB_MCP_ALLOW_CREATE=true. Le letture accettano il link di consegna completo con il frammento oppure tx_id insieme a key_base64url.
Embed — <qub-embed src="https://qub.social/c/<tx_id>#<key>"> renderizza in linea il conto alla rovescia in tempo reale e la rivelazione. I qub pubblici usano la stessa forma di src senza frammento. Usa il loader pinnato /embed/v1.js; /embed.js è soltanto l'alias mobile.

I bundle .qub portabili verificano offline l'integrità del contenuto, il binding al drand round e le firme. Dimostrare che il ciphertext esisteva entro un determinato momento richiede inoltre una transazione di archivio permanente verificata o una prova del log di trasparenza ancorata.

Vedi llms.txt per il riepilogo rivolto agli agenti, llms-full.txt per il bundle della documentazione concatenata e il riferimento OpenAPI renderizzato per schemi e risposte.