Referencia de la API

Referencia de la API interna

Estos endpoints hacen funcionar la aplicación web de IVGraph. Requieren autenticación JWT, salvo que se indique lo contrario. Se documentan aquí como referencia; para integraciones, usa preferentemente la API V1 para LLM.

Usuario y perfil

Método Endpoint Descripción
GET /api/auth/me/ Información del usuario actual (id, email, username, is_staff)
GET /api/auth/validate/ Comprobar si el token JWT es válido
POST /api/auth/refresh/ Renovar el token de acceso
POST /api/auth/logout/ Añadir el token de renovación a la lista de bloqueo
GET /api/user/me/ Detalles del perfil del usuario
PUT /api/user/me/ Actualizar el perfil del usuario
GET /api/user/profile/ Vista del perfil del usuario

Sistema de referidos

Método Endpoint Descripción
GET /api/referral/my-code/ Obtener el código de referido del usuario
POST /api/referral/apply/ Aplicar un código de referido
GET /api/referral/stats/ Estadísticas de referidos

OAuth de Notion

Método Endpoint Descripción
GET /api/integrations/auth/notion/ Iniciar el flujo OAuth de Notion (redirige a Notion)
GET /api/integrations/auth/notion/callback Función de retorno de OAuth (intercambia el código por tokens)
GET /api/integrations/auth/notion/status Comprobar el estado de la conexión OAuth
POST /api/integrations/auth/logout/ Desconectar la integración con Notion
POST /api/integrations/auth/delete-account/ Eliminar la cuenta del usuario y todos los datos

Gestión de espacios de trabajo

Método Endpoint Descripción
GET /api/integrations/workspaces/ Listar los espacios de trabajo de Notion del usuario
GET /api/integrations/workspaces/<id>/ Detalles del espacio de trabajo
POST /api/integrations/workspaces/<id>/primary/ Establecer el espacio de trabajo como principal

Gestión de la sincronización

Método Endpoint Descripción
GET /api/integrations/status/ Estado de la integración y la sincronización
GET /api/integrations/notion/permissions/ Comprobar los permisos de la API de Notion
POST /api/integrations/airbyte/setup/ Configurar la conexión de Airbyte para el espacio de trabajo
GET /api/integrations/airbyte/setup/progress/ Progreso de la configuración
POST /api/integrations/airbyte/sync/ Iniciar una sincronización incremental
POST /api/integrations/airbyte/sync/cancel/ Cancelar la sincronización en curso
GET /api/integrations/airbyte/sync/progress/ Progreso de la sincronización (consulta periódicamente este endpoint)
POST /api/integrations/airbyte/full-refresh/ Actualización completa de los datos (vuelve a sincronizarlo todo)

Facturación (Stripe)

Método Endpoint Descripción
GET /api/billing/plans/ Listar los planes de suscripción disponibles
POST /api/billing/create-checkout/ Crear una sesión de pago de Stripe
POST /api/billing/confirm-checkout/ Confirmar la finalización del proceso de pago
GET /api/billing/subscription/ Obtener los detalles de la suscripción del usuario
POST /api/billing/portal/ Crear un enlace al portal de clientes de Stripe

Reglas de estilo y ajustes del grafo

Método Endpoint Descripción
GET /api/databases/ Listar las bases de datos a las que aplicar reglas
GET/PUT /api/graph-settings/ Ajustes globales del grafo (colores, interruptores)
GET/POST /api/advanced-rules/ Listar/crear reglas de estilo avanzadas
GET/PUT/DELETE /api/advanced-rules/<id>/ Gestionar una regla individual
POST /api/advanced-rules/reorder/ Reordenar las reglas por prioridad
GET/POST /api/style-presets/ Listar/crear ajustes predefinidos de estilo
GET/PUT/DELETE /api/style-presets/<id>/ Gestionar un ajuste predefinido individual
POST /api/style-presets/<id>/activate/ Establecer un ajuste predefinido como activo
POST /api/style-presets/<id>/duplicate/ Duplicar un ajuste predefinido

Gestión de tokens de servicio

Método Endpoint Descripción
GET /api/tokens/ Listar los tokens de servicio del usuario
POST /api/tokens/ Crear un nuevo token de servicio
DELETE /api/tokens/<id>/ Revocar el token (de forma permanente)

Consulta Autenticación para obtener más información sobre la creación de tokens.

Otros

Método Endpoint Autenticación Descripción
GET /api/connections/ JWT Listar las conexiones de Airbyte del usuario
GET /api/integrations/ JWT Descripción general de las integraciones
GET /api/activity/ JWT Registro de actividad reciente
GET /api/health/ Ninguna Comprobación del estado del servicio
GET /api/health/celery/ Ninguna Estado del proceso de trabajo de Celery
GET /api/stats/public/ Ninguna Estadísticas de la plataforma (caché de 24h)
POST /api/errors/report/ Ninguna Notificación de errores del frontend