面向开发者的 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 参考。