डेवलपर्स के लिए qub

HTTP API का संस्करण /api/v1 के अंतर्गत निर्धारित है; उसका OpenAPI दस्तावेज़ वर्तमान में API संस्करण 1.0.0 रिपोर्ट करता है। एकीकरण के तीन पथ समर्थित हैं:

HTTP API — पूरा external सरफ़ेस /api/v1/openapi.json में x-audience: external चिह्नित ऑपरेशनों से जनरेट होता है। सार्वजनिक ऑपरेशनों के लिए क्रेडेंशियल नहीं चाहिए; ब्राउज़र राइट Cloudflare Turnstile का उपयोग करते हैं; Builder कॉल Authorization: Bearer qub_sk_… का उपयोग करते हैं। /api/v1/upload स्थानीय रूप से मुहरबंद बाइट्स स्वीकार करता है, जबकि /api/v1/seal स्पष्ट रूप से विश्वसनीय सर्वर-साइड plaintext पथ है।
MCP server — tools/qub-mcp create/read/status ऑपरेशनों के लिए एक स्थानीय Rust बाइनरी है। यह स्थानीय रूप से मुहरबंद करता है और निजी रैप्ड qubs प्रकाशित करता है। प्रकाशन डिफ़ॉल्ट रूप से अक्षम है; create_qub के लिए QUB_API_KEY और QUB_MCP_ALLOW_CREATE=true, दोनों आवश्यक हैं। रीड पूरे फ़्रैगमेंट-युक्त डिलीवरी URL या tx_id और key_base64url को स्वीकार करते हैं।
Embed — <qub-embed src="https://qub.social/c/<tx_id>#<key>"> लाइव काउंटडाउन और प्रकटीकरण इनलाइन रेंडर करता है। सार्वजनिक qubs बिना फ़्रैगमेंट के उसी src रूप का उपयोग करते हैं। पिन किए गए लोडर /embed/v1.js का उपयोग करें; /embed.js केवल गतिशील उपनाम है।

पोर्टेबल .qub बंडल सामग्री की अखंडता, drand-राउंड बंधन और हस्ताक्षर ऑफ़लाइन सत्यापित करते हैं। यह साबित करने के लिए कि ciphertext किसी विशेष समय तक मौजूद था, अलग से सत्यापित स्थायी-संग्रहण लेन-देन या एंकर किया गया पारदर्शिता-लॉग प्रमाण भी आवश्यक है।

एजेंट-केंद्रित सारांश के लिए llms.txt, संयोजित दस्तावेज़ीकरण बंडल के लिए llms-full.txt, और स्कीमा तथा प्रतिक्रियाओं के लिए रेंडर किया गया OpenAPI संदर्भ देखें।