Referencia Rápida de la API¶

Este es un índice navegable de los más de 118 endpoints de la API de Cat-Scan, agrupados por dominio. Para los esquemas completos de solicitud/respuesta, consulte la documentación interactiva OpenAPI en https://scan.rtb.cat/api/docs.

Sistema / Core¶

Método	Ruta	Propósito
GET	`/health`	Verificación de disponibilidad (git_sha, versión)
GET	`/stats`	Estadísticas del sistema
GET	`/sizes`	Tamaños de anuncios disponibles
GET	`/system/status`	Estado del servidor (Python, Node, FFmpeg, BD, disco)
GET	`/system/data-health`	Completitud de datos por comprador
GET	`/system/ui-page-load-metrics`	Métricas de rendimiento del frontend
GET	`/geo/lookup`	Resolución de ID geográfico a nombre
GET	`/geo/search`	Búsqueda de países/ciudades

Auth¶

Método	Ruta	Propósito
GET	`/auth/check`	Verificar si la sesión actual está autenticada
POST	`/auth/logout`	Cerrar sesión

Seats¶

Método	Ruta	Propósito
GET	`/seats`	Listar seats de compradores
GET	`/seats/{buyer_id}`	Obtener un seat específico
PUT	`/seats/{buyer_id}`	Actualizar nombre visible del seat
POST	`/seats/populate`	Crear seats automáticamente a partir de datos
POST	`/seats/discover`	Descubrir seats desde la API de Google
POST	`/seats/{buyer_id}/sync`	Sincronizar un seat específico
POST	`/seats/sync-all`	Sincronización completa (todos los seats)
POST	`/seats/collect-creatives`	Recopilar datos de creatividades

Creatividades¶

Método	Ruta	Propósito
GET	`/creatives`	Listar creatividades (con filtros)
GET	`/creatives/paginated`	Lista paginada de creatividades
GET	`/creatives/{id}`	Detalles de una creatividad
GET	`/creatives/{id}/live`	Datos en vivo de la creatividad (con caché)
GET	`/creatives/{id}/destination-diagnostics`	Estado de la URL de destino
GET	`/creatives/{id}/countries`	Desglose de rendimiento por país
GET	`/creatives/{id}/geo-linguistic`	Análisis geolingüístico
POST	`/creatives/{id}/detect-language`	Detección automática de idioma
PUT	`/creatives/{id}/language`	Anulación manual de idioma
GET	`/creatives/thumbnail-status`	Estado de miniaturas en lote
POST	`/creatives/thumbnails/batch`	Generar miniaturas faltantes

Campañas¶

Método	Ruta	Propósito
GET	`/campaigns`	Listar campañas
GET	`/campaigns/{id}`	Detalles de la campaña
GET	`/campaigns/ai`	Clusters generados por IA
GET	`/campaigns/ai/{id}`	Detalles de campaña IA
PUT	`/campaigns/ai/{id}`	Actualizar campaña
DELETE	`/campaigns/ai/{id}`	Eliminar campaña
GET	`/campaigns/ai/{id}/creatives`	Creatividades de la campaña
DELETE	`/campaigns/ai/{id}/creatives/{creative_id}`	Eliminar creatividad de la campaña
POST	`/campaigns/auto-cluster`	Agrupación automática por IA
GET	`/campaigns/ai/{id}/performance`	Rendimiento de la campaña
GET	`/campaigns/ai/{id}/daily-trend`	Datos de tendencia de la campaña

Analítica¶

Método	Ruta	Propósito
GET	`/analytics/waste-report`	Métricas generales de desperdicio
GET	`/analytics/size-coverage`	Cobertura de segmentación por tamaño
GET	`/analytics/rtb-funnel`	Desglose del embudo RTB
GET	`/analytics/rtb-funnel/configs`	Embudo a nivel de configuración
GET	`/analytics/endpoint-efficiency`	Eficiencia de QPS por endpoint
GET	`/analytics/spend-stats`	Estadísticas de gasto
GET	`/analytics/config-performance`	Rendimiento de configuración a lo largo del tiempo
GET	`/analytics/config-performance/breakdown`	Desglose por campo de configuración
GET	`/analytics/qps-recommendations`	Recomendaciones de IA
GET	`/analytics/performance/batch`	Rendimiento de creatividades en lote
GET	`/analytics/performance/{creative_id}`	Rendimiento de una creatividad individual
GET	`/analytics/publishers`	Métricas de dominios de editores
GET	`/analytics/publishers/search`	Buscar editores
GET	`/analytics/languages`	Rendimiento por idioma
GET	`/analytics/languages/multi`	Análisis de múltiples idiomas
GET	`/analytics/geo-performance`	Rendimiento geográfico
GET	`/analytics/geo-performance/multi`	Análisis de múltiples geografías
POST	`/analytics/import`	Importación de CSV
POST	`/analytics/mock-traffic`	Generar datos de prueba

Configuración / Pretargeting¶

Método	Ruta	Propósito
GET	`/settings/rtb-endpoints`	Endpoints RTB del bidder
POST	`/settings/rtb-endpoints/sync`	Sincronizar datos de endpoints
GET	`/settings/pretargeting-configs`	Listar configuraciones de pretargeting
GET	`/settings/pretargeting-configs/{id}`	Detalles de la configuración
GET	`/settings/pretargeting-history`	Historial de cambios de configuración
POST	`/settings/pretargeting-configs/sync`	Sincronizar configuraciones desde Google
POST	`/settings/pretargeting-configs/{id}/apply`	Aplicar un cambio de configuración
POST	`/settings/pretargeting-configs/apply-all`	Aplicar todos los cambios pendientes
PUT	`/settings/pretargeting-configs/{id}`	Actualización masiva de configuración

Cargas¶

Método	Ruta	Propósito
GET	`/uploads/tracking`	Resumen diario de cargas
GET	`/uploads/import-matrix`	Estado de importación por tipo de informe
GET	`/uploads/data-freshness`	Cuadrícula de frescura de datos (fecha x tipo)
GET	`/uploads/history`	Historial de importaciones

Optimizador¶

Método	Ruta	Propósito
GET	`/optimizer/models`	Listar modelos BYOM
POST	`/optimizer/models`	Registrar modelo
PUT	`/optimizer/models/{id}`	Actualizar modelo
POST	`/optimizer/models/{id}/activate`	Activar modelo
POST	`/optimizer/models/{id}/deactivate`	Desactivar modelo
POST	`/optimizer/models/{id}/validate`	Probar endpoint del modelo
POST	`/optimizer/score-and-propose`	Generar propuestas
GET	`/optimizer/proposals`	Listar propuestas activas
GET	`/optimizer/proposals/history`	Historial de propuestas
POST	`/optimizer/proposals/{id}/approve`	Aprobar propuesta
POST	`/optimizer/proposals/{id}/apply`	Aplicar propuesta
POST	`/optimizer/proposals/{id}/sync-status`	Verificar estado de aplicación
GET	`/optimizer/segment-scores`	Puntuaciones a nivel de segmento
GET	`/optimizer/economics/efficiency`	Resumen de eficiencia
GET	`/optimizer/economics/effective-cpm`	Análisis de CPM
GET	`/optimizer/setup`	Configuración del optimizador
PUT	`/optimizer/setup`	Actualizar configuración del optimizador

Conversiones¶

Método	Ruta	Propósito
GET	`/conversions/health`	Estado de ingesta y agregación
GET	`/conversions/readiness`	Verificación de preparación de fuentes
GET	`/conversions/ingestion-stats`	Conteo de eventos por fuente/período
GET	`/conversions/security/status`	Estado de seguridad de webhooks
GET	`/conversions/pixel`	Endpoint de seguimiento por píxel

Snapshots¶

Método	Ruta	Propósito
GET	`/snapshots`	Listar snapshots de configuración
POST	`/snapshots/rollback`	Restaurar un snapshot (con simulación)

Integraciones¶

Método	Ruta	Propósito
POST	`/integrations/credentials`	Subir JSON de cuenta de servicio GCP
GET	`/integrations/service-accounts`	Listar cuentas de servicio
DELETE	`/integrations/service-accounts/{id}`	Eliminar cuenta de servicio
GET	`/integrations/language-ai/config`	Estado del proveedor de IA
PUT	`/integrations/language-ai/config`	Configurar proveedor de IA
GET	`/integrations/gmail/status`	Estado de importación de Gmail
POST	`/integrations/gmail/import/start`	Iniciar importación manual
POST	`/integrations/gmail/import/stop`	Detener tarea de importación
GET	`/integrations/gmail/import/history`	Historial de importaciones
GET	`/integrations/gcp/project-status`	Estado del proyecto GCP
POST	`/integrations/gcp/validate`	Probar conexión GCP

Administración¶

Método	Ruta	Propósito
GET	`/admin/users`	Listar usuarios
POST	`/admin/users`	Crear usuario
GET	`/admin/users/{id}`	Detalles del usuario
PUT	`/admin/users/{id}`	Actualizar usuario
POST	`/admin/users/{id}/deactivate`	Desactivar usuario
GET	`/admin/users/{id}/permissions`	Permisos globales del usuario
GET	`/admin/users/{id}/seat-permissions`	Permisos por seat del usuario
POST	`/admin/users/{id}/seat-permissions`	Otorgar acceso a un seat
DELETE	`/admin/users/{id}/seat-permissions/{buyer_id}`	Revocar acceso a un seat
POST	`/admin/users/{id}/permissions`	Otorgar permiso global
DELETE	`/admin/users/{id}/permissions/{sa_id}`	Revocar permiso global
GET	`/admin/audit-log`	Registro de auditoría
GET	`/admin/stats`	Estadísticas del panel de administración
GET	`/admin/settings`	Configuración del sistema
PUT	`/admin/settings/{key}`	Actualizar configuración del sistema

Built from docs c4d2c4f (platform N/A) — last updated 5 de marzo de 2026 04:15:14.