Para agentes e desenvolvedores

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.

API pública

Base https://h3aven.com/api/v1. Sem chave. Erros em RFC 9457 application/problem+json, com code, detail e resolution.

  • OpenAPI/openapi.json
  • RFC 9727 API catalog/.well-known/api-catalog
  • 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

MCP server

Servidor MCP de leitura, transporte Streamable HTTP. Ferramentas: h3aven_get_overview, h3aven_get_developer_resources, h3aven_get_contact.

Markdown e recuperação

Envie Accept: text/markdown para /, /team.html, /developers ou um caminho inexistente. A resposta usa Content-Type: text/markdown; charset=utf-8 e Vary: Accept, Accept-Encoding.

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.

Agendar 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.