개발자를 위한 qub

HTTP API의 버전 경로는 /api/v1이며, OpenAPI 문서에 현재 API 버전이 1.0.0으로 명시되어 있습니다. 다음 세 가지 통합 경로를 지원합니다:

HTTP API — 전체 외부 표면은 /api/v1/openapi.json에서 x-audience: external로 표시된 작업으로부터 생성됩니다. 공개 작업에는 자격 증명이 필요하지 않고, 브라우저 쓰기 작업은 Cloudflare Turnstile을 사용하며, Builder 호출은 Authorization: Bearer qub_sk_…를 사용합니다. /api/v1/upload는 로컬에서 봉인된 바이트를 받지만 /api/v1/seal은 명시적으로 신뢰하는 서버 측 평문 경로입니다.
MCP 서버 — tools/qub-mcp는 생성/읽기/상태 작업을 위한 로컬 Rust 바이너리입니다. 로컬에서 봉인하고 비공개로 래핑된 qub을 게시합니다. 게시 기능은 기본적으로 비활성화되며, create_qub에는 QUB_API_KEY와 QUB_MCP_ALLOW_CREATE=true가 모두 필요합니다. 읽기 및 상태 작업에는 프래그먼트가 포함된 전체 전달 URL 또는 tx_id와 key_base64url을 사용할 수 있습니다.
임베드 — <qub-embed src="https://qub.social/c/<tx_id>#<key>">는 실시간 카운트다운과 공개를 인라인으로 렌더링합니다. 공개 qub도 프래그먼트만 없는 동일한 src 형식을 사용합니다. 고정된 로더 /embed/v1.js를 사용하세요. /embed.js는 이동하는 별칭일 뿐입니다.

이동 가능한 .qub 번들은 콘텐츠 무결성, drand 라운드 결속, 서명을 오프라인으로 검증합니다. 암호문이 특정 시점까지 존재했다는 사실을 증명하려면 검증된 영구 저장소 트랜잭션 또는 앵커링된 투명성 로그 증명이 추가로 필요합니다.

에이전트용 요약은 llms.txt, 통합 문서 번들은 llms-full.txt, 스키마와 응답은 렌더링된 OpenAPI 레퍼런스를 참조하세요.