Documentação da API do IVGraph

URLs base

Ambiente	URL
Produção	https://ivgraph.com/api/
Produção (V1)	https://ivgraph.com/v1/

Autenticação

O IVGraph aceita dois métodos de autenticação:

Método	Caso de uso	Cabeçalho
JWT (OAuth do Notion)	Aplicações web, sessões de usuários	Authorization: Bearer <jwt_access_token>
Token de serviço	Agentes LLM, automação, CI/CD	Authorization: Bearer ivg_<token>

Início rápido com token de serviço

1. Entre em ivgraph.com pelo OAuth do Notion
2. Acesse Perfil → Tokens de serviço
3. Crie um token com os escopos necessários (por exemplo, graph:search, graph:read)
4. Use o token nas suas requisições:

curl -H "Authorization: Bearer ivg_your_token_here" \
  "https://ivgraph.com/v1/graph/search?q=project&workspace_id=YOUR_WORKSPACE_ID"

Camadas da API

Camada	Caminho base	Autenticação	Descrição
API V1 para LLMs	/v1/graph/	Token de serviço	Acesso somente de leitura ao grafo para agentes LLM
API de grafo	/api/notion-graph/	JWT	Dados completos do grafo (nós + arestas)
API de busca	/api/search/	JWT	Busca de texto completo, semântica e híbrida
API interna	/api/	JWT	Autenticação, cobrança, integrações, regras de estilo
Pública	/api/stats/public/	Nenhuma	Estatísticas da plataforma, verificações de integridade

Limites de requisições

API	Limite	Escopo
V1 (Token de serviço)	Pico de 20 req/10s, 600 req/15min	Por token
API de usuário (JWT)	100 req/min	Por usuário
Anônima	20 req/min	Por IP

Formato dos erros

Todos os erros retornam JSON:

{
  "error": "Short error message",
  "detail": "Extended description (optional)"
}

Consulte Erros e limites de requisições para ver a referência completa dos erros.

Para agentes LLM

Documentação em formato legível por máquina:

• ivgraph.com/llms.txt — visão geral compacta da API
• ivgraph.com/llms-full.txt — documentação completa com exemplos