qub para sa mga developer

Naka-version ang HTTP API sa ilalim ng /api/v1; kasalukuyang nag-uulat ang dokumentong OpenAPI nito ng bersyon ng API na 1.0.0. Tatlong landas ng integrasyon ang sinusuportahan:

HTTP API — binubuo ang kumpletong panlabas na surface mula sa mga operasyong minarkahang x-audience: external sa /api/v1/openapi.json. Hindi kailangan ng kredensyal ang mga pampublikong operasyon; gumagamit ng Cloudflare Turnstile ang mga pagsusulat sa browser; gumagamit ng Authorization: Bearer qub_sk_… ang mga tawag ng Builder. Tumatanggap ang /api/v1/upload ng mga byte na lokal na naselyuhan, samantalang ang /api/v1/seal ay tahasang pinagkakatiwalaang server-side na landas para sa plaintext.
MCP server — ang tools/qub-mcp ay lokal na Rust binary para sa mga operasyong create, read, at status. Lokal itong nagseselyo at naglalathala ng mga pribadong nakabalot na qub. Naka-disable ang paglalathala bilang default; kailangan ng create_qub ang parehong QUB_API_KEY at QUB_MCP_ALLOW_CREATE=true. Tumatanggap ang pagbasa ng buong delivery URL na may fragment, o ng tx_id kasama ang key_base64url.
Pag-embed — inline na ipinapakita ng <qub-embed src="https://qub.social/c/<tx_id>#<key>"> ang live countdown at paglalantad. Ginagamit ng mga pampublikong qub ang parehong anyo ng src nang walang fragment. Gamitin ang naka-pin na loader na /embed/v1.js; gumagalaw na alias lamang ang /embed.js.

Offline na bineberipika ng mga portable na .qub bundle ang integridad ng nilalaman, pagkakatali sa round ng drand, at mga lagda. Upang patunayang umiral ang ciphertext pagsapit ng isang partikular na oras, kailangan din ng nabeberipikang transaksyon sa permanenteng imbakan o naka-anchor na patunay mula sa transparency log.

Tingnan ang llms.txt para sa buod na nakatuon sa mga agent, ang llms-full.txt para sa pinagsamang dokumentasyon, at ang na-render na sanggunian ng OpenAPI para sa mga schema at tugon.