qub para programadores
qub para programadores
A API HTTP tem versões sob /api/v1; o respetivo documento OpenAPI indica atualmente a versão de API 1.0.0. São suportadas três vias de integração:
- API HTTP — toda a superfície externa é gerada a partir das operações marcadas com
x-audience: externalem /api/v1/openapi.json. As operações públicas não exigem credenciais; as escritas no navegador usam Cloudflare Turnstile; as chamadas Builder usamAuthorization: Bearer qub_sk_…./api/v1/uploadaceita bytes selados localmente, enquanto/api/v1/sealé uma via de texto simples no servidor, explicitamente de confiança. - Servidor MCP —
tools/qub-mcpé um binário Rust local com cinco ferramentas:create_qub,read_qub,check_status,list_pending_operationseverify_forecast_series. Sela localmente. Os qubs são privados por predefinição (encapsulados, com a chave no fragmento do link);visibility: "public"é uma opção explícita que mantém o bloqueio temporal e dispensa a proteção por link. A publicação está desativada por predefinição;create_qubrequerQUB_API_KEYeQUB_MCP_ALLOW_CREATE=true. As leituras aceitam um URL de entrega outx_id, e só precisam dekey_base64urlpara qubs privados. - Incorporação —
<qub-embed src="https://qub.social/c/<tx_id>#<key>">apresenta em linha a contagem decrescente e a revelação em direto. Os qubs públicos usam a mesma forma desrcsem fragmento. Use o carregador fixo/embed/v1.js;/embed.jsé apenas o alias móvel.
Os pacotes .qub portáteis verificam offline a integridade do conteúdo, a vinculação à ronda drand e as assinaturas com qub-verify. Isso não mostra quando um qub foi selado. Para qubs públicos, qub-verify --timing e as ferramentas de leitura MCP comunicam o tempo de bloco da transação de armazenamento permanente do qub, em que gateways não operados por qub concordam; a evidência temporal não é disponibilizada para qubs privados nesta versão.
Uma avaliação gratuita do Builder (10 publicações e 10.000 leituras autenticadas no total; apenas carregamento e leitura) é disponibilizada nesta página quando a inscrição está aberta. Pode não estar aberta.
Consulte llms.txt para o resumo destinado a agentes, llms-full.txt para o pacote de documentação concatenado e a referência OpenAPI renderizada para os esquemas e as respostas.