API para desenvolvedores e agentes
O Zig expõe uma API pública read-only do catálogo de eventos, pensada para agentes de IA e integrações. Ela é aberta: não requer autenticação nem chave de API para consultar eventos — não há formulário de contato comercial nem cadastro para começar.
Comece agora
curl https://{seu-dominio}/api/public/v1/eventsRecursos
- Guia da API — Documentação legível dos endpoints.
- Especificação OpenAPI — Contrato 3.1 tipado da API.
- Eventos (REST) — Lista e busca do catálogo público.
- Health check — Liveness da camada pública.
- Servidor MCP — Model Context Protocol (POST).
- Endpoint A2A — Agent-to-Agent (POST).
- Agent card — Descrição A2A do agente.
- Autenticação — Como agentes se autenticam (auth.md).
- Permissões (OAuth PRM) — Escopos, via RFC 9728.
- llms.txt — Índice legível por LLM, com "quando usar".
Versioning & deprecation policy (versionamento e deprecação)
A versão é fixada no caminho (/api/public/v1). Mudanças incompatíveis entram numa nova versão de caminho; ao aposentar uma versão, sinalizamos com os headers HTTP Deprecation e Sunset (RFC 8594), mantendo a versão no ar durante a janela anunciada antes da remoção.
English: the API is versioned in the URL path (/api/public/v1). Breaking changes ship under a new path version; a version is deprecated only via the Deprecation and Sunset (RFC 8594) HTTP response headers, and stays available through the announced sunset window before removal.
Erros
Respostas de erro (4xx/5xx) usam application/problem+json (RFC 9457), com um code estável legível por máquina e title/detail legíveis por humano.