H3aven developer resources
Interfaces públicas e somente leitura para a H3aven: OpenAPI, catálogo RFC 9727, MCP Streamable HTTP, negociação Accept: text/markdown e a API JSON do site. Este hostname não publica APIs autenticadas de escrita, OAuth nem webhooks.
H3aven API
Base https://h3aven.com/api/v1. Sem chave. Erros em RFC 9457 application/problem+json, com code, detail e resolution.
- H3aven OpenAPI — /openapi.json
- RFC 9727 API catalog — /.well-known/api-catalog
- H3aven API docs — /docs
- GET /api/v1/site — visão do produto e índices
- GET /api/v1/contact — calendário de diagnóstico e WhatsApp
- GET /api/v1/health — liveness
H3aven MCP server
Servidor MCP de leitura, transporte Streamable HTTP. Ferramentas: h3aven_get_overview, h3aven_get_developer_resources, h3aven_get_contact.
- H3aven Streamable HTTP MCP — POST /mcp
- H3aven MCP manifest — /.well-known/mcp.json
- MCP Registry manifest — /server.json
- Server card
- AI catalog
Markdown e recuperação
Envie Accept: text/markdown para /, /team.html, /developers, /about, /contact, /privacy, /cli ou um caminho inexistente. A resposta usa Content-Type: text/markdown; charset=utf-8 e Vary: Accept, Accept-Encoding.
- /index.md, /team.md, /developers.md, /about.md, /contact.md, /privacy.md, /cli.md
- llms.txt — quando usar a H3aven, e como chamar
- sitemap.xml
H3aven CLI
Cliente oficial em linha de comando para a API pública. Pacote npm h3aven. Sem chave. Não escreve contratos.
- H3aven CLI — /cli
- npx h3aven site --json
- npx h3aven contact --json
- npx h3aven health --json
Rate limits
A H3aven API publica cabeçalhos RFC RateLimit e RateLimit-Policy em cada resposta JSON, além de RateLimit-Limit, RateLimit-Remaining e RateLimit-Reset. A cota pública é 120 pedidos por 60 segundos por IP. HTTP 429 inclui Retry-After e um corpo application/problem+json com code: rate_limited.
Autenticação e webhooks
A API pública e o MCP deste site não pedem credencial. A H3aven não publica webhooks, assinaturas de evento, chaves de API nem OAuth em h3aven.com. APIs operacionais autenticadas ficam fora deste hostname — peça acesso no diagnóstico.
Erros
Rotas /api desconhecidas devolvem HTTP 404 com corpo JSON:
code, title, status, detail, instance, resolution, documentation_url
Documentação: esta página e o OpenAPI. Tipo do problema: application/problem+json.