qub для разработчиков

HTTP API версионируется в пространстве /api/v1; его документ OpenAPI сейчас указывает версию API 1.0.0. Поддерживаются три способа интеграции:

HTTP API — весь внешний интерфейс формируется из операций с пометкой x-audience: external в /api/v1/openapi.json. Публичные операции не требуют учётных данных; запросы на запись из браузера используют 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 для схем и ответов.