qub fejlesztőknek

A HTTP API verziója a /api/v1 alatt található; az OpenAPI-dokumentuma jelenleg az 1.0.0 API-verziót jelzi. Három integrációs útvonal támogatott:

HTTP API — a teljes külső felület az /api/v1/openapi.json x-audience: external jelölésű műveleteiből generálódik. A nyilvános műveletekhez nem kell hitelesítő adat; a böngészős írási műveletek Cloudflare Turnstile-t, a Builder-hívások Authorization: Bearer qub_sk_… fejlécet használnak. Az /api/v1/upload helyben lepecsételt bájtokat fogad, míg az /api/v1/seal kifejezetten megbízhatónak tekintett, kiszolgálóoldali nyíltszöveg-útvonal.
MCP-kiszolgáló — a tools/qub-mcp egy helyi Rust-bináris létrehozási, olvasási és állapotműveletekhez. Helyben pecsétel, és privát, burkolt qubokat tesz közzé. A közzététel alapértelmezés szerint le van tiltva; a create_qub használatához a QUB_API_KEY és a QUB_MCP_ALLOW_CREATE=true is szükséges. Az olvasás vagy a töredéket tartalmazó teljes kézbesítési URL-t, vagy a tx_id és key_base64url párost fogadja.
Beágyazás — a <qub-embed src="https://qub.social/c/<tx_id>#<key>"> helyben jeleníti meg az élő visszaszámlálót és a felfedést. A nyilvános qubok ugyanezt a src alakot használják töredék nélkül. Használd a rögzített /embed/v1.js betöltőt; az /embed.js csak a mozgó alias.

A hordozható .qub csomagok offline ellenőrzik a tartalom integritását, a drand-körhöz kötést és az aláírásokat. Annak bizonyításához, hogy a titkosított szöveg egy adott időpontig már létezett, emellett ellenőrzött állandó-tárolási tranzakció vagy lehorgonyzott átláthatósági napló bizonyítéka szükséges.

Az ügynököknek szánt összefoglalóért lásd az llms.txt fájlt, az összefűzött dokumentációs csomagért az llms-full.txt fájlt, a sémákért és válaszokért pedig a megjelenített OpenAPI-referenciát.