Voor Leveranciers & Partners

Integratiegids

Alles wat u nodig heeft om uw systemen te integreren met Public Safety Command Center. Of u nu een dataleverancier, systeemintegrator of technologiepartner bent, deze gids behandelt alle integratiepunten, dataformaten en best practices.

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 biedt een uitgebreide, meerlaagse integratiearchitectuur ontworpen voor wetshandhavings- en inlichtingenoperaties op ondernemingsniveau. Ons platform ondersteunt zowel inkomende data-opname als uitgaande gegevensdeling via meerdere protocollen en formaten.

Volume

API-eindpunten

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

200+

Query model

GraphQL-ondersteuning

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

Volledig

Realtime

Real-time Streaming

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

WebSocket

Inbound lane

Inkomende Integraties

Push data naar Public Safety vanuit uw systemen. Ideaal voor dataleveranciers, OSINT-bronnen en bedrijfssystemen.

Real-time data-opname via API
Batch-bestandsimport (CSV, XML, JSON)
Geautomatiseerde dataverrijkingspijplijnen
Ontdubbeling en entiteitsresolutie

Outbound lane

Uitgaande Integraties

Ontvang data en waarschuwingen van Public Safety. Perfect voor downstream-systemen, dashboards en notificatiediensten.

Webhook-notificaties voor gebeurtenissen
GraphQL-abonnementen voor real-time data
Geplande data-exports
Aangepaste rapportgeneratie

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.

Aan de slag

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
API-referenties Verkrijgen
Vraag API-referenties aan bij uw Public Safety-beheerder of via het dashboard. U ontvangt een API-sleutel en organisatie-ID.
2
De SDK Installeren
Installeer de Public Safety SDK voor uw voorkeursprogrammeertaal. Wij ondersteunen Python, JavaScript/TypeScript en meer.
3
Authenticatie Configureren
Initialiseer de SDK met uw API-sleutel en configureer eventuele omgevingsspecifieke instellingen.
4
Uw Eerste API-aanroep Maken
Test uw integratie door een eenvoudige API-aanroep te doen om onderzoeken weer te geven of uw verbindingsstatus te controleren.

Authenticatievoorbeeld

Token acquisition check

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

Token Authenticatiestroom

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>"

Authenticatie & Autorisatie

Authentication baseline

Alle API-toegang vereist authenticatie. We ondersteunen meerdere authenticatiemethoden om tegemoet te komen aan verschillende integratiescenario's en beveiligingseisen.

API-sleutel Authenticatie

Eenvoudige bearer-token authenticatie voor server-naar-server integraties. API-sleutels zijn beperkt tot specifieke machtigingen en kunnen regelmatig worden geroteerd.

Authorization: Bearer <api_key>

OAuth 2.0 / OpenID Connect

Volledige OAuth 2.0-ondersteuning voor door gebruikers gedelegeerde toegang. Ideaal voor applicaties die namens gebruikers handelen met hun toestemming.

OAuth 2.0 / OpenID Connect

JWT-token Authenticatie

Kortlevende JWT-tokens voor staatloze authenticatie. Tokens bevatten gebruikersclaims en machtigingen voor fijnmazige toegangscontrole.

argus_auth_token (JWT)

Transport lanes

Integratiemethoden

Kies de integratiemethode die het beste bij uw use case past. We ondersteunen REST, GraphQL, WebSocket en bestandsgebaseerde integraties.

Method

GraphQL API

Onze primaire API-interface. GraphQL stelt u in staat om precies de gegevens op te vragen die u nodig heeft in één verzoek, wat bandbreedte vermindert en prestaties verbetert.

Vraag precies de velden op die u nodig heeft
Real-time abonnementen voor live updates
Sterk getypeerd schema met introspectie

Verken GraphQL-schema

Method

REST API

Traditionele RESTful-eindpunten voor eenvoudige CRUD-operaties en compatibiliteit met bestaande tooling.

Standaard HTTP-methoden (GET, POST, PUT, DELETE)
JSON verzoek- en antwoordlichamen
OpenAPI 3.0 specificatie beschikbaar

Bekijk REST-eindpunten

Method

WebSocket / Real-time

Persistente verbindingen voor real-time datastreaming. Ontvang directe notificaties wanneer gegevens veranderen.

Lage-latentie push-notificaties
Alarmstreaming en gebeurtenisabonnementen
Automatische herverbindingsafhandeling

WebSocket-documentatie

Method

Bestandsimport / -export

Bulk data-operaties via bestandsuploads en geplande exports. Ondersteunt meerdere formaten waaronder CSV, Excel en XML.

CSV, XLSX, XML, JSON formaten
STIX 2.1 dreigingsinformatieformaat
Geautomatiseerde geplande imports

Dataformaten & Taxonomie

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

Het begrijpen van ons datamodel is essentieel voor succesvolle integratie. Public Safety gebruikt een gestandaardiseerde taxonomie voor entiteiten, relaties en gebeurtenissen.

Kern-entiteittypes

Supported entity model

Public Safety ondersteunt een uitgebreide set entiteittypes voor wetshandhavings- en inlichtingenoperaties. Elk entiteittype heeft specifieke attributen, identificatoren en relatiemogelijkheden.

Person

Organization

Vehicle

Location

Document

Phone

Social Account

IP Address

Cryptocurrency

Domain

Event

Format family

API-formaten

Structured transport for direct client and service integrations.

JSON (application/json)
GraphQL
Multipart form-data

Format family

Importformaten

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

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

Format family

Bestandsbijlagen

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

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

Voorbeeld Entiteitsschema

Sample entity payload

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

Persoon Entiteit (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.

Kant-en-klare Connectoren

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

Public Safety bevat kant-en-klare connectoren voor veelvoorkomende wetshandhavingssystemen, OSINT-providers en systeemplatforms. Aangepaste connectoren kunnen worden ontwikkeld voor extra systemen.

Operational systems

Wetshandhavingssystemen

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

CAD Systems

Beschikbaar

RMS Platforms

Beschikbaar

Evidence.com

Beschikbaar

NCIC/NLETS

Beschikbaar

CJIS

Beschikbaar

NIBRS

Beschikbaar

External intelligence

Inlichtingen- & OSINT-providers

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

TLOxp

Partner

LexisNexis

Partner

Babel Street

Partner

Recorded Future

Partner

VirusTotal

Beschikbaar

Shodan

Beschikbaar

Enterprise systems

Bedrijfssystemen

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

Microsoft 365 / Entra ID

Beschikbaar

Google Workspace

Beschikbaar

Salesforce

Beschikbaar

ServiceNow

Beschikbaar

Slack

Beschikbaar

AWS S3

Beschikbaar

Aangepaste connector nodig?

Custom connector boundary

Ons integratieteam kan aangepaste connectoren bouwen voor uw eigen systemen. Neem contact met ons op om uw vereisten te bespreken.

SDK's & Clientbibliotheken

Choose the client lane that matches the team running the workflow

Officiële SDK's vereenvoudigen integratie met type-safe interfaces, automatische herhalingslogica en ingebouwde authenticatie-afhandeling.

Client

JavaScript / TypeScript

Volledige SDK voor Node.js en browseromgevingen met TypeScript-ondersteuning.

Node.js 18+
Browser ESM
TypeScript types

Client

Python

Pythonic SDK met async-ondersteuning voor data science en automatiseringsworkflows.

Python 3.10+
Async support
Type hints

Client

Java / Kotlin

Enterprise-grade SDK voor Java- en Kotlin-applicaties met Android-ondersteuning.

Java 17+
Kotlin coroutines
Android compatible

Client

C# / .NET

Moderne .NET SDK met async/await-patronen voor Windows en cross-platform apps.

.NET 6+
Async/await
NuGet package

Client

Go

Lichtgewicht Go-client met contextondersteuning voor high-performance services.

Go 1.21+
Context support
Zero dependencies

Client

REST / cURL

Directe REST API-toegang met OpenAPI-spec, Postman-collectie en interactieve documentatie.

OpenAPI 3.0 spec
Postman collection
Interactive docs

SDK Gebruiksvoorbeeld (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.

SDK Gebruiksvoorbeeld (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 & Gebeurtenismeldingen

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

Webhooks stellen Public Safety in staat om real-time meldingen naar uw systemen te pushen wanneer gebeurtenissen plaatsvinden. Configureer webhook-eindpunten om waarschuwingen, statuswijzigingen en data-updates te ontvangen.

Beschikbare Gebeurtenissen

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

Webhook-beveiliging

Webhook control requirements

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

HMAC-SHA256 handtekeningverificatie voor payload-authenticiteit
Automatische herhaling met exponentiële back-off voor mislukte leveringen
IP-allowlisting voor webhook-eindpunten beschikbaar
Idempotentiesleutels om dubbele verwerking te voorkomen

Webhook Payload & Verificatie

Event payload shape

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

Webhook Payload & Verificatie

{
  "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.

Beveiligingsvereisten

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

Alle integraties moeten voldoen aan onze beveiligingsvereisten om gevoelige wetshandhavingsgegevens te beschermen. We handhaven strikte normen voor authenticatie, encryptie en toegangscontrole.

Technische Vereisten

Baseline security requirements

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

TLS 1.2 of hoger vereist voor alle verbindingen
Authenticatie vereist voor alle API-verzoeken
AES-256 encryptie voor data in rust
Volledige audit-logging van alle API-toegang
Handhaving van op rollen gebaseerde toegangscontrole (RBAC)

Nalevingscertificeringen

Compliance lanes

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

BIO-conform (Baseline Informatiebeveiliging Overheid)
BSI C5 geautoriseerd
SOC 2 Type II gecertificeerd
ISO 27001 gecertificeerd
AVG-conform voor EU-data

Testen & Sandbox-omgeving

Testing and certification

Test uw integratie in onze sandbox-omgeving voordat u live gaat. De sandbox biedt realistische testdata en volledige API-functionaliteit zonder productiesystemen te beïnvloeden.

Sandbox-omgeving

Volledige sandbox-omgeving met realistische testdata. Test alle API-operaties zonder productiedata te beïnvloeden.

Testdatasets

Vooraf ingevulde testdatasets inclusief voorbeeldentiteiten, relaties en waarschuwingen voor uitgebreid testen.

Integratiecertificering

Voltooi ons certificeringsproces om een officiële Public Safety-integratiepartner te worden met vermelding op de marktplaats.

Integratietestproces

1Vraag sandbox-toegang aan via het partnerportaal
2Ontwikkel en test uw integratie tegen de sandbox-API
3Dien uw integratie in voor beoordeling door ons team
4Voltooi beveiligingsbeoordeling en penetratietesten
5Ontvang certificering en implementeer naar productie

Word een Integratiepartner

Vendor and partner intake

Geïnteresseerd in integratie met Public Safety Command Center? Vul het onderstaande formulier in en ons partnerschapsteam neemt contact op om de vervolgstappen te bespreken.

Verzoek tot Leveranciersintegratie

Vertel ons over uw integratiebehoeften en we nemen binnen 2-3 werkdagen contact met u op.

Klaar om te Integreren?

Neem contact op met ons integratieteam om uw vereisten te bespreken en toegang te krijgen tot onze sandbox-omgeving.

Contacteer Integratieteam Bekijk API-referentie

Integratiegids

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

API-eindpunten

GraphQL-ondersteuning

Real-time Streaming

Inkomende Integraties

Uitgaande Integraties

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

API-referenties Verkrijgen

De SDK Installeren

Authenticatie Configureren

Uw Eerste API-aanroep Maken

Token acquisition check

Authentication baseline

Integratiemethoden

GraphQL API

REST API

WebSocket / Real-time

Bestandsimport / -export

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

Supported entity model

API-formaten

Importformaten

Bestandsbijlagen

Sample entity payload

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

Wetshandhavingssystemen

Inlichtingen- & OSINT-providers

Bedrijfssystemen

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

Verzoek tot Leveranciersintegratie

Klaar om te Integreren?