PobierzDownload
x9busDeweloperzy i APIDevelopers & API
X-API-Version: 2026-11-22

OpenAPI 3.1 · RFC 9727 · Agent Skills · x9bus CLI

Dokumentacja deweloperska i interfejsy agentowe x9busx9bus Developer Portal & Agent Interfaces

Ta powierzchnia dokumentuje publiczne endpointy REST, negocjację treści Markdown, standardy odkrywania usług agentowych oraz integrację sesji CLI z Transcript Busem x9bus na macOS 26 (Apple Silicon).This portal documents the public REST endpoints, Markdown content negotiation, agent discovery manifests, and CLI session integration with the x9bus Transcript Bus on macOS 26 (Apple Silicon).

Powierzchnie odkrywania (Machine-Readable)Machine-Readable Discovery

  • /openapi.json — pełna specyfikacja OpenAPI 3.1.0 z typowanymi schematami odpowiedzi JSON i wspólnym modelem błędów ErrorResponse.complete OpenAPI 3.1.0 specification with typed JSON response schemas and unified ErrorResponse model.
  • /.well-known/api-catalog — katalog API RFC 9727 (application/linkset+json) wskazujący specyfikację i dokumentację.RFC 9727 API catalog (application/linkset+json) linking service-desc and service-doc.
  • /llms.txt & /llms-full.txt — przewodnik dla agentów z instrukcją kiedy używać x9bus oraz pełny konspekt Markdown.agent guide with explicit when-to-use guidance plus the consolidated full Markdown reference.
  • /.well-known/agent-skills/index.json — indeks Agent Skills Discovery v0.2.0 ze skrótem SHA-256 dla x9bus-beta/SKILL.md.Agent Skills Discovery v0.2.0 index with live SHA-256 digest for x9bus-beta/SKILL.md.
  • /.well-known/agent-card.json — karta A2A (Agent-to-Agent) z deklaracją trybów wejścia/wyjścia i umiejętności.A2A Agent Card declaring supported input/output modes and capabilities.
  • /pricing.md — cennik Open Beta (14 dni za 0 USD) oraz progi subskrypcji w czystym Markdownie.Open Beta (14-day free) and subscription tiers in clean Markdown.

Publiczne endpointy JSON APIPublic JSON API Endpoints

  • GET /api/health — stan runtime, dostępność instalatora DMG i gotowość poczty weryfikacyjnej.runtime health, DMG availability, and verification mail readiness.
  • GET /api/beta/status — aktualny stan puli 14-dniowej Open Bety (issuedCount, limit, remaining, days, seatLimit).live 14-day Open Beta pool counts (issuedCount, limit, remaining, days, seatLimit).
  • POST /api/beta/register — wysłanie linku double opt-in (wymaga jawnej zgody użytkownika marketingConsent: true).dispatch a double opt-in verification email (requires explicit user consent marketingConsent: true).
  • POST /api/license/verify — weryfikacja klucza licencyjnego Ed25519 CSK1 bez zapisywania danych osobowych.verify an offline Ed25519 CSK1 license key without storing PII.
  • GET /api/checkout/config — status bramki zakupu, liczba stanowisk (do 3 Maców) i obsługiwane waluty.checkout readiness, device seat limit (up to 3 Macs), and supported currencies.

Wersjonowanie, limity i format błędówVersioning, Rate Limits & Error Model

Wszystkie trasy /api/* zwracają nagłówek X-API-Version: 2026-11-22 oraz standardowe nagłówki limitów (RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset). Nieznane ścieżki /api/* i błędy zwracają wyłącznie strukturalny JSON ({status: 'error', ok: false, code, message, hint}), nigdy HTML. Zmiany niekompatybilne ogłaszamy z minimum 60-dniowym wyprzedzeniem nagłówkami Deprecation i Sunset.All /api/* routes return X-API-Version: 2026-11-22 alongside standard rate-limit headers (RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset). Unknown /api/* paths and errors always return structured JSON ({status: 'error', ok: false, code, message, hint}), never HTML. Breaking changes are announced at least 60 days ahead via Deprecation and Sunset headers.

Negocjacja Markdown i CLI x9busMarkdown Negotiation & x9bus CLI

Każda strona dokumentu obsługuje nagłówek Accept: text/markdown (z Vary: Accept i linkami RFC 8288 Link) oraz bezpośrednie sufiksy .md (/beta.md, /about.md, /contact.md, /developers.md). Na macOS 26 sesje Claude Code, Codex i Gemini łączą się z lokalnym Transcript Busem poleceniami x9bus --bind, x9bus --say i x9bus --watch, a kod open-source i narzędzia Vetcoders publikujemy na Every document route supports Accept: text/markdown (with Vary: Accept and RFC 8288 Link headers) as well as direct .md URLs (/beta.md, /about.md, /contact.md, /developers.md). On macOS 26, Claude Code, Codex, and Gemini sessions connect to the local Transcript Bus via x9bus --bind, x9bus --say, and x9bus --watch; Vetcoders open-source repositories live at github.com/vetcoders.