qub pour les développeurs
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: externaldans /api/v1/openapi.json. Les opérations publiques ne nécessitent aucun identifiant ; les écritures depuis le navigateur utilisent Cloudflare Turnstile ; les appels Builder utilisentAuthorization: Bearer qub_sk_…./api/v1/uploadaccepte des octets scellés localement, tandis que/api/v1/sealest un chemin de texte en clair côté serveur, explicitement approuvé. - Serveur MCP —
tools/qub-mcpest un binaire Rust local doté de cinq outils :create_qub,read_qub,check_status,list_pending_operationsetverify_forecast_series. Il scelle localement. Les qubs sont privés par défaut (enveloppés, avec la clé dans le fragment du lien) ;visibility: "public"est une option explicite qui conserve le verrou temporel et supprime la protection par le lien. La publication est désactivée par défaut ;create_qubnécessite à la foisQUB_API_KEYetQUB_MCP_ALLOW_CREATE=true. Les lectures acceptent une URL de remise outx_id, et n’ont besoin dekey_base64urlque pour les qubs privés. - 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 formesrcsans fragment. Utilisez le loader épinglé/embed/v1.js;/embed.jsn’est que l’alias évolutif.
Les bundles portables .qub vérifient hors ligne, avec qub-verify, l’intégrité du contenu, la liaison au tour drand et les signatures. Cela n’indique pas quand un qub a été scellé. Pour les qubs publics, qub-verify --timing et les outils de lecture MCP rapportent l’heure du bloc de la transaction de stockage permanent du qub, sur laquelle s’accordent des passerelles que qub n’exploite pas ; aucun indice de datation n’est proposé pour les qubs privés dans cette version.
Un essai Builder gratuit (10 publications et 10 000 lectures authentifiées au total ; téléversement et lecture uniquement) est proposé sur cette page lorsque les inscriptions sont ouvertes. Elles peuvent ne pas l’être.
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.