qub pour les développeurs

L’API HTTP est versionnée sous /api/v1 ; son document OpenAPI indique actuellement la version d’API 1.0.0. Trois voies d’intégration sont prises en charge :

API HTTP — la surface externe complète est générée à partir des opérations marquées x-audience: external dans /api/v1/openapi.json. Les opérations publiques ne nécessitent aucun identifiant ; les écritures depuis le navigateur utilisent Cloudflare Turnstile ; les appels Builder utilisent Authorization: Bearer qub_sk_…. /api/v1/upload accepte des octets scellés localement, tandis que /api/v1/seal est un chemin de texte en clair côté serveur, explicitement approuvé.
Serveur MCP — tools/qub-mcp est un binaire Rust local pour les opérations de création, de lecture et de statut. Il scelle localement et publie des qubs privés enveloppés. La publication est désactivée par défaut ; create_qub nécessite à la fois QUB_API_KEY et QUB_MCP_ALLOW_CREATE=true. Les lectures acceptent soit l’URL de remise complète contenant le fragment, soit tx_id avec key_base64url.
Embed — <qub-embed src="https://qub.social/c/<tx_id>#<key>"> affiche en ligne le compte à rebours et le dévoilement. Les qubs publics utilisent la même forme src sans fragment. Utilisez le loader épinglé /embed/v1.js ; /embed.js n’est que l’alias évolutif.

Les bundles portables .qub vérifient hors ligne l’intégrité du contenu, la liaison au tour drand et les signatures. Pour prouver que le texte chiffré existait à une date donnée, il faut en outre une transaction de stockage permanent vérifiée ou une preuve ancrée dans le journal de transparence.

Voir llms.txt pour le résumé destiné aux agents, llms-full.txt pour le bundle de documentation concaténé et la référence OpenAPI rendue pour les schémas et les réponses.