qub для разработчиков
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 с пятью инструментами:create_qub,read_qub,check_status,list_pending_operationsиverify_forecast_series. Она запечатывает локально. По умолчанию qub приватные (обёрнутые, с ключом во фрагменте ссылки);visibility: "public"включается только явно: таймлок сохраняется, а защита ссылкой снимается. Публикация по умолчанию отключена; дляcreate_qubнужны иQUB_API_KEY, иQUB_MCP_ALLOW_CREATE=true. Для чтения передают URL доставки илиtx_id, аkey_base64urlнужен только для приватных qub. - Встраивание —
<qub-embed src="https://qub.social/c/<tx_id>#<key>">встраивает текущий обратный отсчёт и раскрытие. Публичные qub используют ту же формуsrcбез фрагмента. Используйте закреплённый загрузчик/embed/v1.js;/embed.js— только меняющийся псевдоним.
Переносимые пакеты .qub позволяют офлайн проверить целостность содержимого, привязку к раунду drand и подписи с помощью qub-verify. Это не показывает, когда qub был запечатан. Для публичных qub qub-verify --timing и инструменты чтения MCP сообщают время блока для транзакции qub в постоянном хранилище по совпадающим данным шлюзов, которыми qub не управляет; в этом выпуске свидетельство о времени не предоставляется для приватных qub.
Бесплатный пробный доступ Builder (всего 10 публикаций и 10 000 чтений с аутентификацией; только загрузка и чтение) предлагается на этой странице, когда запись открыта. Запись может быть закрыта.
См. llms.txt для сводки, предназначенной агентам, llms-full.txt для объединённого пакета документации и сформированную справку OpenAPI для схем и ответов.