qub למפתחים

ה-HTTP API מנוהל בגרסאות תחת /api/v1; מסמך OpenAPI שלו מדווח כעת על גרסת API 1.0.0. שלושה מסלולי שילוב נתמכים:

HTTP API — המשטח החיצוני המלא נוצר מהפעולות המסומנות x-audience: external ב-/api/v1/openapi.json. פעולות פומביות אינן דורשות פרטי גישה; כתיבות בדפדפן משתמשות ב-Cloudflare Turnstile; קריאות Builder משתמשות ב-Authorization: Bearer qub_sk_…. הנתיב /api/v1/upload מקבל בתים שנחתמו מקומית, ואילו /api/v1/seal הוא נתיב טקסט גלוי מהימן במפורש בצד השרת.
שרת MCP — tools/qub-mcp הוא בינארי Rust מקומי לפעולות יצירה, קריאה וסטטוס. הוא חותם מקומית ומפרסם qubs פרטיים עטופים. הפרסום מושבת כברירת מחדל; create_qub דורש גם QUB_API_KEY וגם QUB_MCP_ALLOW_CREATE=true. פעולות קריאה מקבלות את כתובת המסירה המלאה הנושאת מקטע, או tx_id יחד עם key_base64url.
הטמעה — <qub-embed src="https://qub.social/c/<tx_id>#<key>"> מעבד את הספירה לאחור החיה ואת החשיפה בתוך העמוד. qubs פומביים משתמשים באותה צורת src בלי מקטע. יש להשתמש בטוען המקובע /embed/v1.js; הנתיב /embed.js הוא כינוי נע בלבד.

חבילות .qub ניידות מאמתות במצב לא מקוון את שלמות התוכן, הקישור לסבב drand וחתימות. הוכחה שהצופן התקיים עד זמן מסוים דורשת בנוסף עסקה מאומתת באחסון קבוע או הוכחת יומן שקיפות מעוגנת.

ראה llms.txt לסיכום המיועד לסוכנים, llms-full.txt לחבילת התיעוד המשורשרת ואת סימוכין OpenAPI המעובדים לסכמות ולתגובות.