Referência da API

Referência da API interna

Estes endpoints dão suporte ao aplicativo web do IVGraph. Eles exigem autenticação JWT, salvo indicação em contrário. Estão documentados aqui para referência — para casos de uso de integração, prefira a API V1 para LLMs.

Usuário e perfil

Método Endpoint Descrição
GET /api/auth/me/ Informações do usuário atual (id, email, username, is_staff)
GET /api/auth/validate/ Verificar se o token JWT é válido
POST /api/auth/refresh/ Renovar o token de acesso
POST /api/auth/logout/ Adicionar o token de renovação à lista de bloqueio
GET /api/user/me/ Detalhes do perfil do usuário
PUT /api/user/me/ Atualizar o perfil do usuário
GET /api/user/profile/ Visualização do perfil do usuário

Sistema de indicações

Método Endpoint Descrição
GET /api/referral/my-code/ Obter o código de indicação do usuário
POST /api/referral/apply/ Aplicar um código de indicação
GET /api/referral/stats/ Estatísticas de indicações

OAuth do Notion

Método Endpoint Descrição
GET /api/integrations/auth/notion/ Iniciar o fluxo OAuth do Notion (redireciona para o Notion)
GET /api/integrations/auth/notion/callback Callback OAuth (troca o código por tokens)
GET /api/integrations/auth/notion/status Verificar o status da conexão OAuth
POST /api/integrations/auth/logout/ Desconectar a integração com o Notion
POST /api/integrations/auth/delete-account/ Excluir a conta do usuário e todos os dados

Gerenciamento de espaços de trabalho

Método Endpoint Descrição
GET /api/integrations/workspaces/ Listar os espaços de trabalho do usuário no Notion
GET /api/integrations/workspaces/<id>/ Detalhes do espaço de trabalho
POST /api/integrations/workspaces/<id>/primary/ Definir o espaço de trabalho como principal

Gerenciamento de sincronização

Método Endpoint Descrição
GET /api/integrations/status/ Status da integração e da sincronização
GET /api/integrations/notion/permissions/ Verificar as permissões da API do Notion
POST /api/integrations/airbyte/setup/ Configurar a conexão do Airbyte para o espaço de trabalho
GET /api/integrations/airbyte/setup/progress/ Progresso da configuração
POST /api/integrations/airbyte/sync/ Iniciar a sincronização incremental
POST /api/integrations/airbyte/sync/cancel/ Cancelar a sincronização em andamento
GET /api/integrations/airbyte/sync/progress/ Progresso da sincronização (consulte este endpoint periodicamente)
POST /api/integrations/airbyte/full-refresh/ Atualização completa dos dados (sincroniza tudo novamente)

Cobrança (Stripe)

Método Endpoint Descrição
GET /api/billing/plans/ Listar os planos de assinatura disponíveis
POST /api/billing/create-checkout/ Criar uma sessão de checkout do Stripe
POST /api/billing/confirm-checkout/ Confirmar o checkout concluído
GET /api/billing/subscription/ Obter os detalhes da assinatura do usuário
POST /api/billing/portal/ Criar um link para o portal do cliente do Stripe

Regras de estilo e configurações do grafo

Método Endpoint Descrição
GET /api/databases/ Listar bancos de dados para definir a quais deles as regras se aplicam
GET/PUT /api/graph-settings/ Configurações globais do grafo (cores, opções de ativação e desativação)
GET/POST /api/advanced-rules/ Listar/criar regras de estilo avançadas
GET/PUT/DELETE /api/advanced-rules/<id>/ Gerenciar uma regra individual
POST /api/advanced-rules/reorder/ Reordenar as regras por prioridade
GET/POST /api/style-presets/ Listar/criar predefinições de estilo
GET/PUT/DELETE /api/style-presets/<id>/ Gerenciar uma predefinição individual
POST /api/style-presets/<id>/activate/ Definir a predefinição como ativa
POST /api/style-presets/<id>/duplicate/ Duplicar uma predefinição

Gerenciamento de tokens de serviço

Método Endpoint Descrição
GET /api/tokens/ Listar os tokens de serviço do usuário
POST /api/tokens/ Criar um novo token de serviço
DELETE /api/tokens/<id>/ Revogar o token permanentemente

Consulte Autenticação para saber mais sobre a criação de tokens.

Diversos

Método Endpoint Autenticação Descrição
GET /api/connections/ JWT Listar as conexões do usuário no Airbyte
GET /api/integrations/ JWT Visão geral das integrações
GET /api/activity/ JWT Registro de atividades recentes
GET /api/health/ Nenhuma Verificação de integridade
GET /api/health/celery/ Nenhuma Integridade do worker do Celery
GET /api/stats/public/ Nenhuma Estatísticas da plataforma (cache de 24h)
POST /api/errors/report/ Nenhuma Envio de relatórios de erros do frontend