qub i ddatblygwyr

qub i ddatblygwyr

Mae fersiwn yr API HTTP o dan /api/v1; ar hyn o bryd mae ei ddogfen OpenAPI yn nodi fersiwn API 1.0.0. Cefnogir tri llwybr integreiddio:

• API HTTP — cynhyrchir yr wyneb allanol cyflawn o weithrediadau sydd wedi’u marcio’n x-audience: external yn /api/v1/openapi.json. Nid oes angen manylion adnabod ar weithrediadau cyhoeddus; mae ysgrifennu o borwr yn defnyddio Cloudflare Turnstile; mae galwadau Builder yn defnyddio Authorization: Bearer qub_sk_…. Mae /api/v1/upload yn derbyn beitiau sydd wedi’u selio’n lleol, tra bo /api/v1/seal yn llwybr testun plaen ochr-gweinydd sydd wedi’i ymddiried yn benodol.
• Gweinydd MCP — deuaidd Rust lleol yw tools/qub-mcp ar gyfer gweithrediadau creu/darllen/statws. Mae’n selio’n lleol ac yn cyhoeddi qubs preifat wedi’u lapio. Mae cyhoeddi wedi’i analluogi’n ddiofyn; mae angen QUB_API_KEY a QUB_MCP_ALLOW_CREATE=true ar create_qub. Mae darlleniadau yn derbyn naill ai’r URL trosglwyddo cyflawn sy’n cynnwys darn, neu tx_id ynghyd â key_base64url.
• Mewnblaniad — mae <qub-embed src="https://qub.social/c/<tx_id>#<key>"> yn rendro’r cyfrif i lawr byw a’r datgeliad yn fewnlinol. Mae qubs cyhoeddus yn defnyddio’r un ffurf src heb ddarn. Defnyddiwch y llwythwr piniedig /embed/v1.js; dim ond yr alias symudol yw /embed.js.

Mae bwndeli .qub cludadwy yn dilysu uniondeb cynnwys, rhwymo rownd drand, a llofnodion all-lein. Er mwyn profi bod seiferdestun yn bodoli erbyn amser penodol, mae angen trafodiad storfa barhaol wedi’i ddilysu neu brawf log tryloywder wedi’i angori hefyd.

Gweler llms.txt am y crynodeb ar gyfer asiantau, llms-full.txt am y bwndel dogfennaeth cydgadwynol, a’r cyfeirnod OpenAPI wedi’i rendro am sgemâu ac ymatebion.