Documentación completa para todas las APIs de Public Safety incluyendo endpoints GraphQL, REST y WebSocket. Todos los endpoints requieren un argus_auth_token válido para devolver datos.
Public Safety Command Center expone dos servicios de API principales con más de 200 endpoints REST y 180+ operaciones GraphQL. Todos los endpoints autenticados requieren un argus_auth_token válido obtenido a través del Servicio de Autenticación.
auth.knogin.com
Gestiona toda la autenticación, gestión de usuarios, MFA, SSO, claves API, roles, permisos y gestión de sesiones. Aquí es donde obtiene los tokens para acceder al Servicio de API.
api.knogin.com
La API central de la plataforma de inteligencia que proporciona endpoints REST y GraphQL para investigaciones, casos, perfiles, evidencias, alertas, monitores, servicios de IA y comunicación en tiempo real.
https://auth.knogin.comhttps://api.knogin.comhttps://auth-staging.knogin.comhttps://api-staging.knogin.comTodas las solicitudes de API autenticadas requieren un argus_auth_token válido. Los tokens se obtienen a través del Servicio de Autenticación y deben incluirse en todas las solicitudes posteriores a ambos servicios. Las claves API pueden generarse en el panel del Servicio de Autenticación bajo su perfil de usuario para acceso programático.
Después de un inicio de sesión exitoso, las cookies se configuran automáticamente:
platform_access_token=eyJhbGc... # Short-lived access token
knogin_refresh_token=eyJhbGc... # Long-lived refresh tokenIncluya el token en el encabezado Authorization:
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...# Using username/password (OAuth2 form)
curl -X POST https://auth.knogin.com/v1/token \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "[email protected]&password=your_password"
# Using API Key (recommended for service-to-service)
curl -X POST https://auth.knogin.com/v1/auth/token \
-H "Content-Type: application/json" \
-d '{"api_key": "your_api_key", "platform": "publicSafety"}'
# Response
{
"access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"token_type": "bearer",
"expires_in": 3600
}El Servicio de Autenticación (auth.knogin.com) gestiona toda la autenticación, autorización, gestión de usuarios, MFA, SSO, claves API, roles, permisos, feature flags y gestión multi-tenant. Contiene más de 80 endpoints organizados por funcionalidad.
Endpoints principales de autenticación para obtener, renovar y gestionar tokens de acceso y sesiones.
/v1/tokenEndpoint de inicio de sesión compatible con OAuth2 que acepta email y contraseña codificados en formulario. Emite tokens de acceso específicos de plataforma y configura cookies HTTP-only para sesiones de navegador. Si MFA está habilitado, devuelve una cookie de desafío que requiere verificación.
/v1/auth/tokenAutenticar usando una clave API para recibir un token JWT específico de plataforma. Ideal para autenticación servicio a servicio, pipelines de CI/CD y acceso programático.
/v1/auth/refreshRenovar tokens de acceso expirados usando la cookie de refresco. Devuelve nuevas cookies de token de acceso sin requerir re-autenticación.
/v1/auth/logoutTermina la sesión actual del usuario invalidando todos los tokens y eliminando cookies de autenticación.
/v1/auth/revoke-user-sessions/{user_id}Termina forzosamente todas las sesiones activas de un usuario específico en todos los dispositivos y plataformas.
Endpoints para que los usuarios gestionen sus propios perfiles, vean su información y actualicen su configuración.
/v1/users/meDevuelve el perfil completo del usuario actualmente autenticado incluyendo email, roles, permisos y estado de MFA.
/v1/users/mePermite a los usuarios actualizar su propia información de perfil incluyendo nombre, teléfono y contraseña.
/v1/auth/meDevuelve el perfil de usuario actual junto con feature flags evaluados para el tenant del usuario.
/v1/users/createEndpoint público para que nuevos usuarios creen una cuenta. Acepta email y contraseña, y envía un email de verificación.
Soporte completo de MFA incluyendo TOTP (aplicaciones de autenticación), passkeys WebAuthn y verificación por voz. Los usuarios pueden habilitar múltiples métodos para seguridad en capas.
/v1/portal/mfa/totp/enableGenera un nuevo secreto TOTP y código QR para escanear con aplicaciones de autenticación.
/v1/portal/mfa/totp/verify-and-activateVerifica un código TOTP y activa MFA para la cuenta del usuario.
/v1/portal/mfa/totp/disableDeshabilita MFA basado en TOTP para el usuario actual.
/v1/mfa/verify-loginValida el código MFA durante el flujo de desafío de inicio de sesión.
/v1/portal/mfa/passkey/generate-registrationGenera opciones de registro WebAuthn para crear una nueva credencial passkey.
/v1/portal/mfa/passkey/verify-registrationVerifica la respuesta WebAuthn y guarda la nueva credencial passkey.
/v1/portal/mfa/passkey/{credential_id}Elimina una credencial passkey específica por su ID.
/v1/portal/mfa/passkey/generate-authenticationGenera opciones de autenticación WebAuthn para inicio de sesión sin contraseña.
/v1/portal/mfa/passkey/verify-authenticationVerifica la respuesta WebAuthn y completa el inicio de sesión.
/v1/portal/mfa/voice/enrollInscribe una muestra de voz para MFA basado en voz.
/v1/portal/mfa/voice/verifyVerifica una muestra de voz contra el perfil inscrito durante el desafío MFA.
/v1/portal/mfa/voiceDeshabilita MFA basado en voz y elimina el perfil de voz almacenado.
/v1/portal/mfa/challenge-infoDevuelve información sobre qué métodos MFA están disponibles para el desafío de inicio de sesión.
Integración de inicio de sesión único basada en OAuth2/OIDC con proveedores de identidad empresariales incluyendo Google Workspace y Microsoft Entra ID (Azure AD).
/v1/portal/sso/available-providersDevuelve una lista de proveedores SSO configurados para el tenant actual.
/v1/portal/login/{provider}Inicia el flujo de autorización OAuth2/OIDC con el proveedor de identidad especificado.
/v1/portal/auth/{provider}Endpoint de callback OAuth2/OIDC que maneja el código de autorización devuelto por el proveedor.
Crear y gestionar claves API para acceso programático. Las claves API pueden limitarse a plataformas específicas y tener fecha de expiración configurable.
/v1/portal/users/me/keysCrea una nueva clave API para acceso programático. La clave completa solo se devuelve una vez.
/v1/portal/users/me/keysDevuelve todas las claves API para el usuario actual.
/v1/portal/users/me/keys/{key_id}Revoca permanentemente una clave API, invalidando inmediatamente todos los tokens emitidos.
Endpoints administrativos para gestionar usuarios, roles y permisos. El acceso varía según la jerarquía de roles.
/v1/portal/admin/usersDevuelve todos los usuarios basándose en el rol del llamante.
/v1/portal/admin/usersCrea un nuevo usuario con email, contraseña, roles y asignación de organización.
/v1/portal/admin/users/{user_id}Devuelve información detallada del usuario incluyendo perfil, roles y permisos.
/v1/portal/admin/users/{user_id}Actualiza detalles del usuario incluyendo roles, permisos y acceso a plataforma.
/v1/portal/admin/users/{user_id}Elimina permanentemente una cuenta de usuario y todos los datos asociados.
/v1/users/{user_id}/permissionsActualiza los permisos granulares de un usuario independientemente de sus roles.
Definir roles personalizados y permisos granulares para control de acceso detallado dentro de las organizaciones.
/v1/rolesDevuelve todos los roles disponibles en el sistema incluyendo roles integrados y personalizados.
/v1/rolesCrea un nuevo rol personalizado con permisos especificados.
/v1/roles/{role_id}Actualiza el nombre, descripción o permisos de un rol personalizado.
/v1/roles/{role_id}Elimina un rol personalizado. Los usuarios con este rol perderán los permisos asociados.
Controlar la disponibilidad de características a nivel de tenant y usuario para lanzamientos graduales y pruebas A/B.
/v1/feature-flags/tenantDevuelve todos los feature flags y sus valores para el tenant actual.
/v1/feature-flags/tenantActualiza feature flags para el tenant. Los cambios aplican a todos los usuarios.
/v1/feature-flags/user/{user_id}Devuelve anulaciones de feature flags específicas de usuario.
/v1/feature-flags/user/{user_id}Establece anulaciones de feature flags específicas de usuario.
Gestionar la jerarquía multi-tenant incluyendo Integradores de Sistemas (SI) que revenden y gestionan despliegues de Public Safety para sus clientes.
/v1/systems-integratorsCrea una nueva organización de Integrador de Sistemas que puede gestionar múltiples tenants.
/v1/systems-integratorsDevuelve todos los Integradores de Sistemas en la plataforma.
/v1/systems-integrators/{si_id}Devuelve información detallada sobre un Integrador de Sistemas específico.
/v1/systems-integrators/{si_id}/customersDevuelve todos los tenants de clientes gestionados por un Integrador de Sistemas.
/v1/systems-integrators/{si_id}/customersCrea un nuevo tenant de cliente bajo un Integrador de Sistemas.
/v1/tenants/{tenant_id}Devuelve información detallada sobre un tenant específico.
/v1/tenants/{tenant_id}Actualiza la configuración del tenant incluyendo nombre, características y cuotas.
/v1/tenants/{tenant_id}Archiva o elimina un tenant y todos los datos asociados.
Endpoints de configuración administrativa y utilidades.
/v1/portal/admin/configDevuelve datos de configuración para la UI de admin.
/v1/portal/data/countriesDevuelve una lista de todos los países con sus regiones para formularios de dirección.
/healthEndpoint simple de verificación de salud que devuelve el estado del servicio.
/v1/platforms/supportedDevuelve la lista de plataformas que pueden especificarse al emitir tokens.
/audit/logsDevuelve registros de auditoría de seguridad para el servicio de autenticación.
El Servicio de API (api.knogin.com) es la plataforma central de inteligencia que proporciona más de 130 endpoints REST para investigaciones, casos, perfiles, evidencias, alertas, servicios de IA, comunicación en tiempo real y más. Todos los endpoints requieren autenticación a menos que se marquen como públicos.
Endpoints de monitoreo de salud del sistema y descubrimiento de capacidades para integración y monitoreo.
/api/v1/healthDevuelve el estado de salud detallado de todos los componentes del sistema.
/api/v1/health/simpleVerificación de salud ligera para balanceadores de carga.
/api/v1/health/db-checkVerifica la conectividad con todos los sistemas de bases de datos.
/api/v1/health/connectivityVerifica la conectividad con todos los servicios externos.
/api/v1/capabilitiesDevuelve capacidades completas del sistema para configuración de frontend.
Procesamiento de documentos con IA para extraer entidades, relaciones e inteligencia de archivos de texto, imágenes, audio y video.
/api/v1/intelligence/process-textCargar y procesar archivos de texto, PDF o DOCX para investigación usando IA.
/api/v1/intelligence/process-text/base64Endpoint compatible con Cloudflare para procesar documentos codificados en base64.
/api/v1/process-image-fileCargar y procesar imágenes para análisis visual con IA.
/api/v1/process-image-file/base64Endpoint para procesar imágenes codificadas en base64.
/api/v1/process-audio-fileCargar y procesar archivos de audio para transcripción e identificación de hablantes.
/api/v1/process-audio-file/base64Endpoint para procesar audio codificado en base64.
/api/v1/process-video-fileCargar y procesar archivos de video para análisis completo.
/api/v1/process-video-file/base64Endpoint para procesar video codificado en base64.
Crear, actualizar y enriquecer perfiles de entidades con datos de proveedores OSINT. Soporta operaciones individuales y por lotes.
/api/v1/profilesCrea un nuevo perfil de entidad.
/api/v1/profiles/{profile_id}Devuelve datos completos del perfil.
/api/v1/profiles/{profile_id}Actualiza campos del perfil.
/api/v1/profiles/{profile_id}Elimina suavemente un perfil.
/api/v1/profiles/{profile_id}/enrichEnriquece un perfil con datos de proveedores OSINT.
/api/v1/batch/profilesRecupera múltiples perfiles por ID en una sola solicitud.
/api/v1/batch/enrichEnriquece múltiples perfiles en una sola solicitud.
/api/v1/profiles/searchBúsqueda de texto completo en todos los campos de perfil.
/api/v1/profiles/linkCrea una relación entre dos perfiles.
/api/v1/profiles/linkElimina una relación entre dos perfiles.
Gestionar investigaciones, casos, tareas y el ciclo de vida completo de la investigación.
/api/v1/investigationsCrea un nuevo espacio de trabajo de investigación.
/api/v1/investigations/{investigation_id}Devuelve detalles completos de la investigación.
/api/v1/investigations/{investigation_id}Actualiza metadatos de la investigación.
/api/v1/investigations/{investigation_id}Elimina suavemente una investigación.
/api/v1/investigationsDevuelve investigaciones accesibles para el usuario actual.
/api/v1/investigations/{investigation_id}/filesAsocia archivos cargados con una investigación.
Configurar reglas de monitoreo y gestionar alertas activadas por flujos de datos en tiempo real.
/api/v1/alertsCrea programáticamente una alerta.
/api/v1/alerts/{alert_id}Devuelve detalles completos de la alerta.
/api/v1/alerts/{alert_id}Actualiza metadatos o estado de la alerta.
/api/v1/alerts/{alert_id}/decideRegistra una decisión sobre una alerta.
/api/v1/alertsDevuelve alertas que coinciden con criterios de filtro.
Configurar reglas de monitoreo y gestionar alertas activadas por flujos de datos en tiempo real.
/api/v1/monitorsCrea una regla de monitoreo que activa alertas.
/api/v1/monitors/{monitor_id}Devuelve configuración del monitor y estadísticas.
/api/v1/monitors/{monitor_id}Actualiza condiciones del monitor.
/api/v1/monitors/{monitor_id}Elimina permanentemente un monitor.
/api/v1/monitorsDevuelve todos los monitores para el tenant actual.
/api/v1/ai/generate-monitor-specUsa IA para convertir descripciones en lenguaje natural en especificaciones de monitor.
Acceso directo a capacidades de IA incluyendo análisis de texto, extracción de entidades, mapeo de relaciones y procesamiento de lenguaje natural.
/api/v1/ai/analyze-textRealiza análisis de IA completo sobre contenido de texto.
/api/v1/ai/generate-graphCrea un grafo de conocimiento desde texto no estructurado.
/api/v1/ai/summarizeGenera resúmenes concisos de contenido largo.
/api/v1/ai/translateTraduce contenido entre idiomas soportados.
/api/v1/ai/extract-entitiesExtrae y clasifica entidades nombradas del texto.
Cargar, descargar y gestionar archivos con aplicación completa de RBAC y registro de auditoría.
/api/v1/filesCarga un archivo a almacenamiento seguro.
/api/v1/files/{file_id}/downloadDescarga un archivo con aplicación de RBAC.
/api/v1/files/{file_id}/streamTransmite un archivo para carga progresiva.
/api/v1/files/{file_id}/presigned-urlGenera una URL prefirmada con tiempo limitado.
/api/v1/admin/filesDevuelve todos los archivos en el sistema.
/api/v1/admin/files/{file_id}/auditDevuelve rastro de auditoría completo para un archivo.
Endpoints de API autodescriptivos para integración dinámica y documentación.
/api/v1/docs/endpointsDevuelve documentación completa de todos los endpoints.
/api/v1/metadata/domainsDevuelve metadatos sobre todos los dominios disponibles.
/api/v1/metadata/enumsDevuelve todos los tipos de enumeración usados en la API.
/api/v1/metadata/providersDevuelve metadatos sobre proveedores de datos OSINT.
Rastros de auditoría criptográficos con verificación de árbol Merkle para registros a prueba de manipulaciones.
/api/v1/audit/anchor/latestDevuelve el hash raíz de árbol Merkle más reciente.
/api/v1/audit/anchor/proof/{entry_id}Devuelve una prueba de inclusión Merkle para una entrada de auditoría.
AI-assisted mission planning and operational support.
/api/v1/mission-plansPlanificación de misión asistida por IA.
/api/v1/mission-plans/{plan_id}Refina iterativamente un plan de misión existente.
Gestión completa del ciclo de vida de casos con flujo de trabajo, asignaciones, plantillas y seguimiento de cronología.
/api/v1/casesCrea un nuevo caso dentro de una investigación con título, descripción, prioridad, estado y usuario asignado.
/api/v1/cases/{case_id}Devuelve detalles completos del caso incluyendo metadatos, usuarios asignados, perfiles vinculados, tareas, notas y cronología.
/api/v1/cases/{case_id}Actualiza metadatos del caso incluyendo título, descripción, prioridad, estado, fecha límite y campos personalizados.
/api/v1/cases/{case_id}Elimina suavemente un caso y todos los datos asociados. Los datos se retienen por período de cumplimiento.
/api/v1/casesDevuelve casos con filtrado por investigación, estado, prioridad, asignado, rango de fechas y etiquetas.
/api/v1/cases/{case_id}/assignAsigna o reasigna un caso a un usuario o equipo. Soporta múltiples asignados.
/api/v1/cases/{case_id}/statusActualiza el estado del caso con validación de flujo de trabajo.
/api/v1/cases/{case_id}/link-profileAsocia un perfil de entidad con un caso especificando el tipo de relación.
/api/v1/cases/{case_id}/link-profile/{profile_id}Elimina la asociación entre un perfil y un caso.
/api/v1/cases/{case_id}/timelineDevuelve la cronología completa de actividad del caso.
/api/v1/cases/bulk-updateActualiza múltiples casos en una sola solicitud.
/api/v1/cases/from-templateCrea un nuevo caso usando una plantilla predefinida.
Crear y gestionar tareas con asignaciones, listas de verificación, dependencias y seguimiento de progreso.
/api/v1/tasksCrea una nueva tarea dentro de un caso con título, descripción, asignado y fecha límite.
/api/v1/tasks/{task_id}Devuelve detalles completos de la tarea incluyendo lista de verificación y subtareas.
/api/v1/tasks/{task_id}Actualiza campos de la tarea incluyendo título, descripción, fecha límite y progreso.
/api/v1/tasks/{task_id}Elimina una tarea y opcionalmente sus subtareas.
/api/v1/cases/{case_id}/tasksDevuelve todas las tareas de un caso con filtrado.
/api/v1/tasks/{task_id}/assignAsigna o reasigna una tarea a un usuario.
/api/v1/tasks/{task_id}/completeMarca una tarea como completada con notas opcionales.
/api/v1/tasks/{task_id}/checklistActualiza elementos de la lista de verificación de una tarea.
/api/v1/tasks/my-tasksDevuelve todas las tareas asignadas al usuario actual.
/api/v1/tasks/bulk-updateActualiza múltiples tareas en una sola solicitud.
Notas de investigación con texto enriquecido, hilos, adjuntos y controles de visibilidad.
/api/v1/notesCrea una nueva nota adjunta a un caso o investigación con texto enriquecido y menciones.
/api/v1/notes/{note_id}Devuelve contenido de la nota con metadatos, adjuntos y respuestas.
/api/v1/notes/{note_id}Actualiza contenido o metadatos de la nota. Mantiene historial de versiones.
/api/v1/notes/{note_id}Elimina suavemente una nota. El contenido se retiene para cumplimiento.
/api/v1/cases/{case_id}/notesDevuelve todas las notas de un caso respetando reglas de visibilidad.
/api/v1/notes/{note_id}/attachmentsAdjunta un archivo a una nota existente.
/api/v1/notes/{note_id}/replyCrea una respuesta en hilo a una nota existente.
Gestionar archivos adjuntos con procesamiento, cadena de custodia y verificación de integridad.
/api/v1/attachmentsSube y adjunta un archivo a un caso, nota o tarea.
/api/v1/attachments/{attachment_id}Devuelve metadatos del adjunto incluyendo estado de procesamiento.
/api/v1/attachments/{attachment_id}Elimina suavemente un adjunto.
/api/v1/cases/{case_id}/attachmentsDevuelve todos los adjuntos de un caso con filtrado.
/api/v1/attachments/{attachment_id}/processActiva reprocesamiento de un adjunto con modelos actualizados.
/api/v1/attachments/{attachment_id}/chain-of-custodyDevuelve el registro completo de cadena de custodia.
Análisis de redes, búsqueda de rutas, métricas de centralidad y detección de comunidades en el grafo de conocimiento.
/api/v1/graph/node/{node_id}Devuelve un nodo del grafo de conocimiento con todas sus propiedades.
/api/v1/graph/node/{node_id}/neighborsDevuelve todos los nodos conectados directamente dentro de la profundidad especificada.
/api/v1/graph/pathEncuentra la ruta más corta entre dos nodos.
/api/v1/graph/subgraphExtrae un subgrafo alrededor de nodos semilla especificados.
/api/v1/graph/queryEjecuta una consulta Cypher de solo lectura. Solo administradores.
/api/v1/graph/statisticsDevuelve estadísticas agregadas del grafo de conocimiento.
/api/v1/graph/centralityCalcula métricas de centralidad para identificar entidades clave.
/api/v1/graph/community-detectionEjecuta algoritmos de detección de comunidades.
/api/v1/graph/link-predictionUsa ML de grafos para predecir relaciones probables.
Consultas basadas en ubicación, agrupación, mapas de calor, rutas y análisis de línea de tiempo geográfica.
/api/v1/geo/searchBusca entidades con datos de ubicación que coincidan con criterios espaciales.
/api/v1/geo/within-boundsDevuelve entidades dentro de un rectángulo delimitador.
/api/v1/geo/within-radiusDevuelve entidades dentro de un radio especificado de un punto central.
/api/v1/geo/within-polygonDevuelve entidades dentro de un polígono GeoJSON.
/api/v1/geo/clustersDevuelve datos de ubicación agrupados para visualización de mapas.
/api/v1/geo/heatmapDevuelve datos de densidad para visualización de mapas de calor.
/api/v1/geo/routeCalcula ruta óptima entre ubicaciones.
/api/v1/geo/timeline/{entity_id}Devuelve historial cronológico de ubicaciones de una entidad.
/api/v1/geo/geocodeConvierte una dirección de texto en coordenadas geográficas.
/api/v1/geo/reverse-geocodeConvierte coordenadas en una dirección legible.
Crear tableros personalizables con gráficos, mapas, métricas y vistas compartidas de equipo.
/api/v1/dashboardsCrea un nuevo tablero con título, descripción y configuración de diseño.
/api/v1/dashboards/{dashboard_id}Devuelve configuración del tablero incluyendo todos los paneles.
/api/v1/dashboards/{dashboard_id}Actualiza metadatos o configuración de diseño del tablero.
/api/v1/dashboards/{dashboard_id}Elimina un tablero y todos sus paneles.
/api/v1/dashboardsDevuelve todos los tableros accesibles al usuario.
/api/v1/dashboards/{dashboard_id}/panelsAñade un nuevo panel al tablero.
/api/v1/dashboards/{dashboard_id}/panels/{panel_id}Actualiza configuración del panel.
/api/v1/dashboards/{dashboard_id}/panels/{panel_id}Elimina un panel del tablero.
/api/v1/dashboards/{dashboard_id}/shareComparte un tablero con usuarios o equipos específicos.
/api/v1/dashboards/{dashboard_id}/cloneCrea una copia de un tablero con todos los paneles.
Generar informes profesionales, paquetes judiciales y exportaciones de datos en múltiples formatos.
/api/v1/reports/generateGenera un informe desde plantilla o configuración personalizada.
/api/v1/reports/{report_id}Devuelve metadatos del informe incluyendo estado de generación.
/api/v1/reports/{report_id}/downloadDescarga un archivo de informe generado.
/api/v1/reportsDevuelve todos los informes generados por el usuario o equipo.
/api/v1/reports/{report_id}Elimina un archivo de informe generado.
/api/v1/exports/case/{case_id}Exporta un paquete completo del caso.
/api/v1/exports/investigation/{investigation_id}Exporta una investigación completa con todos los casos.
/api/v1/exports/court-packageGenera paquete de evidencias listo para corte.
/api/v1/reports/templatesDevuelve plantillas de informe disponibles.
/api/v1/reports/schedulePrograma generación automática de informes.
Búsqueda global de texto completo, búsqueda semántica y capacidades de consulta avanzada en todos los datos.
/api/v1/searchBúsqueda de texto completo en todos los datos accesibles.
/api/v1/search/entitiesBúsqueda específica dentro de perfiles de entidad.
/api/v1/search/documentsBúsqueda dentro del contenido de documentos.
/api/v1/search/advancedBúsqueda estructurada con consultas booleanas complejas.
/api/v1/search/semanticBúsqueda semántica con IA que entiende la intención.
/api/v1/search/suggestionsDevuelve sugerencias de autocompletado.
/api/v1/search/historyDevuelve consultas de búsqueda recientes del usuario.
/api/v1/search/saveGuarda una consulta de búsqueda para acceso rápido.
Organizar entidades con etiquetas para categorización, filtrado y descubrimiento entre dominios.
/api/v1/tagsCrea una nueva etiqueta con nombre, color y descripción opcional.
/api/v1/tagsDevuelve todas las etiquetas disponibles con conteos de uso.
/api/v1/tags/{tag_id}Actualiza propiedades de la etiqueta.
/api/v1/tags/{tag_id}Elimina una etiqueta de todas las entidades.
/api/v1/tags/applyAplica etiquetas a una entidad.
/api/v1/tags/removeElimina etiquetas especificadas de una entidad.
/api/v1/tags/{tag_id}/entitiesDevuelve todas las entidades con una etiqueta específica.
Comentarios en hilos con menciones, reacciones y funciones de colaboración en tiempo real.
/api/v1/commentsCrea un comentario en cualquier entidad con menciones y formato.
/api/v1/comments/{comment_id}Devuelve un comentario con metadatos, respuestas y reacciones.
/api/v1/comments/{comment_id}Actualiza contenido del comentario. Se preserva el historial.
/api/v1/comments/{comment_id}Elimina un comentario. Las respuestas permanecen visibles.
/api/v1/{entity_type}/{entity_id}/commentsDevuelve todos los comentarios de una entidad específica.
/api/v1/comments/{comment_id}/replyCrea una respuesta en hilo a un comentario.
/api/v1/comments/{comment_id}/reactAñade o elimina una reacción emoji a un comentario.
Gestionar notificaciones a través de canales con preferencias personalizables y horas de silencio.
/api/v1/notificationsDevuelve todas las notificaciones del usuario actual.
/api/v1/notifications/unread-countDevuelve el conteo de notificaciones no leídas.
/api/v1/notifications/{notification_id}/readMarca una notificación como leída.
/api/v1/notifications/mark-all-readMarca todas las notificaciones como leídas.
/api/v1/notifications/{notification_id}Elimina permanentemente una notificación.
/api/v1/notifications/preferencesDevuelve preferencias de notificación del usuario.
/api/v1/notifications/preferencesActualiza preferencias de notificación.
Gestión de equipos con miembros, roles, permisos y jerarquías organizacionales.
/api/v1/teamsCrea un nuevo equipo con nombre, descripción y miembros iniciales.
/api/v1/teams/{team_id}Devuelve detalles del equipo incluyendo miembros y roles.
/api/v1/teams/{team_id}Actualiza metadatos del equipo.
/api/v1/teams/{team_id}Elimina un equipo. Los miembros pierden permisos del equipo.
/api/v1/teamsDevuelve todos los equipos que el usuario puede ver.
/api/v1/teams/{team_id}/membersAñade un usuario al equipo con rol especificado.
/api/v1/teams/{team_id}/members/{user_id}Elimina un usuario del equipo.
/api/v1/teams/{team_id}/members/{user_id}/roleCambia el rol de un miembro del equipo.
Monitorear entidades contra listas de vigilancia con coincidencia automática y generación de alertas.
/api/v1/watchlistsCrea una nueva lista de vigilancia con criterios de coincidencia.
/api/v1/watchlists/{watchlist_id}Devuelve configuración de la lista de vigilancia.
/api/v1/watchlists/{watchlist_id}Actualiza configuración de la lista de vigilancia.
/api/v1/watchlists/{watchlist_id}Elimina una lista de vigilancia.
/api/v1/watchlistsDevuelve todas las listas de vigilancia accesibles.
/api/v1/watchlists/{watchlist_id}/entitiesAñade una entidad específica para monitoreo.
/api/v1/watchlists/{watchlist_id}/entities/{entity_id}Elimina una entidad del monitoreo.
/api/v1/watchlists/{watchlist_id}/checkVerifica si una entidad coincide con criterios.
/api/v1/watchlists/batch-checkVerifica múltiples entidades contra todas las listas activas.
/api/v1/watchlists/{watchlist_id}/matchesDevuelve todas las coincidencias de una lista de vigilancia.
Seguimiento de evidencias admisibles en corte con cadena de custodia, verificación de integridad y sellado.
/api/v1/evidenceCrea un registro formal de evidencia con seguimiento de custodia.
/api/v1/evidence/{evidence_id}Devuelve registro de evidencia con metadatos y cadena de custodia.
/api/v1/evidence/{evidence_id}Actualiza metadatos de evidencia. El contenido sellado no se puede modificar.
/api/v1/cases/{case_id}/evidenceDevuelve todos los elementos de evidencia de un caso.
/api/v1/evidence/{evidence_id}/custody-transferRegistra una transferencia de custodia entre custodios.
/api/v1/evidence/{evidence_id}/chain-of-custodyDevuelve historial completo de cadena de custodia.
/api/v1/evidence/{evidence_id}/verify-integrityVerifica integridad de evidencia recalculando hash.
/api/v1/evidence/{evidence_id}/sealSella elemento de evidencia previniendo modificaciones.
/api/v1/evidence/{evidence_id}/audit-trailDevuelve rastro de auditoría completo de la evidencia.
Consultar múltiples proveedores OSINT para inteligencia de personas, organizaciones, teléfonos, correos, redes sociales, vehículos, dominios, IP y criptomonedas.
/api/v1/osint/providersDevuelve todos los proveedores OSINT configurados.
/api/v1/osint/providers/{provider_id}/statusDevuelve estado detallado de un proveedor OSINT.
/api/v1/osint/search/personBusca información sobre una persona en fuentes OSINT.
/api/v1/osint/search/organizationBusca información de organización incluyendo registros corporativos.
/api/v1/osint/search/phoneBúsqueda inversa de teléfono en bases de datos.
/api/v1/osint/search/emailBúsqueda de inteligencia de correo electrónico.
/api/v1/osint/search/socialBusca perfiles en redes sociales.
/api/v1/osint/search/vehicleBúsqueda de vehículo por VIN o placa.
/api/v1/osint/search/domainInteligencia de dominio incluyendo WHOIS y DNS.
/api/v1/osint/search/ipInteligencia de dirección IP incluyendo geolocalización.
/api/v1/osint/search/cryptoAnálisis de dirección de criptomoneda.
/api/v1/osint/batch-enrichEnriquece múltiples entidades con datos OSINT.
/api/v1/osint/usageDevuelve estadísticas de uso de consultas OSINT.
Plantillas reutilizables para casos, informes y flujos de trabajo para estandarizar procesos.
/api/v1/templates/caseCrea una plantilla reutilizable de caso.
/api/v1/templates/caseDevuelve todas las plantillas de caso disponibles.
/api/v1/templates/case/{template_id}Devuelve configuración completa de la plantilla.
/api/v1/templates/case/{template_id}Actualiza configuración de la plantilla.
/api/v1/templates/case/{template_id}Elimina una plantilla de caso.
/api/v1/templates/reportCrea una plantilla de informe con diseño y secciones.
/api/v1/templates/reportDevuelve todas las plantillas de informe.
/api/v1/templates/workflowCrea una plantilla de flujo de trabajo automatizado.
/api/v1/templates/workflowDevuelve todas las plantillas de flujo de trabajo.
Flujos de trabajo automatizados con disparadores, condiciones y acciones para automatización de investigaciones.
/api/v1/workflowsCrea un flujo de trabajo automatizado con disparadores y acciones.
/api/v1/workflows/{workflow_id}Devuelve configuración del flujo de trabajo e historial.
/api/v1/workflows/{workflow_id}Actualiza configuración del flujo de trabajo.
/api/v1/workflows/{workflow_id}Elimina un flujo de trabajo.
/api/v1/workflowsDevuelve todos los flujos de trabajo accesibles.
/api/v1/workflows/{workflow_id}/executeActiva manualmente una ejecución de flujo de trabajo.
/api/v1/workflows/{workflow_id}/executionsDevuelve historial de ejecuciones del flujo de trabajo.
/api/v1/workflows/{workflow_id}/pausePausa un flujo de trabajo activo.
/api/v1/workflows/{workflow_id}/resumeReanuda un flujo de trabajo pausado.
Endpoints de mensajería y colaboración en tiempo real basados en WebSocket.
/api/v1/channelsCrea un canal de mensajería en tiempo real.
/api/v1/channels/{channel_id}Devuelve detalles del canal incluyendo miembros.
/api/v1/channelsDevuelve todos los canales accesibles al usuario.
/api/v1/channels/{channel_id}/messagesEnvía un mensaje a un canal.
/api/v1/channels/{channel_id}/messagesDevuelve historial de mensajes de un canal.
/api/v1/channels/{channel_id}/membersAñade un usuario a un canal.
/api/v1/channels/{channel_id}/members/{user_id}Elimina un usuario de un canal.
/api/v1/users/presenceDevuelve estado en línea/fuera de línea de usuarios.
La API GraphQL principal (api.knogin.com/graphql) proporciona más de 100 consultas, 80+ mutaciones y suscripciones en tiempo real usando el framework Strawberry GraphQL. GraphQL ofrece recuperación flexible de datos, permitiendo a los clientes solicitar exactamente los datos que necesitan en una sola petición.
POST https://api.knogin.com/graphqlGET https://api.knogin.com/graphqlCrear, gestionar y rastrear investigaciones con soporte completo del ciclo de vida incluyendo asignación de equipo, gestión de archivos y seguimiento de progreso.
getInvestigation(investigationId: ID!)getInvestigations(status: [Status], limit: Int, offset: Int)investigationTimeline(investigationId: ID!)investigationStatistics(investigationId: ID!)investigationTeam(investigationId: ID!)startNewInvestigation(input: CreateInvestigationInput!)updateInvestigation(investigationId: ID!, input: UpdateInvestigationInput!)deleteInvestigation(investigationId: ID!)addFilesToInvestigation(investigationId: ID!, fileIds: [ID!]!)assignInvestigationTeam(investigationId: ID!, userIds: [ID!]!)Gestión completa de casos con plantillas, flujos de trabajo, seguimiento de estado, vinculación de perfiles y operaciones masivas para manejo eficiente de casos.
case(caseId: ID!)cases(investigationId: ID, status: [CaseStatus], priority: [Priority], limit: Int, offset: Int)caseByNumber(caseNumber: String!)caseTimeline(caseId: ID!)caseStatistics(caseId: ID!)myCases(status: [CaseStatus], limit: Int)caseTemplates(category: String)createCase(input: CreateCaseInput!)createCaseFromTemplate(templateId: ID!, input: CreateCaseInput!)updateCase(caseId: ID!, input: UpdateCaseInput!)deleteCase(caseId: ID!)assignCase(caseId: ID!, userId: ID!)updateCaseStatus(caseId: ID!, status: CaseStatus!)linkProfileToCase(caseId: ID!, profileId: ID!, role: ProfileRole!)bulkUpdateCases(caseIds: [ID!]!, input: BulkUpdateCaseInput!)Gestión de tareas con asignaciones, listas de verificación, dependencias y seguimiento de progreso para flujos de trabajo de investigación estructurados.
task(taskId: ID!)tasks(caseId: ID!, status: [TaskStatus], assignee: ID)myTasks(status: [TaskStatus], dueDate: DateRange)taskChecklist(taskId: ID!)taskDependencies(taskId: ID!)createTask(input: CreateTaskInput!)updateTask(taskId: ID!, input: UpdateTaskInput!)deleteTask(taskId: ID!)assignTask(taskId: ID!, userId: ID!)completeTask(taskId: ID!, notes: String)updateTaskChecklist(taskId: ID!, items: [ChecklistItemInput!]!)bulkUpdateTasks(taskIds: [ID!]!, input: BulkUpdateTaskInput!)Notas de investigación con texto enriquecido, hilos y archivos adjuntos. Seguimiento completo de cadena de custodia para archivos de grado de evidencia.
note(noteId: ID!)notes(caseId: ID!, type: NoteType, visibility: Visibility)attachment(attachmentId: ID!)attachments(caseId: ID!, fileType: String)attachmentChainOfCustody(attachmentId: ID!)createNote(input: CreateNoteInput!)updateNote(noteId: ID!, input: UpdateNoteInput!)deleteNote(noteId: ID!)replyToNote(parentNoteId: ID!, content: String!)createAttachment(input: CreateAttachmentInput!)deleteAttachment(attachmentId: ID!)reprocessAttachment(attachmentId: ID!)Gestión de perfiles de entidad para personas, organizaciones y otras entidades con enriquecimiento OSINT y mapeo de relaciones.
getProfile(profileId: ID!)listProfiles(type: ProfileType, tags: [String], limit: Int, offset: Int)searchProfiles(query: String!, filters: ProfileFilters)getPerson(personId: ID!)listPersons(filters: PersonFilters)getOrganization(orgId: ID!)listOrganizations(filters: OrgFilters)getEntity(entityId: ID!)searchEntities(query: String!, entityTypes: [EntityType])profileRelationships(profileId: ID!, depth: Int)createProfile(input: CreateProfileInput!)updateProfile(profileId: ID!, input: UpdateProfileInput!)deleteProfile(profileId: ID!)enrichProfile(profileId: ID!, providers: [String])batchEnrichProfiles(profileIds: [ID!]!, providers: [String])linkProfiles(sourceId: ID!, targetId: ID!, relationType: String!)unlinkProfiles(sourceId: ID!, targetId: ID!)mergeProfiles(sourceIds: [ID!]!, targetId: ID!)Sistema de alertas en tiempo real con monitores configurables, niveles de severidad y flujos de trabajo de decisión para detección de amenazas.
getAlertById(alertId: ID!)listAlerts(severity: [Severity], status: [AlertStatus], limit: Int)alertsByMonitor(monitorId: ID!, dateRange: DateRange)alertStatistics(dateRange: DateRange)getMonitor(monitorId: ID!)listMonitors(status: MonitorStatus, type: MonitorType)monitorPerformance(monitorId: ID!)createAlert(input: CreateAlertInput!)updateAlert(alertId: ID!, input: UpdateAlertInput!)decideAlert(alertId: ID!, decision: AlertDecision!, notes: String)bulkDecideAlerts(alertIds: [ID!]!, decision: AlertDecision!)createMonitor(input: CreateMonitorInput!)updateMonitor(monitorId: ID!, input: UpdateMonitorInput!)deleteMonitor(monitorId: ID!)pauseMonitor(monitorId: ID!)resumeMonitor(monitorId: ID!)Operaciones de grafo de conocimiento incluyendo búsqueda de caminos, análisis de centralidad, detección de comunidades y predicción de enlaces para inteligencia de redes.
graphNode(nodeId: ID!)graphNeighbors(nodeId: ID!, depth: Int, relationTypes: [String])findPath(sourceId: ID!, targetId: ID!, maxDepth: Int)shortestPath(sourceId: ID!, targetId: ID!)subgraph(seedIds: [ID!]!, depth: Int)graphStatistics(investigationId: ID)centrality(nodeIds: [ID!]!, algorithm: CentralityAlgorithm)communities(investigationId: ID!, algorithm: CommunityAlgorithm)linkPrediction(nodeId: ID!, limit: Int)createGraphNode(input: CreateNodeInput!)updateGraphNode(nodeId: ID!, input: UpdateNodeInput!)deleteGraphNode(nodeId: ID!)createGraphEdge(input: CreateEdgeInput!)updateGraphEdge(edgeId: ID!, input: UpdateEdgeInput!)deleteGraphEdge(edgeId: ID!)mergeNodes(sourceIds: [ID!]!, targetId: ID!)Consultas basadas en ubicación, clustering, mapas de calor, geofencing y análisis de línea de tiempo para operaciones de inteligencia geográfica.
getLocation(locationId: ID!)listLocations(bounds: BoundingBox, entityType: EntityType)entitiesWithinBounds(bounds: BoundingBox!, filters: GeoFilters)entitiesWithinRadius(center: LatLng!, radiusKm: Float!)entitiesWithinPolygon(polygon: GeoJSONPolygon!)locationClusters(bounds: BoundingBox!, zoomLevel: Int!)heatmapData(bounds: BoundingBox!, resolution: Int)locationTimeline(entityId: ID!, dateRange: DateRange)geocode(address: String!)reverseGeocode(coordinates: LatLng!)createLocation(input: CreateLocationInput!)updateLocation(locationId: ID!, input: UpdateLocationInput!)deleteLocation(locationId: ID!)linkLocationToEntity(locationId: ID!, entityId: ID!)createGeofence(input: CreateGeofenceInput!)updateGeofence(geofenceId: ID!, input: UpdateGeofenceInput!)Crear y gestionar paneles personalizables con widgets, gráficos y métricas en tiempo real para conciencia operacional.
getDashboard(dashboardId: ID!)listDashboards(type: DashboardType, shared: Boolean)getDashboardMetrics(dashboardId: ID!)panelData(panelId: ID!, dateRange: DateRange)dashboardTemplates(category: String)createDashboard(input: CreateDashboardInput!)updateDashboard(dashboardId: ID!, input: UpdateDashboardInput!)deleteDashboard(dashboardId: ID!)addPanelToDashboard(dashboardId: ID!, input: PanelInput!)updatePanel(panelId: ID!, input: UpdatePanelInput!)deletePanel(panelId: ID!)shareDashboard(dashboardId: ID!, userIds: [ID!]!)cloneDashboard(dashboardId: ID!, newName: String!)Búsqueda global con capacidades semánticas, filtros avanzados y consultas guardadas para descubrimiento rápido de inteligencia.
globalSearch(query: String!, limit: Int, offset: Int)semanticSearch(query: String!, entityTypes: [EntityType])advancedSearch(input: AdvancedSearchInput!)searchSuggestions(prefix: String!, limit: Int)searchHistory(limit: Int)savedSearchessaveSearch(input: SaveSearchInput!)deleteSavedSearch(searchId: ID!)clearSearchHistorySeguimiento de evidencias admisibles en corte con cadena de custodia, verificación de integridad y sellado para procedimientos legales.
evidence(evidenceId: ID!)evidenceByCase(caseId: ID!, type: EvidenceType)evidenceChainOfCustody(evidenceId: ID!)verifyEvidenceIntegrity(evidenceId: ID!)evidenceAuditTrail(evidenceId: ID!)createEvidence(input: CreateEvidenceInput!)updateEvidence(evidenceId: ID!, input: UpdateEvidenceInput!)recordCustodyTransfer(evidenceId: ID!, input: CustodyTransferInput!)sealEvidence(evidenceId: ID!)linkEvidenceToCase(evidenceId: ID!, caseId: ID!)Consultas de inteligencia de fuentes abiertas a través de múltiples proveedores para datos de personas, organizaciones, teléfonos, correos, redes sociales, vehículos, dominios, IP y criptomonedas.
osintProvidersosintProviderStatus(providerId: ID!)osintUsage(dateRange: DateRange)searchPerson(input: PersonSearchInput!)searchOrganization(input: OrgSearchInput!)searchPhone(phoneNumber: String!, providers: [String])searchEmail(email: String!, providers: [String])searchSocialMedia(input: SocialSearchInput!)searchVehicle(input: VehicleSearchInput!)searchDomain(domain: String!)searchIP(ipAddress: String!)searchCrypto(address: String!, blockchain: String!)batchEnrich(entityIds: [ID!]!, providers: [String])Gestión de equipos con roles de miembros, permisos y jerarquías para operaciones colaborativas de investigación.
team(teamId: ID!)teams(parentId: ID)teamMembers(teamId: ID!)myTeamsuser(userId: ID!)users(role: Role, status: UserStatus)currentUsercreateTeam(input: CreateTeamInput!)updateTeam(teamId: ID!, input: UpdateTeamInput!)deleteTeam(teamId: ID!)addTeamMember(teamId: ID!, userId: ID!, role: TeamRole!)removeTeamMember(teamId: ID!, userId: ID!)updateTeamMemberRole(teamId: ID!, userId: ID!, role: TeamRole!)Flujos de trabajo automatizados con disparadores, condiciones y acciones para procesos de investigación optimizados.
workflow(workflowId: ID!)workflows(status: WorkflowStatus, trigger: TriggerType)workflowExecutions(workflowId: ID!, status: ExecutionStatus)workflowExecution(executionId: ID!)workflowTemplates(category: String)createWorkflow(input: CreateWorkflowInput!)updateWorkflow(workflowId: ID!, input: UpdateWorkflowInput!)deleteWorkflow(workflowId: ID!)executeWorkflow(workflowId: ID!, input: JSON)pauseWorkflow(workflowId: ID!)resumeWorkflow(workflowId: ID!)cancelExecution(executionId: ID!)Análisis de texto impulsado por IA, extracción de entidades, resumen, traducción y capacidades de procesamiento de documentos.
aiProcessingStatus(jobId: ID!)aiProcessingHistory(entityId: ID!)aiCapabilitiesanalyzeText(text: String!, options: AnalysisOptions)extractEntities(text: String!, entityTypes: [EntityType])generateSummary(text: String!, style: SummaryStyle)translateText(text: String!, targetLanguage: String!)generateGraph(text: String!)processDocument(fileId: ID!, options: ProcessingOptions)processImage(fileId: ID!, options: ImageProcessingOptions)processAudio(fileId: ID!, options: AudioProcessingOptions)processVideo(fileId: ID!, options: VideoProcessingOptions)Notificaciones en tiempo real con preferencias, comentarios en hilos, menciones y reacciones para colaboración de equipo.
notifications(status: NotificationStatus, limit: Int)unreadNotificationCountnotificationPreferencescomments(entityId: ID!, entityType: EntityType)comment(commentId: ID!)markNotificationRead(notificationId: ID!)markAllNotificationsReadupdateNotificationPreferences(input: NotificationPreferencesInput!)createComment(input: CreateCommentInput!)updateComment(commentId: ID!, content: String!)deleteComment(commentId: ID!)replyToComment(parentId: ID!, content: String!)reactToComment(commentId: ID!, reaction: String!)Suscribirse a actualizaciones en tiempo real vía WebSocket para streaming de datos en vivo a través de todos los dominios.
alertStreamalertUpdates(alertId: ID!)monitorAlerts(monitorId: ID!)investigationProgress(investigationId: ID!)caseUpdates(caseId: ID!)taskUpdates(caseId: ID!)dashboardUpdates(dashboardId: ID!)panelData(panelId: ID!)metricsStream(dashboardId: ID!)channelMessages(channelId: ID!)userPresence(userIds: [ID!]!)typingIndicator(channelId: ID!)processingProgress(jobId: ID!)enrichmentProgress(profileId: ID!)workflowExecution(executionId: ID!)notificationStreammentionStreamsystemAnnouncementsquery GetInvestigationWithCases($investigationId: ID!) {
getInvestigation(investigationId: $investigationId) {
id
title
status
createdAt
profiles {
id
name
type
riskScore
}
}
cases(investigationId: $investigationId) {
id
title
status
priority
assignedTo {
id
displayName
}
tasks {
id
title
status
dueDate
}
}
}mutation CreateAlert($input: CreateAlertInput!) {
createAlert(input: $input) {
id
title
severity
confidence
createdAt
entities {
id
name
type
}
}
}
# Variables
{
"input": {
"title": "Suspicious Activity Detected",
"summary": "Multiple failed login attempts from unusual location",
"severity": "HIGH",
"confidence": 0.85,
"entities": ["entity-123"],
"monitorId": "monitor-456"
}
}Comunicación en tiempo real a través de WebSocket para actualizaciones en vivo, suscripciones GraphQL y funciones de colaboración.
wss://api.knogin.com/graphqlEndpoint WebSocket para suscripciones GraphQL.
wss://api.knogin.com/wsEndpoint WebSocket para streaming de eventos en tiempo real.
subscription AlertStream {
alertStream {
id
title
severity
confidence
createdAt
entities {
id
name
}
locations {
latitude
longitude
}
}
}Estructuras de respuesta estándar utilizadas en toda la API.
{
"success": true,
"data": { ... },
"message": "Operation completed successfully",
"timestamp": "2024-01-15T10:30:00Z",
"request_id": "req_abc123"
}{
"error": "VALIDATION_ERROR",
"message": "Invalid input parameters",
"code": "ERR_VALIDATION_001",
"details": {
"field": "email",
"reason": "Invalid email format"
},
"timestamp": "2024-01-15T10:30:00Z"
}Códigos de estado comunes devueltos por la API.
Límites de tasa de API para asegurar uso justo y estabilidad del sistema.