qub para desarrolladores
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: externalen /api/v1/openapi.json. Las operaciones públicas no requieren credenciales; las escrituras desde el navegador usan Cloudflare Turnstile y las llamadas Builder usanAuthorization: Bearer qub_sk_…./api/v1/uploadacepta bytes sellados localmente, mientras que/api/v1/seales una ruta de texto plano del lado del servidor que requiere confianza explícita. - Servidor MCP —
tools/qub-mcpes un binario Rust local con cinco herramientas:create_qub,read_qub,check_status,list_pending_operationsyverify_forecast_series. Sella localmente. Los qubs son privados por defecto (envueltos, con la clave en el fragmento del enlace);visibility: "public"es un opt-in explícito que mantiene el timelock y elimina la protección por enlace. La publicación está desactivada por defecto;create_qubrequiere tantoQUB_API_KEYcomoQUB_MCP_ALLOW_CREATE=true. Las lecturas aceptan una URL de entrega otx_id, y solo necesitankey_base64urlpara los qubs privados. - 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 desrcsin fragmento. Usa el loader fijado/embed/v1.js;/embed.jses 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 con qub-verify. Eso no muestra cuándo se selló un qub. Para los qubs públicos, qub-verify --timing y las herramientas de lectura de MCP informan del tiempo de bloque de la transacción de almacenamiento permanente del qub, en el que coinciden gateways que qub no opera; la evidencia cronológica no se ofrece para qubs privados en esta versión.
En esta página se ofrece una prueba gratuita de Builder (10 publicaciones y 10.000 lecturas autenticadas en total; solo subida y lectura) cuando la inscripción está abierta. Puede que no lo esté.
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.