開発者向け qub

開発者向け qub

HTTP API は /api/v1 以下でバージョン管理され、その OpenAPI ドキュメントが現在示す API バージョンは 1.0.0 です。次の 3 つの統合経路に対応しています。

• 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 リファレンスをご覧ください。