面向開發者的 qub

給開發者的 qub

HTTP API 在 /api/v1 下進行版本控制；其 OpenAPI 文件目前回報的 API 版本為 1.0.0。支援三種整合方式：

• HTTP API — 完整的外部介面根據 /api/v1/openapi.json 中標記為 x-audience: external 的操作產生。公開操作不需要憑證；瀏覽器寫入使用 Cloudflare Turnstile；Builder 呼叫使用 Authorization: Bearer qub_sk_…。/api/v1/upload 接收在本機封印的位元組，而 /api/v1/seal 是明確需要信任的伺服器端純文字路徑。
• MCP 伺服器 — tools/qub-mcp 是用於建立、讀取和狀態操作的本機 Rust 二進位檔。它在本機封印並發布經過包裝的私有 qub。預設停用發布；create_qub 同時需要 QUB_API_KEY 和 QUB_MCP_ALLOW_CREATE=true。讀取時可提供完整且帶有片段的傳遞 URL，或提供 tx_id 和 key_base64url。
• 嵌入 — <qub-embed src="https://qub.social/c/<tx_id>#<key>"> 在頁面中呈現即時倒數和揭示內容。公開 qub 使用不含片段的相同 src 格式。請使用固定載入器 /embed/v1.js；/embed.js 只是隨版本變動的別名。

可攜式 .qub 套件可離線驗證內容完整性、drand 輪次綁定和簽名。若要證明密文在特定時間之前已經存在，還需要經過驗證的永久儲存交易或已錨定的透明度日誌證明。

如需面向代理程式的摘要，請參閱 llms.txt；如需合併後的文件套件，請參閱 llms-full.txt；如需結構描述和回應，請參閱轉譯後的 OpenAPI 參考。