Recursos

Histórico de alterações da API

v1.0 — 2026-04-10

Publicação inicial da documentação da API.

API V1 para LLMs

  • GET /v1/graph/search/ — Buscar nós por título
  • GET /v1/graph/nodes/<id>/ — Obter detalhes do nó
  • GET /v1/graph/content/<id>/ — Obter conteúdo da página (markdown)
  • GET /v1/graph/neighbors/<id>/ — Percorrer nós vizinhos com BFS
  • POST /v1/graph/traverse/ — Caminho mais curto entre nós
  • GET /v1/ — Especificação autodescritiva da API (sem autenticação)

API de grafos

  • GET /api/notion-graph/ — Dados completos do grafo (nós + arestas)

API de busca

  • GET /api/search/ — Busca em texto completo (BM25)
  • GET /api/search/suggest/ — Preenchimento automático
  • GET /api/search/semantic/ — Busca por similaridade vetorial
  • GET /api/search/hybrid/ — Busca BM25 + vetorial
  • GET /api/search/similar/<id>/ — Encontrar nós semelhantes
  • GET /api/search/content/<id>/ — Conteúdo da página

Autenticação

  • Tokens de serviço (ivg_*) para acesso à API V1
  • JWT via OAuth do Notion para acesso do usuário à API

Endpoints públicos

  • GET /api/stats/public/ — Estatísticas da plataforma
  • GET /api/health/ — Verificação de integridade