qub fyrir þróunaraðila

qub fyrir forritara

HTTP-API-ið er útgáfustýrt undir /api/v1; OpenAPI-skjal þess tilgreinir nú API-útgáfu 1.0.0. Þrjár samþættingarleiðir eru studdar:

• HTTP API — allt ytra yfirborðið er myndað úr aðgerðum merktum x-audience: external í /api/v1/openapi.json. Opinberar aðgerðir þurfa engin skilríki; skrif úr vafra nota Cloudflare Turnstile; Builder-köll nota Authorization: Bearer qub_sk_…. /api/v1/upload tekur við staðbundið innsigluðum bætum en /api/v1/seal er sérstaklega treyst þjónsmegin leið fyrir hreinan texta.
• MCP-þjónn — tools/qub-mcp er staðbundin Rust-tvíundarskrá fyrir create/read/status-aðgerðir. Hún innsiglar staðbundið og birtir einkarekna, umlukta qub. Birting er sjálfgefið óvirk; create_qub krefst bæði QUB_API_KEY og QUB_MCP_ALLOW_CREATE=true. Lestur tekur annaðhvort fullt afhendingar-URL með broti eða tx_id ásamt key_base64url.
• Innfelling — <qub-embed src="https://qub.social/c/<tx_id>#<key>"> birtir lifandi niðurtalningu og birtingu innan línu. Opinberir qub nota sama src-form án brots. Notaðu festu hleðsluna /embed/v1.js; /embed.js er aðeins hreyfanlegt samheiti.

Færanlegir .qub-pakkar staðfesta heilleika efnis, bindingu við drand-lotu og undirskriftir án nettengingar. Til að sanna að dulritunartexti hafi verið til á tilteknum tíma þarf auk þess staðfesta færslu í varanlegri geymslu eða festa sönnun úr gagnsæisskrá.

Sjá llms.txt fyrir samantekt fyrir umboðsmenn, llms-full.txt fyrir sameinaðan skjalapakka og myndræna OpenAPI-tilvísun fyrir skemu og svör.