qub pro vývojáře

HTTP API je verzováno pod /api/v1; jeho dokument OpenAPI v současnosti uvádí verzi API 1.0.0. Podporovány jsou tři integrační cesty:

HTTP API — úplný externí povrch se generuje z operací označených x-audience: external v /api/v1/openapi.json. Veřejné operace nevyžadují přihlašovací údaje; zápisy z prohlížeče používají Cloudflare Turnstile; volání Builder používají Authorization: Bearer qub_sk_…. /api/v1/upload přijímá lokálně zapečetěné bajty, zatímco /api/v1/seal je výslovně důvěryhodná serverová cesta s prostým textem.
MCP server — tools/qub-mcp je lokální binárka v Rustu pro operace vytvoření, čtení a zjištění stavu. Pečetí lokálně a publikuje soukromé zabalené quby. Publikování je ve výchozím stavu zakázáno; create_qub vyžaduje zároveň QUB_API_KEY a QUB_MCP_ALLOW_CREATE=true. Čtení přijímá buď úplnou doručovací adresu URL s fragmentem, nebo tx_id spolu s key_base64url.
Vložení — <qub-embed src="https://qub.social/c/<tx_id>#<key>"> vykresluje živý odpočet a odhalení přímo na stránce. Veřejné quby používají stejný tvar src bez fragmentu. Používejte připnutý načítací skript /embed/v1.js; /embed.js je pouze pohyblivý alias.

Přenosné balíčky .qub ověřují integritu obsahu, vazbu na kolo drand a podpisy offline. Důkaz, že šifrovaný text existoval v určitém čase, navíc vyžaduje ověřenou transakci trvalého úložiště nebo ukotvený důkaz z logu transparentnosti.

Viz llms.txt pro shrnutí určené agentům, llms-full.txt pro zřetězený balíček dokumentace a vykreslenou referenci OpenAPI pro schémata a odpovědi.