qub dla deweloperów

qub dla programistów

Interfejs HTTP API jest wersjonowany pod /api/v1; jego dokument OpenAPI podaje obecnie wersję API 1.0.0. Obsługiwane są trzy ścieżki integracji:

• HTTP API — pełny zewnętrzny zakres jest generowany z operacji oznaczonych x-audience: external w /api/v1/openapi.json. Operacje publiczne nie wymagają danych uwierzytelniających; zapisy z przeglądarki używają Cloudflare Turnstile; wywołania Builder używają Authorization: Bearer qub_sk_…. /api/v1/upload przyjmuje bajty zapieczętowane lokalnie, natomiast /api/v1/seal jest jawnie zaufaną serwerową ścieżką tekstu jawnego.
• Serwer MCP — tools/qub-mcp to lokalny program binarny w Rust do operacji tworzenia, odczytu i sprawdzania stanu. Pieczętuje lokalnie i publikuje prywatne, opakowane quby. Publikowanie jest domyślnie wyłączone; create_qub wymaga zarówno QUB_API_KEY, jak i QUB_MCP_ALLOW_CREATE=true. Odczyt przyjmuje pełny adres dostarczenia z fragmentem albo tx_id wraz z key_base64url.
• Osadzanie — <qub-embed src="https://qub.social/c/<tx_id>#<key>"> wyświetla na stronie bieżące odliczanie i ujawnioną treść. Publiczne quby używają tej samej postaci src bez fragmentu. Użyj przypiętego modułu ładującego /embed/v1.js; /embed.js jest tylko zmiennym aliasem.

Przenośne pakiety .qub weryfikują offline integralność treści, powiązanie z rundą drand i podpisy. Udowodnienie, że szyfrogram istniał do określonego czasu, wymaga dodatkowo zweryfikowanej transakcji w trwałym magazynie lub zakotwiczonego dowodu z rejestru przejrzystości.

Zobacz llms.txt, aby przeczytać podsumowanie dla agentów, llms-full.txt, aby pobrać połączony pakiet dokumentacji, oraz wyrenderowaną dokumentację OpenAPI, aby poznać schematy i odpowiedzi.