Para Proveedores y Socios

Guía de Integración

Todo lo que necesita para integrar sus sistemas con Public Safety Command Center. Ya sea proveedor de datos, integrador de sistemas o socio tecnológico, esta guía cubre todos los puntos de integración, formatos de datos y mejores prácticas.

Brief Integration Team Open API Reference

Delivery posture

Map identity, transport, evidence handling, and partner systems before data is pushed into live investigative workflows.

Primary integration lanes

REST + GraphQL

Outbound events

Webhooks

Typed client support

SDKs

Vendor certification path

Partner intake

Operating context

Plan the integration around the investigation workflow, not around a generic data pipe

Public Safety Command Center proporciona una arquitectura de integración completa y multicapa diseñada para operaciones de inteligencia y aplicación de la ley de nivel empresarial. Nuestra plataforma soporta tanto la ingesta de datos entrantes como el intercambio de datos salientes a través de múltiples protocolos y formatos.

Volume

Endpoints de API

Use the API and GraphQL surface when you need direct object control over investigations, entities, evidence, alerts, and reporting.

200+

Query model

Soporte GraphQL

GraphQL is the best fit when clients need one workspace request instead of a long chain of endpoint calls.

Completo

Realtime

Streaming en Tiempo Real

Use event streams and subscriptions when triage, collaboration, and alerting must update without polling loops.

WebSocket

Inbound lane

Integraciones Entrantes

Envíe datos a Public Safety desde sus sistemas. Ideal para proveedores de datos, fuentes OSINT y sistemas empresariales.

Ingesta de datos en tiempo real vía API
Importaciones de archivos por lotes (CSV, XML, JSON)
Pipelines automatizados de enriquecimiento de datos
Deduplicación y resolución de entidades

Outbound lane

Integraciones Salientes

Reciba datos y alertas de Public Safety. Perfecto para sistemas downstream, dashboards y servicios de notificación.

Notificaciones webhook para eventos
Suscripciones GraphQL para datos en tiempo real
Exportaciones de datos programadas
Generación de informes personalizados

Intake target

Investigation command workspace

The connector design should reflect the same investigation, profile, and alert state analysts are expected to work from.

Operational routing

Playbooks and automation

Inbound and outbound flows should line up with the routing, review, and automation patterns already present in the product.

Primeros Pasos

Stand up the lane in the order that identity, transport, and first-call validation actually happen

A clean rollout starts by proving auth, transport, and minimal workspace access before connector volume or automation is turned on.

1
Obtener Credenciales de API
Solicite credenciales de API a su administrador de Public Safety o a través del panel.
2
Instalar el SDK
Instale el SDK de Public Safety para su lenguaje de programación preferido.
3
Configurar Autenticación
Inicialice el SDK con su clave API y configure cualquier configuración específica.
4
Hacer su Primera Llamada a la API
Pruebe su integración haciendo una simple llamada a la API.

Ejemplo de Autenticación

Token acquisition check

Validate that the identity lane works before any larger connector or file-import job is introduced.

Flujo de Autenticación con Token

curl -X POST https://auth.knogin.com/v1/login \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "[email protected]" \
  -d "password=your-password" \
  -d "platform=argus"

curl -X GET https://api.knogin.com/v1/health \
  -H "Authorization: Bearer <argus_auth_token>"

Autenticación y Autorización

Authentication baseline

Todo acceso a la API requiere autenticación. Soportamos múltiples métodos de autenticación para acomodar diferentes escenarios de integración y requisitos de seguridad.

Autenticación con API Key

Autenticación simple con token bearer para integraciones servidor a servidor. Las claves API tienen permisos específicos y pueden rotarse regularmente.

Authorization: Bearer <api_key>

OAuth 2.0 / OpenID Connect

Soporte completo de OAuth 2.0 para acceso delegado por usuario. Ideal para aplicaciones que actúan en nombre de usuarios con su consentimiento.

OAuth 2.0 / OpenID Connect

Autenticación con Token JWT

Tokens JWT de corta duración para autenticación sin estado. Los tokens incluyen claims de usuario y permisos para control de acceso granular.

argus_auth_token (JWT)

Transport lanes

Métodos de Integración

Elija el método de integración que mejor se adapte a su caso de uso. Soportamos integraciones REST, GraphQL, WebSocket y basadas en archivos.

Method

API GraphQL

Nuestra interfaz API principal. GraphQL le permite solicitar exactamente los datos que necesita en una sola petición, reduciendo ancho de banda y mejorando el rendimiento.

Consulte exactamente los campos que necesita
Suscripciones en tiempo real para actualizaciones en vivo
Esquema fuertemente tipado con introspección

Explorar Esquema GraphQL

Method

API REST

Endpoints RESTful tradicionales para operaciones CRUD simples y compatibilidad con herramientas existentes.

Métodos HTTP estándar (GET, POST, PUT, DELETE)
Cuerpos de solicitud y respuesta en JSON
Especificación OpenAPI 3.0 disponible

Ver Endpoints REST

Method

WebSocket / Tiempo Real

Conexiones persistentes para streaming de datos en tiempo real. Reciba notificaciones instantáneas cuando los datos cambien.

Notificaciones push de baja latencia
Streaming de alertas y suscripciones de eventos
Manejo automático de reconexión

Documentación WebSocket

Method

Importación / Exportación de Archivos

Operaciones de datos en masa a través de cargas de archivos y exportaciones programadas. Soporta múltiples formatos incluyendo CSV, Excel y XML.

Formatos CSV, XLSX, XML, JSON
Formato STIX 2.1 para inteligencia de amenazas
Importaciones programadas automatizadas

Formatos de Datos y Taxonomía

Shape data to the product model early so search, graph, and evidence features do not need a second translation layer

Entender nuestro modelo de datos es esencial para una integración exitosa. Public Safety utiliza una taxonomía estandarizada para entidades, relaciones y eventos.

Tipos de Entidad Principales

Supported entity model

Public Safety soporta un conjunto completo de tipos de entidad para operaciones de aplicación de la ley e inteligencia. Cada tipo de entidad tiene atributos específicos, identificadores y capacidades de relación.

Person

Organization

Vehicle

Location

Document

Phone

Social Account

IP Address

Cryptocurrency

Domain

Event

Format family

Formatos de API

Structured transport for direct client and service integrations.

JSON (application/json)
GraphQL
Multipart form-data

Format family

Formatos de Importación

Bulk-load options for migration, partner exchange, and scheduled ingestion.

CSV / TSV
Excel (XLSX)
XML / NIEM
STIX 2.1

Format family

Archivos Adjuntos

Binary file types that feed OCR, transcription, and evidence workflows.

PDF, DOCX, TXT
JPEG, PNG, GIF, WebP
MP3, WAV, OGG
MP4, MOV, AVI

Ejemplo de Esquema de Entidad

Sample entity payload

This is the shape downstream graph, alert, and reporting workflows expect when external systems send profile records into the platform.

Entidad Persona (JSON)

{
  "id": "profile-uuid-123",
  "type": "PERSON",
  "attributes": {
    "firstName": "John",
    "lastName": "Doe",
    "dateOfBirth": "1985-03-15"
  },
  "identifiers": [
    { "type": "PASSPORT", "value": "AB123456", "country": "US" }
  ],
  "contacts": [
    { "type": "EMAIL", "value": "[email protected]" }
  ],
  "metadata": {
    "source": "vendor-system",
    "sourceId": "ext-12345"
  }
}

Document intake

Source and file review

Schema, file metadata, and provenance should be captured in the same way the review surface expects to consume them.

Conectores Preconstruidos

Use named connectors where they exist, then scope the custom gap instead of pretending every source is interchangeable

Public Safety incluye conectores preconstruidos para sistemas comunes de aplicación de la ley, proveedores OSINT y plataformas empresariales. Se pueden desarrollar conectores personalizados para sistemas adicionales.

Operational systems

Sistemas de Aplicación de la Ley

These are the systems most likely to touch frontline dispatch, records, evidence, and statutory reporting workflows.

CAD Systems

Disponible

RMS Platforms

Disponible

Evidence.com

Disponible

NCIC/NLETS

Disponible

CJIS

Disponible

NIBRS

Disponible

External intelligence

Proveedores de Inteligencia y OSINT

Partner and provider integrations should be scoped by legal basis, quota profile, and the actual entity types being enriched.

TLOxp

Socio

LexisNexis

Socio

Babel Street

Socio

Recorded Future

Socio

VirusTotal

Disponible

Shodan

Disponible

Enterprise systems

Sistemas Empresariales

Enterprise connectors matter when identity, case payloads, or downstream evidence export has to stay inside an existing customer environment.

Microsoft 365 / Entra ID

Disponible

Google Workspace

Disponible

Salesforce

Disponible

ServiceNow

Disponible

Slack

Disponible

AWS S3

Disponible

¿Necesita un conector personalizado?

Custom connector boundary

Nuestro equipo de integración puede construir conectores personalizados para sus sistemas propietarios. Contáctenos para discutir sus requisitos.

SDKs y Bibliotecas Cliente

Choose the client lane that matches the team running the workflow

Los SDKs oficiales simplifican la integración con interfaces de tipo seguro, lógica de reintento automático y manejo de autenticación incorporado.

Client

JavaScript / TypeScript

SDK completo para entornos Node.js y navegador con soporte TypeScript.

Node.js 18+
Browser ESM
TypeScript types

Client

Python

SDK Pythonico con soporte async para flujos de trabajo de ciencia de datos y automatización.

Python 3.10+
Async support
Type hints

Client

Java / Kotlin

SDK de nivel empresarial para aplicaciones Java y Kotlin con soporte Android.

Java 17+
Kotlin coroutines
Android compatible

Client

C# / .NET

SDK .NET moderno con patrones async/await para apps Windows y multiplataforma.

.NET 6+
Async/await
NuGet package

Client

Go

Cliente Go ligero con soporte de contexto para servicios de alto rendimiento.

Go 1.21+
Context support
Zero dependencies

Client

REST / cURL

Acceso directo a API REST con spec OpenAPI, colección Postman y documentación interactiva.

OpenAPI 3.0 spec
Postman collection
Interactive docs

Ejemplo de Uso de SDK (TypeScript)

Typed SDK pattern

Keep the initial proof of value narrow: create a case, attach evidence, and verify the object comes back with the expected status.

Ejemplo de Uso de SDK (TypeScript)

import { PublicSafetyClient } from '@argus/sdk';

const argus = new PublicSafetyClient({
  apiKey: process.env.ARGUS_API_KEY,
  organizationId: 'your-org-id',
  environment: 'production',
});

const investigation = await argus.investigations.create({
  title: 'Financial Fraud Case #2024-001',
  priority: 'HIGH',
});

await argus.evidence.upload({
  investigationId: investigation.id,
  file: documentBuffer,
  metadata: { type: 'document', chainOfCustody: true },
});

Webhooks y Notificaciones de Eventos

Use outbound events when the external system needs to react to operational state changes, not just read static records

Los webhooks permiten a Public Safety enviar notificaciones en tiempo real a sus sistemas cuando ocurren eventos. Configure endpoints de webhook para recibir alertas, cambios de estado y actualizaciones de datos.

Eventos Disponibles

Core outbound event types

Keep the first webhook rollout focused on high-signal transitions instead of mirroring every field change.

alert.createdalert.updatedinvestigation.createdinvestigation.updatedprofile.enrichedevidence.processedreport.generatedworkflow.completed

Seguridad de Webhooks

Webhook control requirements

The event lane has to be reviewable: sign every payload, retry safely, and keep source allowlists explicit.

Verificación de firma HMAC-SHA256 para autenticidad del payload
Reintento automático con backoff exponencial para entregas fallidas
Lista de IPs permitidas disponible para endpoints webhook
Claves de idempotencia para prevenir procesamiento duplicado

Payload de Webhook y Verificación

Event payload shape

Payloads should be easy to verify, route, and persist in downstream oversight systems.

Payload de Webhook y Verificación

{
  "id": "evt_abc123",
  "type": "alert.created",
  "timestamp": "2024-06-20T14:30:00Z",
  "data": {
    "alertId": "alert-xyz789",
    "severity": "HIGH",
    "investigationId": "inv-123",
    "metadata": {
      "triggerRule": "financial-threshold",
      "matchScore": 0.95
    }
  },
  "signature": "sha256=a1b2c3d4..."
}

Automation state

Operational playbooks

Webhook contracts should align with the same alert, workflow, and report-generation moments operators see inside the platform.

Requisitos de Seguridad

Integration delivery is not complete until the security and test lanes are proven with real traffic patterns

Todas las integraciones deben cumplir nuestros requisitos de seguridad para proteger datos sensibles de aplicación de la ley. Aplicamos estándares estrictos para autenticación, cifrado y control de acceso.

Requisitos Técnicos

Baseline security requirements

These controls are the minimum expectation before a live data source is connected.

TLS 1.2 o superior requerido para todas las conexiones
Autenticación requerida para todas las solicitudes API
Cifrado AES-256 para datos en reposo
Registro de auditoría completo de todo acceso API
Aplicación de control de acceso basado en roles (RBAC)

Certificaciones de Cumplimiento

Compliance lanes

The compliance target depends on procurement, customer environment, and the actual systems being connected.

CJIS Security Policy compliant
FedRAMP Moderate authorized
Certificado SOC 2 Tipo II
Certificado ISO 27001
Cumple RGPD para datos de la UE

Pruebas y Entorno Sandbox

Testing and certification

Pruebe su integración en nuestro entorno sandbox antes de pasar a producción. El sandbox proporciona datos de prueba realistas y funcionalidad completa de API sin afectar sistemas de producción.

Entorno Sandbox

Entorno sandbox completo con datos de prueba realistas. Pruebe todas las operaciones API sin afectar datos de producción.

Conjuntos de Datos de Prueba

Datasets de prueba prepoblados incluyendo entidades de muestra, relaciones y alertas para pruebas completas.

Certificación de Integración

Complete nuestro proceso de certificación para convertirse en socio de integración oficial de Public Safety con listado en marketplace.

Proceso de Pruebas de Integración

1Solicite acceso al sandbox a través del portal de socios
2Desarrolle y pruebe su integración contra la API sandbox
3Envíe su integración para revisión por nuestro equipo
4Complete la evaluación de seguridad y pruebas de penetración
5Reciba certificación y despliegue a producción

Conviértase en Socio de Integración

Vendor and partner intake

¿Interesado en integrarse con Public Safety Command Center? Complete el formulario a continuación y nuestro equipo de partnerships se comunicará para discutir los próximos pasos.

Solicitud de Integración de Proveedor

Cuéntenos sobre sus necesidades de integración y le responderemos en 2-3 días hábiles.

Nombre de la Empresa *

Nombre del Contacto *

Email Empresarial *

Número de Teléfono(opcional)

Sitio Web de la Empresa(opcional)

Tipo de Integración *

Categoría de Producto *

Descripción de la Integración *

Clientes Compartidos(opcional)

Cronograma Deseado(opcional)

Su información será manejada de acuerdo con nuestra política de privacidad. Nunca compartiremos sus datos con terceros.

¿Listo para Integrar?

Contacte a nuestro equipo de integración para discutir sus requisitos y obtener acceso a nuestro entorno sandbox.

Contactar Equipo de Integración Ver Referencia de API

Guía de Integración

Plan the integration around the investigation workflow, not around a generic data pipe

Endpoints de API

Soporte GraphQL

Streaming en Tiempo Real

Integraciones Entrantes

Integraciones Salientes

Stand up the lane in the order that identity, transport, and first-call validation actually happen

Obtener Credenciales de API

Instalar el SDK

Configurar Autenticación

Hacer su Primera Llamada a la API

Token acquisition check

Authentication baseline

Métodos de Integración

API GraphQL

API REST

WebSocket / Tiempo Real

Importación / Exportación de Archivos

Shape data to the product model early so search, graph, and evidence features do not need a second translation layer

Supported entity model

Formatos de API

Formatos de Importación

Archivos Adjuntos

Sample entity payload

Use named connectors where they exist, then scope the custom gap instead of pretending every source is interchangeable

Sistemas de Aplicación de la Ley

Proveedores de Inteligencia y OSINT

Sistemas Empresariales

Custom connector boundary

Choose the client lane that matches the team running the workflow

JavaScript / TypeScript

Python

Java / Kotlin

C# / .NET

Go

REST / cURL

Typed SDK pattern

Use outbound events when the external system needs to react to operational state changes, not just read static records

Core outbound event types

Webhook control requirements

Event payload shape

Integration delivery is not complete until the security and test lanes are proven with real traffic patterns

Baseline security requirements

Compliance lanes

Testing and certification

Vendor and partner intake

Solicitud de Integración de Proveedor

¿Listo para Integrar?