Geliştiriciler için qub

geliştiriciler için qub

HTTP API, /api/v1 altında sürümlendirilir; OpenAPI belgesi şu anda API sürümünü 1.0.0 olarak bildirir. Üç entegrasyon yolu desteklenir:

• HTTP API — dış yüzeyin tamamı /api/v1/openapi.json içindeki x-audience: external olarak işaretlenmiş işlemlerden oluşturulur. Herkese açık işlemler kimlik bilgisi gerektirmez; tarayıcıdan yazma işlemleri Cloudflare Turnstile kullanır; Builder çağrıları Authorization: Bearer qub_sk_… kullanır. /api/v1/upload yerel olarak mühürlenmiş baytları kabul ederken /api/v1/seal, açıkça güvenilen sunucu tarafı düz metin yoludur.
• MCP sunucusu — tools/qub-mcp, oluşturma, okuma ve durum işlemleri için yerel bir Rust ikili dosyasıdır. Yerel olarak mühürler ve özel, sarılı qub'leri yayımlar. Yayınlama varsayılan olarak devre dışıdır; create_qub için hem QUB_API_KEY hem de QUB_MCP_ALLOW_CREATE=true gerekir. Okuma işlemleri, parça içeren tam teslimat URL'sini veya tx_id ile key_base64url değerlerini kabul eder.
• Gömme — <qub-embed src="https://qub.social/c/<tx_id>#<key>"> canlı geri sayımı ve açığa çıkarmayı sayfa içinde gösterir. Herkese açık qub'ler aynı src biçimini parça olmadan kullanır. Sabitlenmiş /embed/v1.js yükleyicisini kullanın; /embed.js yalnızca değişken takma addır.

Taşınabilir .qub paketleri içerik bütünlüğünü, drand turuna bağlanmayı ve imzaları çevrimdışı doğrular. Şifreli metnin belirli bir zamana kadar var olduğunu kanıtlamak için ayrıca doğrulanmış bir kalıcı depolama işlemi veya sabitlenmiş bir şeffaflık günlüğü kanıtı gerekir.

Ajanlara yönelik özet için llms.txt, birleştirilmiş dokümantasyon paketi için llms-full.txt, şemalar ve yanıtlar için işlenmiş OpenAPI başvurusu sayfalarına bakın.