qub para desarrolladores

La API HTTP usa versiones bajo /api/v1; su documento OpenAPI informa actualmente de la versión de API 1.0.0. Se admiten tres rutas de integración:

API HTTP — la superficie externa completa se genera a partir de las operaciones marcadas como x-audience: external en /api/v1/openapi.json. Las operaciones públicas no requieren credenciales; las escrituras desde el navegador usan Cloudflare Turnstile y las llamadas Builder usan Authorization: Bearer qub_sk_…. /api/v1/upload acepta bytes sellados localmente, mientras que /api/v1/seal es una ruta de texto plano del lado del servidor que requiere confianza explícita.
Servidor MCP — tools/qub-mcp es un binario Rust local para operaciones de creación, lectura y estado. Sella localmente y publica qubs privados envueltos. La publicación está desactivada por defecto; create_qub requiere tanto QUB_API_KEY como QUB_MCP_ALLOW_CREATE=true. Las lecturas aceptan la URL de entrega completa con fragmento, o tx_id junto con key_base64url.
Embed — <qub-embed src="https://qub.social/c/<tx_id>#<key>"> renderiza en línea la cuenta regresiva y la revelación en vivo. Los qubs públicos usan el mismo formato de src sin fragmento. Usa el loader fijado /embed/v1.js; /embed.js es solo el alias móvil.

Los paquetes portátiles .qub verifican sin conexión la integridad del contenido, la vinculación con la ronda de drand y las firmas. Demostrar que el texto cifrado existía en un momento determinado requiere además una transacción verificada de almacenamiento permanente o una prueba anclada del registro de transparencia.

Consulta llms.txt para el resumen orientado a agentes, llms-full.txt para el paquete de documentación concatenado y la referencia OpenAPI renderizada para los esquemas y las respuestas.