API Docs

API Referentie

Volledige documentatie voor alle Argus API's inclusief GraphQL, REST en WebSocket-eindpunten. Alle eindpunten vereisen een geldig argus_auth_token om gegevens te retourneren.

API Overzicht

Argus Command Center biedt twee primaire API-services met meer dan 200 REST-eindpunten en 180+ GraphQL-bewerkingen. Alle geauthenticeerde eindpunten vereisen een geldig argus_auth_token verkregen via de Auth Service.

Auth Service

auth.knogin.com

Verwerkt alle authenticatie, gebruikersbeheer, MFA, SSO, API-sleutels, rollen, machtigingen en sessiebeheer. Hier verkrijgt u tokens voor toegang tot de API Service.

  • 80+ Eindpunten
  • OAuth2/OIDC
  • TOTP/Passkey/Stem MFA

API Service

api.knogin.com

De kern van het inlichtingenplatform-API met REST-eindpunten en GraphQL voor onderzoeken, dossiers, profielen, bewijs, waarschuwingen, monitors, AI-services en realtime communicatie.

  • 130+ REST-eindpunten
  • 180+ GraphQL-bewerkingen
  • WebSocket

Basis-URL's

Auth Service (Productie)https://auth.knogin.com
API Service (Productie)https://api.knogin.com
Auth Service (Staging)https://auth-staging.knogin.com
API Service (Staging)https://api-staging.knogin.com

Authenticatie

Alle geauthenticeerde API-verzoeken vereisen een geldig argus_auth_token. Tokens worden verkregen via de Auth Service en moeten worden opgenomen in alle daaropvolgende verzoeken aan beide services. API-sleutels kunnen worden gegenereerd in het Auth Service-dashboard onder uw gebruikersprofiel voor programmatische toegang.

HTTP-Only Cookie (Aanbevolen voor browsers)

Na succesvol inloggen worden cookies automatisch ingesteld:

Cookies ingesteld na inloggen
platform_access_token=eyJhbGc...  # Short-lived access token
knogin_refresh_token=eyJhbGc...   # Long-lived refresh token

Bearer Token (Voor programmatische toegang)

Neem het token op in de Authorization-header:

Authorization Header
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Een Token Verkrijgen

Voorbeeld: Inloggen met referenties (Auth Service)
# Using username/password (OAuth2 form)
curl -X POST https://auth.knogin.com/v1/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "username=user@example.com&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": "argus"}'

# Response
{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "bearer",
  "expires_in": 3600
}

Auth Service-eindpunten

De Auth Service (auth.knogin.com) verwerkt alle authenticatie, autorisatie, gebruikersbeheer, MFA, SSO, API-sleutels, rollen, machtigingen, feature flags en multi-tenantbeheer. Het bevat 80+ eindpunten georganiseerd op functionaliteit.

Token- & Sessiebeheer

Kernauthenticatie-eindpunten voor het verkrijgen, vernieuwen en beheren van toegangstokens en sessies.

POST
/v1/token

Inloggen met Referenties (OAuth2 Formulier)

OAuth2-compatibel inlogeindpunt dat formulier-gecodeerde e-mail en wachtwoord accepteert. Geeft platformspecifieke toegangstokens uit en stelt HTTP-only cookies in (platform_access_token, knogin_refresh_token) voor browsersessies. Als MFA is ingeschakeld, wordt in plaats daarvan een challenge-cookie geretourneerd die verificatie vereist via /v1/mfa/verify-login. Ondersteunt redirect_uri voor navigatie na inloggen.

Publiek5/min
POST
/v1/auth/token

Inloggen met API-sleutel

Authenticeer met een API-sleutel om een platformspecifiek JWT-token te ontvangen. Ideaal voor service-naar-service authenticatie, CI/CD-pipelines en programmatische toegang. API-sleutels kunnen worden gegenereerd in het Auth Service-dashboard onder uw gebruikersprofiel. De verzoekbody vereist de velden api_key en platform.

Publiek
POST
/v1/auth/refresh

Toegangstoken Vernieuwen

Vernieuw verlopen toegangstokens met behulp van de knogin_refresh_token cookie. Retourneert nieuwe toegangstoken-cookies zonder herauthenticatie te vereisen. Ondersteunt optionele platform-padparameter voor platformspecifieke tokenvernieuwing. Essentieel voor het onderhouden van langdurige sessies in browsertoepassingen.

Publiek
POST
/v1/auth/logout

Uitloggen & Sessie Beëindigen

Beëindigt de huidige gebruikerssessie door alle tokens ongeldig te maken en authenticatiecookies te verwijderen. Verwijdert de sessie uit de server-side sessieopslag. Ondersteunt optionele platform-padparameter. Retourneert 204 No Content bij succes.

Authenticatie Vereist
POST
/v1/auth/revoke-user-sessions/{user_id}

Alle Gebruikerssessies Intrekken (Beheerder)

Beëindigt geforceerd alle actieve sessies voor een specifieke gebruiker op alle apparaten en platforms. Gebruikt bij beveiligingsincidenten of wanneer de toegang van een gebruiker onmiddellijk moet worden ingetrokken. Retourneert het aantal ingetrokken sessies. Vereist beheerder- of superuser-rol.

Beheerder/Superuser

Gebruikersprofiel & Zelfbediening

Eindpunten voor gebruikers om hun eigen profielen te beheren, hun informatie te bekijken en hun instellingen bij te werken.

GET
/v1/users/me

Huidig Gebruikersprofiel Ophalen

Retourneert het volledige profiel van de huidige geauthenticeerde gebruiker, inclusief e-mail, weergavenaam, organisatie, rollen, machtigingen, MFA-status, aanmaakdatum en tijdstip van laatste inlog. Gebruikt door frontend-applicaties om gebruikersdashboards te vullen en machtigingen te controleren.

Authenticatie Vereist
PUT
/v1/users/me

Eigen Profiel Bijwerken

Stelt gebruikers in staat hun eigen profielinformatie bij te werken, inclusief weergavenaam, telefoonnummer en wachtwoord. Als het wachtwoord wordt gewijzigd, worden alle andere sessies automatisch beëindigd voor de veiligheid. Vereist verificatie van het huidige wachtwoord voor gevoelige wijzigingen.

Authenticatie Vereist
GET
/v1/auth/me

Profiel met Feature Flags Ophalen

Retourneert het huidige gebruikersprofiel samen met geëvalueerde feature flags voor de tenant van de gebruiker en eventuele gebruikersspecifieke overschrijvingen. Gebruikt door frontend-applicaties om te bepalen welke functies worden weergegeven op basis van het abonnementsniveau en ingeschakelde experimenten.

Authenticatie Vereist
POST
/v1/users/create

Zelfregistratie

Publiek eindpunt voor nieuwe gebruikers om een account aan te maken. Accepteert e-mail en wachtwoord, maakt de gebruiker aan in het systeem en verstuurt een verificatie-e-mail. Beperkt tot 2 verzoeken per uur per IP om misbruik te voorkomen. Retourneert het aangemaakte gebruikersobject.

Publiek2/hour

Multi-Factor Authenticatie (MFA)

Uitgebreide MFA-ondersteuning inclusief TOTP (authenticator-apps), WebAuthn passkeys en stemverificatie. Gebruikers kunnen meerdere methoden inschakelen voor gelaagde beveiliging.

TOTP (Authenticator-apps)

POST
/v1/portal/mfa/totp/enable

TOTP Inschakelen - Geheim Genereren

Genereert een nieuw TOTP-geheim en retourneert dit samen met een QR-codeafbeelding (base64-gecodeerd) om te scannen met authenticator-apps zoals Google Authenticator, Authy of 1Password. Het geheim wordt opgeslagen in een wachtende status totdat het geverifieerd is.

Authenticatie Vereist
POST
/v1/portal/mfa/totp/verify-and-activate

TOTP Verifiëren en Activeren

Verifieert een TOTP-code van de authenticator-app van de gebruiker en activeert TOTP MFA voor hun account. Vereist de 6-cijferige code van de authenticator-app. Na activering wordt TOTP vereist voor alle toekomstige inlogpogingen.

Authenticatie Vereist
POST
/v1/portal/mfa/totp/disable

TOTP Uitschakelen

Schakelt TOTP-gebaseerde MFA uit voor de huidige gebruiker. Alle actieve sessies worden beëindigd voor de veiligheid na uitschakeling. De gebruiker moet een andere MFA-methode ingeschakeld hebben of MFA mag niet vereist zijn door het organisatiebeleid.

Authenticatie Vereist
POST
/v1/mfa/verify-login

MFA Verifiëren Tijdens Inloggen

Valideert de MFA-code (TOTP) tijdens de inlog-challengeflow. Wordt aangeroepen na de initiële inlog wanneer MFA vereist is. Vereist de TF_AUTH challenge-cookie en de 6-cijferige TOTP-code. Bij succes worden volledige toegangstokens uitgegeven.

Publiek5/min

WebAuthn Passkeys

POST
/v1/portal/mfa/passkey/generate-registration

Passkey-registratieopties Genereren

Genereert WebAuthn-registratieopties voor het aanmaken van een nieuwe passkey-referentie. Retourneert challenge, relying party-informatie en ondersteunde algoritmen. Gebruikt door de WebAuthn API van de browser (navigator.credentials.create) om een nieuwe passkey aan te maken.

Authenticatie Vereist
POST
/v1/portal/mfa/passkey/verify-registration

Passkey Verifiëren en Opslaan

Verifieert de WebAuthn-attestatierespons van de browser en slaat de nieuwe passkey-referentie op. Slaat de publieke sleutel, referentie-ID en metadata op. Gebruikers kunnen meerdere passkeys registreren voor verschillende apparaten.

Authenticatie Vereist
DELETE
/v1/portal/mfa/passkey/{credential_id}

Passkey Verwijderen

Verwijdert een specifieke passkey-referentie op basis van ID. Gebruikers kunnen hun geregistreerde passkeys beheren en oude of gecompromitteerde apparaten verwijderen. Retourneert 204 No Content bij succes.

Authenticatie Vereist
POST
/v1/portal/mfa/passkey/generate-authentication

Passkey-inlogopties Genereren

Genereert WebAuthn-authenticatieopties voor passkey-gebaseerd inloggen. Accepteert e-mailadres en retourneert challenge met toegestane referenties. Gebruikt door navigator.credentials.get voor het initiëren van wachtwoordloos inloggen.

Publiek
POST
/v1/portal/mfa/passkey/verify-authentication

Passkey Verifiëren en Inloggen

Verifieert de WebAuthn-assertierespons en voltooit het passkey-gebaseerde inloggen. Bij succesvolle verificatie worden volledige toegangstokens en cookies uitgegeven. Ondersteunt redirect_uri voor navigatie na inloggen.

Publiek

Stemverificatie

POST
/v1/portal/mfa/voice/enroll

Stemprofiel Registreren

Registreert een stemvoorbeeld voor stemgebaseerde MFA. Accepteert base64-gecodeerde audiodata van de gebruiker die een wachtwoord uitspreekt. De stemafdruk wordt verwerkt en opgeslagen voor toekomstige verificatie. Vereist meerdere voorbeelden voor nauwkeurige registratie.

Authenticatie Vereist
POST
/v1/portal/mfa/voice/verify

Stemvoorbeeld Verifiëren

Verifieert een stemvoorbeeld tegen het geregistreerde stemprofiel tijdens MFA-challenge. Accepteert base64-gecodeerde audio en retourneert een overeenkomstscore. Vereist MFA-challenge-cookie. Gebruikt als alternatief voor TOTP voor gebruikers die de voorkeur geven aan stemauthenticatie.

Publiek5/min
DELETE
/v1/portal/mfa/voice

Stem-MFA Uitschakelen

Schakelt stemgebaseerde MFA uit en verwijdert het opgeslagen stemprofiel. Retourneert 204 No Content bij succes. De gebruiker moet een andere MFA-methode ingeschakeld hebben als MFA vereist is door het organisatiebeleid.

Authenticatie Vereist
GET
/v1/portal/mfa/challenge-info

Beschikbare MFA-methoden Ophalen

Retourneert informatie over welke MFA-methoden beschikbaar zijn voor de lopende inlog-challenge. Respons bevat totp_enabled, voice_enabled en passkey_enabled vlaggen. Gebruikt door de inlog-UI om de juiste MFA-opties weer te geven.

Publiek

Single Sign-On (SSO)

OAuth2/OIDC-gebaseerde single sign-on integratie met enterprise identity providers inclusief Google Workspace en Microsoft Entra ID (Azure AD).

GET
/v1/portal/sso/available-providers

Beschikbare SSO-providers Weergeven

Retourneert een lijst van SSO-providers die zijn geconfigureerd voor de huidige tenant. Respons bevat providernamen en aantal. Gebruikt door de inlog-UI om beschikbare SSO-inlogknoppen weer te geven (bijv. 'Inloggen met Google', 'Inloggen met Microsoft').

Publiek
GET
/v1/portal/login/{provider}

SSO-inlog Initiëren

Initieert de OAuth2/OIDC-autorisatieflow met de opgegeven identity provider. Stuurt de gebruiker door naar de inlogpagina van de provider (Google, Microsoft). Accepteert redirect_uri voor navigatie na inloggen.

Publiek
GET
/v1/portal/auth/{provider}

SSO Callback-handler

OAuth2/OIDC callback-eindpunt dat de autorisatiecode verwerkt die door de identity provider wordt geretourneerd. Wisselt code om voor tokens, maakt of werkt het gebruikersaccount bij, en start een sessie met cookies.

Publiek

API-sleutelbeheer

Maak en beheer API-sleutels voor programmatische toegang. API-sleutels kunnen worden gekoppeld aan specifieke platforms en hebben configureerbare verloopdatums.

POST
/v1/portal/users/me/keys

API-sleutel Aanmaken

Maakt een nieuwe API-sleutel aan voor programmatische toegang. De volledige sleutel wordt slechts eenmaal geretourneerd bij aanmaak - sla deze veilig op. Ondersteunt platformkoppeling en optionele vervaldatum. Retourneert sleutelprefix ter identificatie.

Authenticatie Vereist
GET
/v1/portal/users/me/keys

API-sleutels Weergeven

Retourneert alle API-sleutels voor de huidige gebruiker. Toont sleutelprefix, aanmaakdatum, datum van laatste gebruik en gekoppelde platforms. Retourneert niet de volledige sleutelwaarde voor de veiligheid.

Authenticatie Vereist
DELETE
/v1/portal/users/me/keys/{key_id}

API-sleutel Intrekken

Trekt een API-sleutel permanent in, waardoor alle tokens die met deze sleutel zijn uitgegeven onmiddellijk ongeldig worden. Alle applicaties die deze sleutel gebruiken verliezen onmiddellijk toegang. Kan niet ongedaan worden gemaakt.

Authenticatie Vereist

Gebruikersbeheer (Beheerder)

Beheerderseindpunten voor het beheren van gebruikers, rollen en machtigingen. Toegang varieert op basis van rolhiërarchie.

GET
/v1/portal/admin/users

Gebruikers Weergeven

Retourneert alle gebruikers op basis van de rol van de aanvrager. Managers zien alleen gebruikers in hun organisatie. Superusers zien alle gebruikers in alle organisaties. Ondersteunt paginering en filtering op rol, status en organisatie.

Beheerder/Manager
POST
/v1/portal/admin/users

Gebruiker Aanmaken

Maakt een nieuwe gebruiker aan met opgegeven e-mail, wachtwoord, rollen en organisatietoewijzing. Verstuurt optioneel een welkomst-e-mail. Kan initiële platformtoegang en beveiligingsklaringsniveau toewijzen. Alleen superuser.

Beheerder/Superuser
GET
/v1/portal/admin/users/{user_id}

Gebruiker op ID Ophalen

Retourneert gedetailleerde gebruikersinformatie inclusief profiel, rollen, machtigingen, MFA-status en activiteitengeschiedenis. Managers kunnen alleen gebruikers in hun organisatie bekijken.

Beheerder/Manager
PUT
/v1/portal/admin/users/{user_id}

Gebruiker Bijwerken

Werkt gebruikersgegevens bij inclusief rollen, machtigingen, platformtoegang en beveiligingsklaring. Kan gebruikers activeren/deactiveren. Rolwijzigingen worden van kracht bij de volgende tokenvernieuwing. Alleen superuser voor cross-organisatiewijzigingen.

Beheerder/Superuser
DELETE
/v1/portal/admin/users/{user_id}

Gebruiker Verwijderen

Verwijdert permanent een gebruikersaccount en alle bijbehorende gegevens inclusief API-sleutels en sessies. Deze actie is onomkeerbaar. Alleen superuser. Verwijderde gebruikers kunnen niet worden hersteld.

Beheerder/Superuser
PATCH
/v1/users/{user_id}/permissions

Gebruikersmachtigingen Bijwerken

Werkt de gedetailleerde machtigingen van een gebruiker bij, onafhankelijk van hun rolgebaseerde machtigingen. Maakt fijnafstemming van toegangscontrole mogelijk. Alleen beheerder of superuser. Retourneert de bijgewerkte machtigingenset.

Beheerder/Superuser

Rol- & Machtigingenbeheer

Definieer aangepaste rollen en gedetailleerde machtigingen voor fijnmazige toegangscontrole binnen organisaties.

GET
/v1/roles

Beschikbare Rollen Weergeven

Retourneert alle rollen die beschikbaar zijn in het systeem, inclusief ingebouwde rollen (beheerder, manager, analist, lezer) en aangepaste rollen die voor de organisatie zijn gedefinieerd. Bevat machtigingen die aan elke rol zijn gekoppeld.

Publiek
POST
/v1/roles

Aangepaste Rol Aanmaken

Maakt een nieuwe aangepaste rol aan met opgegeven machtigingen. Aangepaste rollen breiden de ingebouwde rolhiërarchie uit. Alleen superuser. Rolnamen moeten uniek zijn binnen de organisatie.

Beheerder/Superuser
PUT
/v1/roles/{role_id}

Rol Bijwerken

Werkt de naam, beschrijving of machtigingen van een aangepaste rol bij. Wijzigingen hebben invloed op alle gebruikers met deze rol bij hun volgende tokenvernieuwing. Kan ingebouwde rollen niet wijzigen. Alleen superuser.

Beheerder/Superuser
DELETE
/v1/roles/{role_id}

Aangepaste Rol Verwijderen

Verwijdert een aangepaste rol. Gebruikers met deze rol verliezen de bijbehorende machtigingen. Kan geen rollen verwijderen die momenteel aan gebruikers zijn toegewezen. Kan geen ingebouwde rollen verwijderen. Alleen superuser.

Beheerder/Superuser

Feature Flags

Beheer de beschikbaarheid van functies op tenant- en gebruikersniveau voor geleidelijke uitrol en A/B-testen.

GET
/v1/feature-flags/tenant

Tenant Feature Flags Ophalen

Retourneert alle feature flags en hun waarden voor de huidige tenant. Dit zijn de basisvlaggen die van toepassing zijn op alle gebruikers in de organisatie, tenzij overschreven op gebruikersniveau.

Beheerder/Manager
PUT
/v1/feature-flags/tenant

Tenant Feature Flags Bijwerken

Werkt feature flags bij voor de tenant. Wijzigingen zijn van toepassing op alle gebruikers in de organisatie, tenzij zij overschrijvingen op gebruikersniveau hebben. Gebruikt om functies in of uit te schakelen voor de gehele organisatie.

Beheerder/Manager
GET
/v1/feature-flags/user/{user_id}

Gebruiker Feature Flag-overschrijvingen Ophalen

Retourneert gebruikersspecifieke feature flag-overschrijvingen. Deze overschrijven tenant-niveau vlaggen voor individuele gebruikers. Gebruikt voor bètatests met specifieke gebruikers of het aanbieden van premium functies aan geselecteerde accounts.

Beheerder/Manager
PUT
/v1/feature-flags/user/{user_id}

Gebruiker Feature Flag-overschrijvingen Bijwerken

Stelt gebruikersspecifieke feature flag-overschrijvingen in. Overschrijvingen kunnen alleen een subset zijn van organisatievlaggen - kan geen vlaggen inschakelen die niet beschikbaar zijn voor de tenant. Retourneert bijgewerkte gebruikersvlaggen.

Beheerder/Manager

Multi-Tenant & Systeemintegratorbeheer

Beheer de multi-tenanthiërarchie inclusief systeemintegratoren (SI) die Argus-implementaties doorverkopen en beheren voor hun klanten.

POST
/v1/systems-integrators

Systeemintegrator Aanmaken

Maakt een nieuwe systeemintegratororganisatie aan die meerdere klanttenants kan beheren. Alleen Knogin-beheerder. SI ontvangt een eigen beheerportaal en kan klantimplementaties aanmaken en beheren.

Knogin Beheerder
GET
/v1/systems-integrators

Systeemintegratoren Weergeven

Retourneert alle systeemintegratoren in het platform. Alleen Knogin-beheerder. Bevat metadata zoals klantenantal, abonnementsniveau en contactinformatie.

Knogin Beheerder
GET
/v1/systems-integrators/{si_id}

Systeemintegratordetails Ophalen

Retourneert gedetailleerde informatie over een specifieke systeemintegrator, inclusief hun klanten, gebruiksstatistieken en configuratie. SI-beheerders hebben alleen toegang tot hun eigen SI.

SI Beheerder
GET
/v1/systems-integrators/{si_id}/customers

SI-klanten Weergeven

Retourneert alle klanttenants die worden beheerd door een systeemintegrator. SI-beheerders kunnen alleen hun eigen klanten bekijken. Bevat tenantstatus, gebruikersaantal en functie-enablement.

SI Beheerder
POST
/v1/systems-integrators/{si_id}/customers

Klanttenant Aanmaken

Maakt een nieuwe klanttenant aan onder een systeemintegrator. De SI wordt de beherende entiteit voor facturering en ondersteuning. Configureert initiële functies op basis van het abonnementsniveau van de SI.

SI Beheerder
GET
/v1/tenants/{tenant_id}

Tenantdetails Ophalen

Retourneert gedetailleerde informatie over een specifieke tenant, inclusief configuratie, functies, gebruiksquota en factureringsstatus. SI-beheerders hebben alleen toegang tot tenants die zij beheren.

SI Beheerder
PUT
/v1/tenants/{tenant_id}

Tenant Bijwerken

Werkt tenantconfiguratie bij inclusief naam, functies, quota en metadata. Gebruikt om functies in of uit te schakelen of resourcelimieten voor een klant aan te passen.

SI Beheerder
DELETE
/v1/tenants/{tenant_id}

Tenant Verwijderen/Archiveren

Archiveert of verwijdert een tenant en alle bijbehorende gegevens. Alleen Knogin-beheerder. Gegevens worden 30 dagen bewaard voor permanente verwijdering. Gebruikt wanneer een klant opzegt of tijdens opschoning.

Knogin Beheerder

Hulpprogramma's & Configuratie

Beheerconfiguratie- en hulpprogramma-eindpunten.

GET
/v1/portal/admin/config

Beheerdersconfiguratie Ophalen

Retourneert configuratiegegevens voor de beheerders-UI, inclusief beschikbare rollen, machtigingencatalogus, landenlijst, ondersteunde platforms en functiebeschikbaarheid. Gebruikt om dropdownmenu's en formulieren in het beheerdashboard te vullen.

Beheerder/Manager
GET
/v1/portal/data/countries

Landenlijst Ophalen

Retourneert een lijst van alle landen met hun regio's/provincies voor adresformulieren. Bevat ISO-codes, namen en onderverdelingen. Publiek eindpunt gebruikt door registratie- en profielformulieren.

Publiek
GET
/health

Gezondheidscontrole

Eenvoudig gezondheidscontrole-eindpunt dat de servicestatus retourneert. Gebruikt door load balancers en monitoringsystemen. Retourneert status: healthy, service: auth_service.

Publiek
GET
/v1/platforms/supported

Ondersteunde Platforms Weergeven

Retourneert de lijst van platforms die kunnen worden opgegeven bij het uitgeven van tokens. Platforms vertegenwoordigen verschillende Argus-producten/-modules waartoe een gebruiker toegang kan hebben. Opgehaald uit Firestore-configuratie.

Publiek
GET
/audit/logs

Auditlogs Ophalen

Retourneert beveiligingsauditlogs voor de authenticatieservice. Bevat inlogpogingen, machtigingswijzigingen en beheeracties. Beheerder met auditmachtiging vereist.

Beheerder

API Service-eindpunten

De API Service (api.knogin.com) is het kerninlichtingenplatform met 130+ REST-eindpunten voor onderzoeken, dossiers, profielen, bewijs, waarschuwingen, AI-services, realtime communicatie en meer. Alle eindpunten vereisen authenticatie tenzij gemarkeerd als publiek.

Gezondheid & Systeemmogelijkheden

Eindpunten voor systeemgezondheidsmonitoring en mogelijkheidontdekking voor integratie en monitoring.

GET
/api/v1/health

Uitgebreide Gezondheidscontrole

Retourneert gedetailleerde gezondheidsstatus van alle systeemcomponenten, inclusief Neo4j-grafdatabase, PostgreSQL relationele database, Redis-cache, AI-services (OpenAI, Anthropic, Google AI) en externe integraties. Respons bevat latentiestatistieken en verbindingsstatus voor elke component. Gebruikt voor operationele monitoring en incidentrespons.

Publiek
GET
/api/v1/health/simple

Eenvoudige Gezondheidscontrole

Lichtgewicht gezondheidscontrole die een minimale respons retourneert voor load balancers en orkestratiesystemen (Kubernetes, Cloud Run). Retourneert 200 OK als de service draait. Controleert geen downstream-afhankelijkheden voor snellere responstijd.

Publiek
GET
/api/v1/health/db-check

Databaseconnectiviteitscontrole

Verifieert connectiviteit met alle databasesystemen (Neo4j, PostgreSQL, Firestore). Retourneert individuele status voor elke database. Gebruikt voor implementatieverificatie en het oplossen van connectiviteitsproblemen.

Publiek
GET
/api/v1/health/connectivity

Externe Serviceconnectiviteit

Controleert connectiviteit met alle externe services, inclusief AI-providers, OSINT-gegevensbronnen, opslagsystemen en meldingsservices. Retourneert gedetailleerde status voor elk integratiepunt.

Publiek
GET
/api/v1/capabilities

Systeemmogelijkheden

Retourneert uitgebreide systeemmogelijkheden voor frontend-configuratie, inclusief ondersteunde domeinen, beschikbare inlichtingenproviders, geaccepteerde bestandsformaten, API-eindpunten, ingeschakelde functies, snelheidslimieten en maximale bestandsgroottes. Essentieel voor dynamische UI-configuratie.

Publiek

Inlichtingenverwerking

AI-gestuurde documentverwerking voor het extraheren van entiteiten, relaties en inlichtingen uit tekst, afbeeldingen, audio en videobestanden.

POST
/api/v1/intelligence/process-text

Tekstdocument Verwerken

Upload en verwerk tekst-, PDF- of DOCX-bestanden voor onderzoek. Gebruikt AI om entiteiten (personen, organisaties, locaties), relaties, gebeurtenissen en belangrijke inlichtingen uit documenten te extraheren. Ondersteunt bestanden tot 50MB. Resultaten worden opgeslagen en gekoppeld aan het onderzoek.

Authenticatie Vereist
POST
/api/v1/intelligence/process-text/base64

Tekstdocument Verwerken (Base64)

Cloudflare-compatibel eindpunt voor het verwerken van base64-gecodeerde documentbestanden. Accepteert JSON-body met file_content, filename en mime_type. Ondersteunt .txt, .pdf en .docx formaten. Ideaal voor serverloze omgevingen.

Authenticatie Vereist
POST
/api/v1/process-image-file

Afbeelding Verwerken

Upload en verwerk afbeeldingen voor AI-gestuurde visuele analyse. Voert OCR-tekstextractie, objectdetectie, gezichtsdetectie, locatie-identificatie en scèneclassificatie uit. Ondersteunt JPEG, PNG, GIF en WebP formaten.

Authenticatie Vereist
POST
/api/v1/process-image-file/base64

Afbeelding Verwerken (Base64)

Cloudflare-compatibel eindpunt voor het verwerken van base64-gecodeerde afbeeldingen. Retourneert geëxtraheerde tekst, gedetecteerde objecten, gezichten en geïdentificeerde locaties. Ideaal voor serverloze omgevingen met beperkingen op de verzoekbodygrootte.

Authenticatie Vereist
POST
/api/v1/process-audio-file

Audio Verwerken

Upload en verwerk audiobestanden voor transcriptie en sprekersidentificatie. Gebruikt geavanceerde spraak-naar-tekst en sprekersdiarisatie. Ondersteunt MP3, WAV, OGG en M4A formaten tot 100MB.

Authenticatie Vereist
POST
/api/v1/process-audio-file/base64

Audio Verwerken (Base64)

Cloudflare-compatibel eindpunt voor het verwerken van base64-gecodeerde audio. Retourneert volledige transcriptie met tijdstempels en sprekerlabels. Let op: grote audiobestanden moeten het directe upload-eindpunt gebruiken.

Authenticatie Vereist
POST
/api/v1/process-video-file

Video Verwerken

Upload en verwerk videobestanden voor uitgebreide analyse. Extraheert audiotranscriptie, detecteert gezichten over frames, identificeert scènes en objecten, en genereert een visuele tijdlijn. Ondersteunt MP4, MOV, AVI, WebM tot 500MB.

Authenticatie Vereist
POST
/api/v1/process-video-file/base64

Video Verwerken (Base64)

Cloudflare-compatibel eindpunt voor het verwerken van base64-gecodeerde video. Beperkt tot kleinere bestanden vanwege coderingsoverhead. Gebruik voor grotere video's presigned URL-upload.

Authenticatie Vereist

Profielbeheer

Maak, werk bij en verrijk entiteitsprofielen met gegevens van inlichtingenproviders. Ondersteunt individuele en batchbewerkingen.

POST
/api/v1/profiles

Profiel Aanmaken

Maakt een nieuw entiteitsprofiel aan (persoon, organisatie, voertuig, enz.). Accepteert initiële gegevens en valideert/normaliseert automatisch velden. Start achtergrondverrijking als auto_enrich is ingeschakeld.

Authenticatie Vereist
GET
/api/v1/profiles/{profile_id}

Profiel Ophalen

Retourneert volledige profielgegevens inclusief alle attributen, gekoppelde entiteiten, tijdlijn en verrijkingsgegevens. Ondersteunt veldselectie voor prestatie-optimalisatie.

Authenticatie Vereist
PUT
/api/v1/profiles/{profile_id}

Profiel Bijwerken

Werkt profielvelden bij. Ondersteunt gedeeltelijke updates. Houdt een audittrail bij van alle wijzigingen. Start herverrijking als kernidentificerende velden worden gewijzigd.

Authenticatie Vereist
DELETE
/api/v1/profiles/{profile_id}

Profiel Verwijderen

Verwijdert een profiel en alle gekoppelde gegevens zacht. Het profiel kan binnen 30 dagen worden hersteld. Wordt permanent verwijderd na de bewaarperiode. De audittrail blijft behouden.

Authenticatie Vereist
POST
/api/v1/profiles/{profile_id}/enrich

Profiel Verrijken

Verrijkt een profiel met gegevens van inlichtingenproviders. Geef optioneel aan welke providers te gebruiken (sociaal, strafrechtelijk, financieel, enz.). Retourneert samengevoegde gegevens inclusief sociale mediapresentie, openbare registers en open-source inlichtingen.

Authenticatie Vereist
POST
/api/v1/batch/profiles

Profielen Batchgewijs Ophalen

Haalt meerdere profielen op basis van ID op in een enkel verzoek. Maximaal 100 profielen per verzoek. Retourneert profielen in dezelfde volgorde als de gevraagde ID's. Ontbrekende profielen retourneren null.

Authenticatie Vereist
POST
/api/v1/batch/enrich

Profielen Batchgewijs Verrijken

Verrijkt meerdere profielen in een enkel verzoek. Maximaal 10 profielen per verzoek om de snelheidslimieten van providers te beheren. Retourneert individuele succes-/foutstatus voor elk profiel.

Authenticatie Vereist
GET
/api/v1/profiles/search

Profielen Zoeken

Full-text zoeken over alle profielvelden. Ondersteunt filters op type, status, datumbereik en aangepaste velden. Retourneert gepagineerde resultaten met relevantiescoring.

Authenticatie Vereist
POST
/api/v1/profiles/link

Profielen Koppelen

Maakt een relatie aan tussen twee profielen (bijv. 'werkt_voor', 'gerelateerd_aan', 'bezit'). Slaat relatiemetadata en bewijs op. Bidirectionele relaties worden automatisch aangemaakt.

Authenticatie Vereist
DELETE
/api/v1/profiles/link

Profielen Ontkoppelen

Verwijdert een relatie tussen twee profielen. Houdt een audittrail bij van de verwijdering. Oorspronkelijke relatiegegevens worden bewaard voor naleving.

Authenticatie Vereist

Onderzoeken & Dossiers

Beheer onderzoeken, dossiers, taken en de volledige onderzoekslevenscyclus.

POST
/api/v1/investigations

Onderzoek Aanmaken

Maakt een nieuwe onderzoekswerkruimte aan met titel, beschrijving en classificatieniveau. Wijst automatisch de maker toe als hoofdonderzoeker. Retourneert onderzoeks-ID voor daaropvolgende bewerkingen.

Authenticatie Vereist
GET
/api/v1/investigations/{investigation_id}

Onderzoek Ophalen

Retourneert volledige onderzoeksdetails inclusief metadata, teamleden, dossiers, profielen, bestanden en activiteitentijdlijn. Ondersteunt veldselectie voor grote onderzoeken.

Authenticatie Vereist
PUT
/api/v1/investigations/{investigation_id}

Onderzoek Bijwerken

Werkt onderzoeksmetadata bij inclusief titel, beschrijving, status en classificatie. Wijzigingen activeren meldingen aan teamleden. Wordt vastgelegd in auditlog.

Authenticatie Vereist
DELETE
/api/v1/investigations/{investigation_id}

Onderzoek Verwijderen

Verwijdert een onderzoek en alle bijbehorende gegevens zacht. Vereist bevestiging voor onderzoeken met actieve dossiers. Gegevens worden bewaard voor de nalevingsperiode.

Authenticatie Vereist
GET
/api/v1/investigations

Onderzoeken Weergeven

Retourneert onderzoeken die toegankelijk zijn voor de huidige gebruiker. Ondersteunt filtering op status, datum, teamlid en zoekopdracht. Gepagineerd met sorteeropties.

Authenticatie Vereist
POST
/api/v1/investigations/{investigation_id}/files

Bestanden aan Onderzoek Toevoegen

Koppelt geüploade bestanden aan een onderzoek. Bestanden worden automatisch in de wachtrij geplaatst voor AI-verwerking op basis van type. Activeert indexering voor zoeken.

Authenticatie Vereist

Waarschuwingen & Monitors

Configureer monitoringregels en beheer waarschuwingen die worden geactiveerd door realtimegegevensstromen.

POST
/api/v1/alerts

Waarschuwing Aanmaken

Maakt programmatisch een waarschuwing aan. Doorgaans worden waarschuwingen aangemaakt door monitors, maar handmatige aanmaak wordt ondersteund voor integraties. Vereist titel, ernst en minimaal één entiteitsreferentie.

Authenticatie Vereist
GET
/api/v1/alerts/{alert_id}

Waarschuwing Ophalen

Retourneert volledige waarschuwingsdetails inclusief triggergegevens, overeenkomende entiteiten, beslissingsgeschiedenis en gekoppelde onderzoeken. Ondersteunt uitbreiding van gerelateerde entiteiten.

Authenticatie Vereist
PUT
/api/v1/alerts/{alert_id}

Waarschuwing Bijwerken

Werkt waarschuwingsmetadata of status bij. Statusovergangen worden gevalideerd (bijv. een afgewezen waarschuwing kan niet opnieuw worden geopend). Alle wijzigingen worden vastgelegd in de auditlog met gebruiker en tijdstempel.

Authenticatie Vereist
POST
/api/v1/alerts/{alert_id}/decide

Waarschuwing Beoordelen

Registreert een beslissing over een waarschuwing: escaleren, onderzoeken, afwijzen of vals positief. Beslissing bevat onderbouwing en optionele entiteitsdispositie. Gesloten waarschuwingen kunnen vervolgworkflows activeren.

Authenticatie Vereist
GET
/api/v1/alerts

Waarschuwingen Weergeven

Retourneert waarschuwingen die voldoen aan filtercriteria. Ondersteunt filtering op ernst, status, monitor, datumbereik en entiteit. Gepagineerd met configureerbare paginagrootte.

Authenticatie Vereist

Waarschuwingen & Monitors

Configureer monitoringregels en beheer waarschuwingen die worden geactiveerd door realtimegegevensstromen.

POST
/api/v1/monitors

Monitor Aanmaken

Maakt een monitoringregel aan die waarschuwingen activeert op basis van gegevensstroompatronen. Ondersteunt complexe voorwaarden met entiteitsmatching, geografische grenzen, temporele patronen en drempelwaarde-triggers.

Authenticatie Vereist
GET
/api/v1/monitors/{monitor_id}

Monitor Ophalen

Retourneert monitorconfiguratie en statistieken inclusief waarschuwingsaantal, laatste triggertijd en prestatiestatistieken. Bevat voorwaardendetails en meldingsinstellingen.

Authenticatie Vereist
PUT
/api/v1/monitors/{monitor_id}

Monitor Bijwerken

Werkt monitorvoorwaarden, drempelwaarden of meldingsinstellingen bij. Wijzigingen worden onmiddellijk van kracht. Het pauzeren van een monitor stopt nieuwe waarschuwingen maar bewaart de geschiedenis.

Authenticatie Vereist
DELETE
/api/v1/monitors/{monitor_id}

Monitor Verwijderen

Verwijdert een monitor permanent. Bijbehorende waarschuwingen worden bewaard maar als verweesd gemarkeerd. Overweeg in plaats daarvan te pauzeren voor behoud van de audittrail.

Authenticatie Vereist
GET
/api/v1/monitors

Monitors Weergeven

Retourneert alle monitors voor de huidige tenant. Ondersteunt filtering op status, type en waarschuwingsactiviteit. Bevat samenvattingsstatistieken voor elke monitor.

Authenticatie Vereist
POST
/api/v1/ai/generate-monitor-spec

Monitor Genereren uit Beschrijving

Gebruikt AI om beschrijvingen in natuurlijke taal om te zetten naar gestructureerde monitorspecificaties. Bevat veiligheidsanalyse, parameterextractie en geschat waarschuwingsvolume. Helpt niet-technische gebruikers complexe monitors te maken.

Authenticatie Vereist

AI-services

Directe toegang tot AI-mogelijkheden inclusief tekstanalyse, entiteitsextractie, relatiemapping en natuurlijke taalverwerking.

POST
/api/v1/ai/analyze-text

Tekst Analyseren met AI

Voert uitgebreide AI-analyse uit op tekstinhoud. Extraheert entiteiten, relaties, gebeurtenissen, sentiment en kernthema's. Ondersteunt meerdere talen met automatische detectie.

Authenticatie Vereist
POST
/api/v1/ai/generate-graph

Graaf Genereren uit Tekst

Maakt een kennisgraaf van ongestructureerde tekst. Identificeert entiteiten, leidt relaties af en genereert gestructureerde grafgegevens die geschikt zijn voor visualisatie of Neo4j-import.

Authenticatie Vereist
POST
/api/v1/ai/summarize

Inhoud Samenvatten

Genereert beknopte samenvattingen van langere inhoud. Ondersteunt meerdere samenvattingslengtes en -stijlen (bestuurlijk, technisch, opsommingen). Behoudt belangrijke entiteiten en feiten.

Authenticatie Vereist
POST
/api/v1/ai/translate

Inhoud Vertalen

Vertaalt inhoud tussen ondersteunde talen met behoud van entiteitsnamen en technische termen. Retourneert zowel de vertaling als de gedetecteerde brontaal.

Authenticatie Vereist
POST
/api/v1/ai/extract-entities

Benoemde Entiteiten Extraheren

Extraheert en classificeert benoemde entiteiten uit tekst. Retourneert entiteitsbereiken, typen, betrouwbaarheidsscores en opgeloste identificatoren waar beschikbaar. Ondersteunt aangepaste entiteitstypen.

Authenticatie Vereist

Bestandsbeheer

Upload, download en beheer bestanden met volledige RBAC-handhaving en auditlogregistratie.

POST
/api/v1/files

Bestand Uploaden

Uploadt een bestand naar beveiligde opslag. Detecteert automatisch het bestandstype en plaatst het in de wachtrij voor de juiste verwerking. Retourneert bestands-ID en verwerkingsstatus. Ondersteunt chunked uploads voor grote bestanden.

Authenticatie Vereist
GET
/api/v1/files/{file_id}/download

Bestand Downloaden

Downloadt een bestand met volledige RBAC-handhaving en auditlogging. Verifieert dat de gebruiker toegang heeft tot het bijbehorende onderzoek/dossier. Ondersteunt range-verzoeken voor grote bestanden. Retourneert het bestand met de juiste content-type headers.

Authenticatie Vereist
GET
/api/v1/files/{file_id}/stream

Bestand Streamen

Streamt een bestand voor progressief laden van grote bestanden. Ondersteunt HTTP range-verzoeken voor het zoeken in audio-/videobestanden. Efficiënter dan volledig downloaden voor grote mediabestanden.

Authenticatie Vereist
GET
/api/v1/files/{file_id}/presigned-url

Presigned URL Ophalen

Genereert een tijdgelimiteerde presigned URL voor directe bestandstoegang vanuit Cloudflare R2-opslag. URL verloopt na configureerbare duur (standaard 1 uur). Nuttig voor het inbedden van bestanden in rapporten of delen met externe tools.

Authenticatie Vereist
GET
/api/v1/admin/files

Alle Bestanden Weergeven (Beheerder)

Retourneert alle bestanden in het systeem met metadata en toegangsstatistieken. Alleen beheerder of superuser. Ondersteunt tenantfiltering voor multi-tenant implementaties. Gebruikt voor opslagbeheer en auditing.

Beheerder/Superuser
GET
/api/v1/admin/files/{file_id}/audit

Bestandsaudittrail (Beheerder)

Retourneert de volledige audittrail voor een specifiek bestand, inclusief alle toegangsgebeurtenissen, downloads en wijzigingen. Alleen beheerder of superuser. Essentieel voor documentatie van de bewijsketen.

Beheerder/Superuser

API-metadata & Documentatie

Zelfbeschrijvende API-eindpunten voor dynamische integratie en documentatie.

GET
/api/v1/docs/endpoints

API-eindpuntdocumentatie

Retourneert uitgebreide documentatie van alle API-eindpunten inclusief paden, methoden, parameters en responsschema's. Gebruikt voor het genereren van client-SDK's en integratiedocumentatie.

Publiek
GET
/api/v1/metadata/domains

Domeinmetadata

Retourneert metadata over alle beschikbare domeinen (entiteitstypen) inclusief hun eigenschappen, relaties en UI-configuratie. Essentieel voor het bouwen van dynamische UI's die zich aanpassen aan schemawijzigingen.

Publiek
GET
/api/v1/metadata/enums

Enumeratiemetadata

Retourneert alle enumeratietypen die in de API worden gebruikt, inclusief statuscodes, prioriteitsniveaus, classificatieniveaus en andere categorische waarden. Gebruikt voor het vullen van dropdownmenu's.

Publiek
GET
/api/v1/metadata/providers

Providermetadata

Retourneert metadata over beschikbare OSINT- en dataproviders inclusief mogelijkheden, snelheidslimieten en vereiste referenties. Gebruikt voor het configureren van gegevensbronvoorkeuren.

Publiek

Audit & Naleving

Cryptografische audittrails met Merkle-treeverificatie voor manipulatiebestendige logregistratie.

GET
/api/v1/audit/anchor/latest

Laatste Merkle-anker Ophalen

Retourneert de meest recente Merkle-tree root hash die de auditlog verankert. Gebruikt voor cryptografische verificatie van logintegriteit. Het anker wordt periodiek gepubliceerd op de blockchain voor onveranderlijkheid.

Publiek
GET
/api/v1/audit/anchor/proof/{entry_id}

Inclusie-bewijs Ophalen

Retourneert een Merkle-inclusie-bewijs voor een specifieke auditvermelding. Het bewijs kan onafhankelijk worden geverifieerd tegen het gepubliceerde anker. Essentieel voor forensische bewijsketenvereisten.

Publiek

Mission Planning

AI-assisted mission planning and operational support.

POST
/api/v1/mission-plans

Missieplan Genereren

AI-ondersteunde missieplanning op basis van scenariobeschrijving, doelprofielen, geografische beperkingen en dreigingsbeoordeling. Retourneert een gestructureerd plan met resource-allocatie, tijdlijn en noodplannen.

Authenticatie Vereist
PUT
/api/v1/mission-plans/{plan_id}

Missieplan Verfijnen

Verfijnt iteratief een bestaand missieplan op basis van nieuwe beperkingen of feedback. Bewaart plangeschiedenis ter vergelijking. Ondersteunt gedeeltelijke updates van specifieke plansecties.

Authenticatie Vereist

Dossierbeheer

Volledig dossierlevenscyclusbeheer met workflow, toewijzingen, sjablonen en tijdlijntracking.

POST
/api/v1/cases

Dossier Aanmaken

Maakt een nieuw dossier aan binnen een onderzoek. Accepteert titel, beschrijving, prioriteit, status en toegewezen gebruiker. Genereert automatisch een uniek dossiernummer en maakt een initiële tijdlijnvermelding aan.

Authenticatie Vereist
GET
/api/v1/cases/{case_id}

Dossier Ophalen

Retourneert volledige dossierdetails inclusief metadata, toegewezen gebruikers, gekoppelde profielen, taken, notities, bijlagen en volledige activiteitentijdlijn. Ondersteunt veldselectie voor prestaties.

Authenticatie Vereist
PUT
/api/v1/cases/{case_id}

Dossier Bijwerken

Werkt dossiermetadata bij inclusief titel, beschrijving, prioriteit, status, vervaldatum en aangepaste velden. Wijzigingen worden vastgelegd in de auditlog met gebruiker en tijdstempel.

Authenticatie Vereist
DELETE
/api/v1/cases/{case_id}

Dossier Verwijderen

Verwijdert een dossier en alle bijbehorende gegevens zacht. Vereist bevestiging voor dossiers met actieve taken. Gegevens worden bewaard voor de nalevingsperiode voor permanente verwijdering.

Authenticatie Vereist
GET
/api/v1/cases

Dossiers Weergeven

Retourneert dossiers met filtering op onderzoek, status, prioriteit, toegewezene, datumbereik en tags. Ondersteunt paginering, sortering en full-text zoeken over dossierinhoud.

Authenticatie Vereist
POST
/api/v1/cases/{case_id}/assign

Dossier Toewijzen

Wijst een dossier toe of wijst het opnieuw toe aan een gebruiker of team. Ondersteunt meerdere toegewezenen met primaire/secundaire aanduiding. Activeert melding aan toegewezen gebruikers.

Authenticatie Vereist
POST
/api/v1/cases/{case_id}/status

Dossierstatus Bijwerken

Werkt dossierstatus bij met workflowvalidatie. Statusovergangen worden gevalideerd op basis van workflowregels. Activeert geautomatiseerde acties op basis van status (bijv. meldingen, takenaanmaak).

Authenticatie Vereist
POST
/api/v1/cases/{case_id}/link-profile

Profiel aan Dossier Koppelen

Koppelt een entiteitsprofiel aan een dossier. Specificeer het relatietype (verdachte, getuige, slachtoffer, enz.) en relevantienotities. Maakt een bidirectionele koppeling aan die zichtbaar is in zowel het dossier als het profiel.

Authenticatie Vereist
DELETE
/api/v1/cases/{case_id}/link-profile/{profile_id}

Profiel van Dossier Ontkoppelen

Verwijdert de associatie tussen een profiel en een dossier. Oorspronkelijke koppelinggegevens worden bewaard in de audittrail voor naleving.

Authenticatie Vereist
GET
/api/v1/cases/{case_id}/timeline

Dossiertijdlijn Ophalen

Retourneert de volledige activiteitentijdlijn voor een dossier, inclusief statuswijzigingen, toewijzingen, profielkoppelingen, taakvoltooiingen en alle wijzigingen met tijdstempels en actoren.

Authenticatie Vereist
POST
/api/v1/cases/bulk-update

Dossiers Bulkgewijs Bijwerken

Werkt meerdere dossiers bij in een enkel verzoek. Ondersteunt het bijwerken van status, prioriteit, toegewezene of tags. Maximaal 100 dossiers per verzoek. Retourneert individueel succes/fout voor elk dossier.

Authenticatie Vereist
POST
/api/v1/cases/from-template

Dossier Aanmaken vanuit Sjabloon

Maakt een nieuw dossier aan met behulp van een vooraf gedefinieerd sjabloon. Sjabloon definieert standaardtaken, checklists, velden en workflowfasen. Accepteert overschrijvingen voor sjabloonwaarden.

Authenticatie Vereist

Takenbeheer

Maak en beheer taken met toewijzingen, checklists, afhankelijkheden en voortgangsregistratie.

POST
/api/v1/tasks

Taak Aanmaken

Maakt een nieuwe taak aan binnen een dossier. Accepteert titel, beschrijving, toegewezene, vervaldatum, prioriteit en optionele checklistitems. Ondersteunt bovenliggende taak voor subtaakhiërarchieën.

Authenticatie Vereist
GET
/api/v1/tasks/{task_id}

Taak Ophalen

Retourneert volledige taakdetails inclusief metadata, checklistitems, subtaken, opmerkingen, bijlagen en tijdregistratie-informatie.

Authenticatie Vereist
PUT
/api/v1/tasks/{task_id}

Taak Bijwerken

Werkt taakvelden bij inclusief titel, beschrijving, vervaldatum, prioriteit en voortgang. Ondersteunt gedeeltelijke updates. Wijzigingen worden vastgelegd in de auditlog.

Authenticatie Vereist
DELETE
/api/v1/tasks/{task_id}

Taak Verwijderen

Verwijdert een taak en optioneel de subtaken. Voltooide taken worden gearchiveerd in plaats van verwijderd. De audittrail blijft behouden.

Authenticatie Vereist
GET
/api/v1/cases/{case_id}/tasks

Taken per Dossier Weergeven

Retourneert alle taken voor een dossier met filtering op status, toegewezene, vervaldatum en prioriteit. Ondersteunt hiërarchische weergave met subtaken genest onder bovenliggende taken.

Authenticatie Vereist
POST
/api/v1/tasks/{task_id}/assign

Taak Toewijzen

Wijst een taak toe of wijst deze opnieuw toe aan een gebruiker. Activeert melding aan de toegewezen gebruiker. Werkt werklastberekeningen bij voor capaciteitsplanning.

Authenticatie Vereist
POST
/api/v1/tasks/{task_id}/complete

Taak Voltooien

Markeert een taak als voltooid met optionele voltooiingsnotities. Valideert dat alle vereiste checklistitems zijn voltooid. Werkt voortgangsstatistieken van het dossier bij.

Authenticatie Vereist
POST
/api/v1/tasks/{task_id}/checklist

Taakchecklist Bijwerken

Werkt checklistitems bij voor een taak. Voeg toe, verwijder of schakel de voltooiingsstatus van individuele items. Ondersteunt herordening van checklistitems.

Authenticatie Vereist
GET
/api/v1/tasks/my-tasks

Mijn Taken Ophalen

Retourneert alle taken die aan de huidige gebruiker zijn toegewezen over alle dossiers. Ondersteunt filtering op status, vervaldatum en prioriteit. Nuttig voor het persoonlijke takendashboard.

Authenticatie Vereist
POST
/api/v1/tasks/bulk-update

Taken Bulkgewijs Bijwerken

Werkt meerdere taken bij in een enkel verzoek. Ondersteunt het bijwerken van status, toegewezene, vervaldatum of prioriteit. Maximaal 50 taken per verzoek.

Authenticatie Vereist

Notities & Documentatie

Onderzoeksnotities met rich text, threading, bijlagen en zichtbaarheidscontroles.

POST
/api/v1/notes

Notitie Aanmaken

Maakt een nieuwe notitie aan gekoppeld aan een dossier of onderzoek. Ondersteunt rich text-inhoud, vermeldingen (@gebruiker) en classificatieniveaus. Indexeert inhoud automatisch voor zoeken.

Authenticatie Vereist
GET
/api/v1/notes/{note_id}

Notitie Ophalen

Retourneert notitie-inhoud met metadata, bijlagen en threadreacties. Respecteert zichtbaarheidsinstellingen (openbaar, team, privé).

Authenticatie Vereist
PUT
/api/v1/notes/{note_id}

Notitie Bijwerken

Werkt notitie-inhoud of metadata bij. Bewaart versiegeschiedenis voor auditnaleving. Alleen de maker of beheerders kunnen vertrouwelijke notities bewerken.

Authenticatie Vereist
DELETE
/api/v1/notes/{note_id}

Notitie Verwijderen

Verwijdert een notitie zacht. Inhoud wordt bewaard voor de nalevingsperiode. Vertrouwelijke notities vereisen beheerdersgoedkeuring voor verwijdering.

Authenticatie Vereist
GET
/api/v1/cases/{case_id}/notes

Notities per Dossier Weergeven

Retourneert alle notities voor een dossier met inachtneming van zichtbaarheidsregels. Ondersteunt filtering op notitietype, auteur en datumbereik. Standaard geordend op aanmaakdatum.

Authenticatie Vereist
POST
/api/v1/notes/{note_id}/attachments

Bijlage aan Notitie Toevoegen

Voegt een bestand als bijlage toe aan een bestaande notitie. Het bestand wordt automatisch verwerkt op basis van type. Handhaaft de bewijsketen voor bewijswaardige bijlagen.

Authenticatie Vereist
POST
/api/v1/notes/{note_id}/reply

Reageren op Notitie

Maakt een geneste reactie op een bestaande notitie. Ondersteunt @vermeldingen om specifieke gebruikers te notificeren. Bewaart de gesprekscontext voor samenwerking.

Authenticatie Vereist

Bijlagen & Bestanden

Beheer bestandsbijlagen met verwerking, bewijsketen en integriteitsverificatie.

POST
/api/v1/attachments

Bijlage Aanmaken

Uploadt en voegt een bestand als bijlage toe aan een dossier, notitie of taak. Detecteert automatisch het bestandstype en plaatst het in de wachtrij voor de juiste AI-verwerking. Berekent integriteitshash voor de bewijsketen.

Authenticatie Vereist
GET
/api/v1/attachments/{attachment_id}

Bijlage Ophalen

Retourneert bijlagemetadata inclusief bestandsinformatie, verwerkingsstatus, geëxtraheerde inhoud en toegangsgeschiedenis. Ondersteunt thumbnail- en preview-URL's voor mediabestanden.

Authenticatie Vereist
DELETE
/api/v1/attachments/{attachment_id}

Bijlage Verwijderen

Verwijdert een bijlage zacht. Het bestand blijft opgeslagen voor de nalevingsperiode. Bewijswaardige bijlagen vereisen een goedkeuringsworkflow voor verwijdering.

Authenticatie Vereist
GET
/api/v1/cases/{case_id}/attachments

Bijlagen per Dossier Weergeven

Retourneert alle bijlagen voor een dossier met filtering op bestandstype, verwerkingsstatus en uploaddatum. Bevat geaggregeerde statistieken (totale grootte, bestandsaantallen per type).

Authenticatie Vereist
POST
/api/v1/attachments/{attachment_id}/process

Bijlage Opnieuw Verwerken

Activeert herverwerking van een bijlage met bijgewerkte AI-modellen of andere verwerkingsopties. Nuttig wanneer nieuwe extractiemogelijkheden beschikbaar worden.

Authenticatie Vereist
GET
/api/v1/attachments/{attachment_id}/chain-of-custody

Bewijsketen van Bijlage Ophalen

Retourneert het volledige bewijsketenlogboek voor een bijlage, inclusief alle toegangsgebeurtenissen, overdrachten en wijzigingen. Essentieel voor juridische toelaatbaarheid.

Authenticatie Vereist

Graafanalyse

Netwerkanalyse, padvinding, centraliteitsmetrieken en gemeenschapsdetectie in de kennisgraaf.

GET
/api/v1/graph/node/{node_id}

Grafknooppunt Ophalen

Retourneert een enkel knooppunt uit de kennisgraaf met alle eigenschappen en labels. Bevat randtellingen en voorbeeldrelaties voor context.

Authenticatie Vereist
GET
/api/v1/graph/node/{node_id}/neighbors

Knooppuntburen Ophalen

Retourneert alle direct verbonden knooppunten binnen opgegeven diepte. Ondersteunt filtering op relatietype en knooppuntlabels. Configureerbare dieptelimiet (max 5) om prestatieproblemen te voorkomen.

Authenticatie Vereist
GET
/api/v1/graph/path

Pad Tussen Knooppunten Vinden

Vindt het kortste pad(en) tussen twee knooppunten met behulp van Dijkstra- of A*-algoritmen. Retourneert padknooppunten, relaties en totaalgewicht. Ondersteunt gewogen randen voor intelligente routering.

Authenticatie Vereist
POST
/api/v1/graph/subgraph

Subgraaf Ophalen

Extraheert een subgraaf rond opgegeven zaadknooppunten. Retourneert knooppunten en randen binnen opgegeven stappen. Nuttig voor gerichte visualisatie van entiteitsomgevingen.

Authenticatie Vereist
POST
/api/v1/graph/query

Aangepaste Cypher-query Uitvoeren

Voert een alleen-lezen Cypher-query uit tegen de grafdatabase. Query wordt gevalideerd en gesandboxed voor beveiliging. Retourneert resultaten in tabel- of grafformaat. Alleen beheerder.

Authenticatie Vereist
GET
/api/v1/graph/statistics

Grafstatistieken Ophalen

Retourneert geaggregeerde statistieken over de kennisgraaf inclusief knooppuntaantallen per label, randaantallen per type en grafdichtheidsmetrieken.

Authenticatie Vereist
POST
/api/v1/graph/centrality

Centraliteit Berekenen

Berekent centraliteitsmetrieken (graad, tussenligging, PageRank) voor opgegeven knooppunten of de gehele graaf. Gebruikt om sleutelentiteiten in een netwerk te identificeren.

Authenticatie Vereist
POST
/api/v1/graph/community-detection

Gemeenschappen Detecteren

Voert gemeenschapsdetectie-algoritmen uit (Louvain, Label Propagation) om clusters van gerelateerde entiteiten te identificeren. Retourneert gemeenschapstoewijzingen en modulariteitsscores.

Authenticatie Vereist
POST
/api/v1/graph/link-prediction

Koppelingen Voorspellen

Gebruikt graf-ML om waarschijnlijke maar niet-waargenomen relaties tussen entiteiten te voorspellen. Retourneert kandidaatkoppelingen met betrouwbaarheidsscores. Nuttig voor onderzoeksaanwijzingen.

Authenticatie Vereist

Geospatiale Inlichtingen

Locatiegebaseerde zoekopdrachten, clustering, heatmaps, routering en geografische tijdlijnanalyse.

POST
/api/v1/geo/search

Geospatiale Zoekopdracht

Zoekt naar entiteiten met locatiegegevens die voldoen aan ruimtelijke criteria. Combineert geografische grenzen met entiteitsfilters (type, datum, tags). Retourneert resultaten met afstand tot referentiepunt.

Authenticatie Vereist
POST
/api/v1/geo/within-bounds

Entiteiten Binnen Grenzen

Retourneert alle entiteiten met locaties binnen een rechthoekig begrenzingsvak gedefinieerd door noordoost- en zuidwestcoördinaten. Geoptimaliseerd voor kaartviewport-queries.

Authenticatie Vereist
POST
/api/v1/geo/within-radius

Entiteiten Binnen Straal

Retourneert alle entiteiten binnen een opgegeven straal van een middelpunt. Afstand berekend met de Haversine-formule. Resultaten bevatten afstand tot het middelpunt.

Authenticatie Vereist
POST
/api/v1/geo/within-polygon

Entiteiten Binnen Polygoon

Retourneert alle entiteiten met locaties binnen een GeoJSON-polygoon. Ondersteunt complexe vormen met gaten. Nuttig voor jurisdictiegebaseerde filtering.

Authenticatie Vereist
GET
/api/v1/geo/clusters

Locatieclusters Ophalen

Retourneert geclusterde locatiegegevens geoptimaliseerd voor kaartweergave op verschillende zoomniveaus. Gebruikt ruimtelijke clusteralgoritmen om nabijgelegen punten samen te voegen.

Authenticatie Vereist
GET
/api/v1/geo/heatmap

Heatmapgegevens Ophalen

Retourneert dichtheidsgegevens voor heatmapvisualisatie. Voegt entiteitslocaties samen in rastercellen met telling en gewogen waarden. Configureerbare rasterresolutie.

Authenticatie Vereist
POST
/api/v1/geo/route

Route Berekenen

Berekent optimale route tussen locaties rekening houdend met werkelijke wegennetwerken. Retourneert polyline-geometrie, afstand, geschatte duur en stap-voor-stap routebeschrijving.

Authenticatie Vereist
GET
/api/v1/geo/timeline/{entity_id}

Locatietijdlijn Ophalen

Retourneert chronologische locatiegeschiedenis voor een entiteit. Toont bewegingspatronen over tijd. Nuttig voor opsporingsonderzoeken en patroonanalyse.

Authenticatie Vereist
POST
/api/v1/geo/geocode

Adres Geocoderen

Converteert een tekstadres naar geografische coördinaten. Retourneert meerdere kandidaten met betrouwbaarheidsscores. Ondersteunt internationale adressen in meerdere talen.

Authenticatie Vereist
POST
/api/v1/geo/reverse-geocode

Omgekeerd Geocoderen

Converteert coördinaten naar een leesbaar adres. Retourneert gestructureerde adrescomponenten (straat, stad, land) en plaatsnaam op verschillende nauwkeurigheidsniveaus.

Authenticatie Vereist

Dashboards & Visualisatie

Maak aanpasbare dashboards met grafieken, kaarten, statistieken en gedeelde teamweergaven.

POST
/api/v1/dashboards

Dashboard Aanmaken

Maakt een nieuw dashboard aan met titel, beschrijving en lay-outconfiguratie. Dashboards kunnen persoonlijk zijn of gedeeld worden met teams. Retourneert dashboard-ID voor het toevoegen van panelen.

Authenticatie Vereist
GET
/api/v1/dashboards/{dashboard_id}

Dashboard Ophalen

Retourneert dashboardconfiguratie inclusief alle panelen, lay-out, filters en verversingsfrequentie. Bevat optioneel vooraf berekende paneelgegevens voor directe weergave.

Authenticatie Vereist
PUT
/api/v1/dashboards/{dashboard_id}

Dashboard Bijwerken

Werkt dashboardmetadata of lay-outconfiguratie bij. Ondersteunt herordening en formaat wijzigen van panelen. Activeert verversing voor betrokken panelen.

Authenticatie Vereist
DELETE
/api/v1/dashboards/{dashboard_id}

Dashboard Verwijderen

Verwijdert een dashboard en alle bijbehorende panelen. Gedeelde dashboards vereisen eigenaarsmachtiging voor verwijdering. Bij favoriete dashboards wordt een waarschuwing getoond voor verwijdering.

Authenticatie Vereist
GET
/api/v1/dashboards

Dashboards Weergeven

Retourneert alle dashboards die toegankelijk zijn voor de gebruiker, inclusief eigen, gedeelde en teamdashboards. Ondersteunt filtering op type en favorieten.

Authenticatie Vereist
POST
/api/v1/dashboards/{dashboard_id}/panels

Paneel aan Dashboard Toevoegen

Voegt een nieuw paneel (grafiek, tabel, metriek, kaart) toe aan een dashboard. Configureert gegevensbron, query, visualisatietype en positie binnen de lay-out.

Authenticatie Vereist
PUT
/api/v1/dashboards/{dashboard_id}/panels/{panel_id}

Paneel Bijwerken

Werkt paneelconfiguratie bij inclusief query, visualisatie-instellingen en positie. Wijzigingen activeren directe gegevensverversing.

Authenticatie Vereist
DELETE
/api/v1/dashboards/{dashboard_id}/panels/{panel_id}

Paneel Verwijderen

Verwijdert een paneel van een dashboard. Andere panelen worden automatisch aangepast om de ruimte te vullen op basis van de lay-outmodus.

Authenticatie Vereist
POST
/api/v1/dashboards/{dashboard_id}/share

Dashboard Delen

Deelt een dashboard met specifieke gebruikers of teams. Configureer alleen-lezen of bewerkingsmachtigingen. Genereer optioneel een publieke link voor extern delen.

Authenticatie Vereist
POST
/api/v1/dashboards/{dashboard_id}/clone

Dashboard Klonen

Maakt een kopie van een dashboard met alle panelen. Nuttig voor het maken van variaties of persoonlijke kopieën van teamdashboards.

Authenticatie Vereist

Rapporten & Exports

Genereer professionele rapporten, rechtbankpakketten en gegevensexports in meerdere formaten.

POST
/api/v1/reports/generate

Rapport Genereren

Genereert een rapport vanuit een sjabloon of aangepaste configuratie. Ondersteunt meerdere uitvoerformaten (PDF, DOCX, HTML, XLSX). Retourneert rapport-ID voor statuscontrole en download.

Authenticatie Vereist
GET
/api/v1/reports/{report_id}

Rapport Ophalen

Retourneert rapportmetadata inclusief generatiestatus, gebruikte parameters en downloadlinks wanneer gereed. Grote rapporten kunnen enkele minuten nodig hebben om te genereren.

Authenticatie Vereist
GET
/api/v1/reports/{report_id}/download

Rapport Downloaden

Downloadt een gegenereerd rapportbestand. Ondersteunt range-verzoeken voor grote bestanden. Toegang wordt gelogd voor auditnaleving.

Authenticatie Vereist
GET
/api/v1/reports

Rapporten Weergeven

Retourneert alle rapporten die door de gebruiker of het team zijn gegenereerd. Ondersteunt filtering op sjabloon, datumbereik en status. Bevat generatiemetadata en bestandsgrootte.

Authenticatie Vereist
DELETE
/api/v1/reports/{report_id}

Rapport Verwijderen

Verwijdert een gegenereerd rapportbestand. Rapportmetadata wordt bewaard voor audit. Kan rapporten die zijn gemarkeerd voor juridische bewaring niet verwijderen.

Authenticatie Vereist
POST
/api/v1/exports/case/{case_id}

Dossier Exporteren

Exporteert een compleet dossierpakket inclusief alle gegevens, notities, bijlagen en tijdlijn. Ondersteunt redactie van gevoelige velden. Retourneert downloadlink wanneer gereed.

Authenticatie Vereist
POST
/api/v1/exports/investigation/{investigation_id}

Onderzoek Exporteren

Exporteert een volledig onderzoek met alle dossiers, profielen en bewijs. Grote onderzoeken worden asynchroon verwerkt met voortgangsmeldingen.

Authenticatie Vereist
POST
/api/v1/exports/court-package

Rechtbankpakket Genereren

Genereert een rechtbankklaar bewijspakket met juiste bewijsketendocumentatie, bewijsstuknummering en juridische opmaak. Bevat integriteitscertificaten.

Authenticatie Vereist
GET
/api/v1/reports/templates

Rapportsjablonen Weergeven

Retourneert beschikbare rapportsjablonen inclusief ingebouwde en aangepaste sjablonen. Sjablonen definiëren lay-out, gegevensbronnen en configureerbare parameters.

Authenticatie Vereist
POST
/api/v1/reports/schedule

Rapport Plannen

Plant automatische rapportgeneratie op terugkerende basis (dagelijks, wekelijks, maandelijks). Rapporten worden afgeleverd via e-mail of opgeslagen op de opgegeven locatie.

Authenticatie Vereist

Zoeken & Ontdekken

Globale full-text zoekopdrachten, semantisch zoeken en geavanceerde querymogelijkheden voor alle gegevens.

POST
/api/v1/search

Globaal Zoeken

Full-text zoeken over alle toegankelijke gegevens inclusief profielen, dossiers, notities en documenten. Retourneert gerangschikte resultaten met gemarkeerde overeenkomsten en type-indicatoren.

Authenticatie Vereist
POST
/api/v1/search/entities

Entiteiten Zoeken

Zoekt specifiek binnen entiteitsprofielen met geavanceerde filtering op type, attributen en relaties. Ondersteunt fuzzy matching voor namen.

Authenticatie Vereist
POST
/api/v1/search/documents

Documenten Zoeken

Zoekt binnen documentinhoud inclusief PDF's, Word-bestanden en verwerkte afbeeldingen. Retourneert relevante fragmenten met markeringsovereenkomsten.

Authenticatie Vereist
POST
/api/v1/search/advanced

Geavanceerd Zoeken

Gestructureerd zoeken met complexe booleaanse queries, veldspecifieke filters, datumbereiken en geneste voorwaarden. Ondersteunt opgeslagen zoekopdrachten voor frequente zoekopdrachten.

Authenticatie Vereist
POST
/api/v1/search/semantic

Semantisch Zoeken

AI-gestuurd semantisch zoeken dat de bedoeling van de zoekopdracht begrijpt. Vindt conceptueel gerelateerde inhoud zelfs zonder exacte trefwoordovereenkomsten. Ideaal voor onderzoeksqueries.

Authenticatie Vereist
GET
/api/v1/search/suggestions

Zoeksuggesties Ophalen

Retourneert autocomplete-suggesties terwijl de gebruiker typt. Bevat recente zoekopdrachten, populaire queries en overeenkomende entiteitsnamen voor snelle navigatie.

Authenticatie Vereist
GET
/api/v1/search/history

Zoekgeschiedenis Ophalen

Retourneert de recente zoekopdrachten van de gebruiker met tijdstempels. Ondersteunt het wissen van geschiedenis of het opslaan van zoekopdrachten voor hergebruik.

Authenticatie Vereist
POST
/api/v1/search/save

Zoekopdracht Opslaan

Slaat een zoekopdracht op voor snelle toegang. Opgeslagen zoekopdrachten kunnen worden gedeeld met teamleden. Configureer optioneel waarschuwingen wanneer nieuwe resultaten overeenkomen.

Authenticatie Vereist

Tags & Classificatie

Organiseer entiteiten met tags voor categorisering, filtering en cross-domeinontdekking.

POST
/api/v1/tags

Tag Aanmaken

Maakt een nieuwe tag aan met naam, kleur en optionele beschrijving. Tags zijn beperkt tot de organisatie. Tagnamen moeten uniek zijn binnen de organisatie.

Authenticatie Vereist
GET
/api/v1/tags

Tags Weergeven

Retourneert alle tags die beschikbaar zijn in de organisatie met gebruiksaantallen. Ondersteunt filtering op prefix voor hiërarchische tagstructuren.

Authenticatie Vereist
PUT
/api/v1/tags/{tag_id}

Tag Bijwerken

Werkt tageigenschappen bij inclusief naam, kleur en beschrijving. Naamswijzigingen worden doorgevoerd naar alle getagde entiteiten.

Authenticatie Vereist
DELETE
/api/v1/tags/{tag_id}

Tag Verwijderen

Verwijdert een tag en verwijdert deze van alle getagde entiteiten. Kan niet ongedaan worden gemaakt. Overweeg in plaats daarvan samen te voegen met een andere tag.

Authenticatie Vereist
POST
/api/v1/tags/apply

Tags Toepassen

Past een of meer tags toe op een entiteit (dossier, profiel, notitie, enz.). Ondersteunt het taggen van meerdere entiteiten tegelijk. Dubbele tags worden genegeerd.

Authenticatie Vereist
POST
/api/v1/tags/remove

Tags Verwijderen

Verwijdert opgegeven tags van een entiteit. Het verwijderen van tags wordt gelogd voor audit. Retourneert de bijgewerkte taglijst voor de entiteit.

Authenticatie Vereist
GET
/api/v1/tags/{tag_id}/entities

Entiteiten op Tag Ophalen

Retourneert alle entiteiten met een specifieke tag. Ondersteunt filtering op entiteitstype. Nuttig voor het vinden van gerelateerde items over verschillende domeinen.

Authenticatie Vereist

Opmerkingen & Samenwerking

Geneste opmerkingen met vermeldingen, reacties en realtime samenwerkingsfuncties.

POST
/api/v1/comments

Opmerking Aanmaken

Maakt een opmerking aan op elke entiteit (dossier, taak, profiel, enz.). Ondersteunt @vermeldingen voor meldingen en rich text-opmaak. Retourneert de aangemaakte opmerking met ID.

Authenticatie Vereist
GET
/api/v1/comments/{comment_id}

Opmerking Ophalen

Retourneert een enkele opmerking met metadata, reacties en emoji-reacties. Bevat bewerkingsgeschiedenis als de opmerking is gewijzigd.

Authenticatie Vereist
PUT
/api/v1/comments/{comment_id}

Opmerking Bijwerken

Werkt de inhoud van een opmerking bij. Bewerkingsgeschiedenis wordt bewaard. Alleen de auteur of beheerders kunnen bewerken. Meldingen worden verzonden bij wijzigingen in @vermeldingen.

Authenticatie Vereist
DELETE
/api/v1/comments/{comment_id}

Opmerking Verwijderen

Verwijdert een opmerking. Reacties blijven zichtbaar maar tonen 'bovenliggende verwijderd'. Alleen auteur of beheerders kunnen verwijderen. Auditlog wordt bewaard.

Authenticatie Vereist
GET
/api/v1/{entity_type}/{entity_id}/comments

Opmerkingen per Entiteit Weergeven

Retourneert alle opmerkingen voor een specifieke entiteit. Ondersteunt geneste weergave met geneste reacties. Standaard geordend op aanmaakdatum met nieuwste eerst.

Authenticatie Vereist
POST
/api/v1/comments/{comment_id}/reply

Reageren op Opmerking

Maakt een geneste reactie op een bestaande opmerking. Stuurt melding aan de auteur van de bovenliggende opmerking. Ondersteunt onbeperkte nestdiepte.

Authenticatie Vereist
POST
/api/v1/comments/{comment_id}/react

Reageren met Emoji op Opmerking

Voegt een emoji-reactie toe aan of verwijdert deze van een opmerking. Ondersteunt standaard emojiset. Retourneert bijgewerkte reactietellingen.

Authenticatie Vereist

Meldingen & Voorkeuren

Beheer meldingen via kanalen met aanpasbare voorkeuren en stille uren.

GET
/api/v1/notifications

Meldingen Weergeven

Retourneert alle meldingen voor de huidige gebruiker. Ondersteunt filtering op leesstatus, type en datumbereik. Geordend op aanmaaktijd, nieuwste eerst.

Authenticatie Vereist
GET
/api/v1/notifications/unread-count

Aantal Ongelezen Ophalen

Retourneert het aantal ongelezen meldingen. Lichtgewicht eindpunt voor badgeweergave. Wordt in realtime bijgewerkt via WebSocket.

Authenticatie Vereist
POST
/api/v1/notifications/{notification_id}/read

Melding als Gelezen Markeren

Markeert een enkele melding als gelezen. Retourneert 204 No Content bij succes. Reeds gelezen meldingen worden stilzwijgend genegeerd.

Authenticatie Vereist
POST
/api/v1/notifications/mark-all-read

Alle Meldingen als Gelezen Markeren

Markeert alle meldingen als gelezen. Retourneert het aantal bijgewerkte meldingen. Nuttig voor 'alles wissen'-functionaliteit.

Authenticatie Vereist
DELETE
/api/v1/notifications/{notification_id}

Melding Verwijderen

Verwijdert een melding permanent. Kan niet ongedaan worden gemaakt. Overweeg in plaats daarvan als gelezen te markeren voor de audittrail.

Authenticatie Vereist
GET
/api/v1/notifications/preferences

Meldingsvoorkeuren Ophalen

Retourneert de meldingsvoorkeuren van de gebruiker inclusief ingeschakelde kanalen (e-mail, push, in-app), frequentie-instellingen en configuratie van stille uren.

Authenticatie Vereist
PUT
/api/v1/notifications/preferences

Meldingsvoorkeuren Bijwerken

Werkt meldingsvoorkeuren bij. Configureer welke gebeurtenissen meldingen activeren en via welke kanalen. Wijzigingen worden onmiddellijk van kracht.

Authenticatie Vereist

Teams & Samenwerking

Teambeheer met leden, rollen, machtigingen en organisatorische hiërarchieën.

POST
/api/v1/teams

Team Aanmaken

Maakt een nieuw team aan met naam, beschrijving en initiële leden. De teammaker wordt de standaardeigenaar. Teams kunnen genest worden voor organisatorische hiërarchie.

Beheerder/Manager
GET
/api/v1/teams/{team_id}

Team Ophalen

Retourneert teamdetails inclusief leden, rollen en statistieken. Bevat geaggregeerde metrieken voor teamwerklast en prestaties.

Authenticatie Vereist
PUT
/api/v1/teams/{team_id}

Team Bijwerken

Werkt teammetadata bij inclusief naam, beschrijving en instellingen. Alleen teameigenaars of beheerders kunnen teameigenschappen wijzigen.

Beheerder/Manager
DELETE
/api/v1/teams/{team_id}

Team Verwijderen

Verwijdert een team. Leden worden niet verwijderd maar verliezen teamgebaseerde machtigingen. Dossiers en resources die aan het team zijn toegewezen moeten eerst opnieuw worden toegewezen.

Beheerder/Superuser
GET
/api/v1/teams

Teams Weergeven

Retourneert alle teams die de gebruiker kan zien. Bevat teams waar zij lid van zijn en teams die zij beheren. Ondersteunt filtering op bovenliggend team voor hiërarchieweergaven.

Authenticatie Vereist
POST
/api/v1/teams/{team_id}/members

Teamlid Toevoegen

Voegt een gebruiker toe aan een team met opgegeven rol (lid, leider, eigenaar). Gebruiker ontvangt een melding en krijgt onmiddellijk teamgebaseerde machtigingen.

Beheerder/Manager
DELETE
/api/v1/teams/{team_id}/members/{user_id}

Teamlid Verwijderen

Verwijdert een gebruiker uit een team. Gebruiker verliest onmiddellijk teamgebaseerde machtigingen. Kan de laatste eigenaar niet verwijderen - draag eerst het eigenaarschap over.

Beheerder/Manager
PUT
/api/v1/teams/{team_id}/members/{user_id}/role

Lidrol Bijwerken

Wijzigt de rol van een teamlid binnen het team. Rolwijzigingen hebben onmiddellijk invloed op machtigingen. Wordt vastgelegd in auditlog voor naleving.

Beheerder/Manager

Volglijsten & Screening

Monitor entiteiten tegen volglijsten met automatische matching en waarschuwingsgeneratie.

POST
/api/v1/watchlists

Volglijst Aanmaken

Maakt een nieuwe volglijst aan met naam, beschrijving en matchcriteria. Volglijsten kunnen specifieke entiteitstypen of attribuutpatronen monitoren.

Authenticatie Vereist
GET
/api/v1/watchlists/{watchlist_id}

Volglijst Ophalen

Retourneert volglijstconfiguratie inclusief entiteiten, matchregels en statistieken. Toont recente matchactiviteit en waarschuwingsinstellingen.

Authenticatie Vereist
PUT
/api/v1/watchlists/{watchlist_id}

Volglijst Bijwerken

Werkt volglijstconfiguratie bij inclusief naam, regels en meldingsinstellingen. Wijzigingen aan regels activeren herverwerking van recente gegevens.

Authenticatie Vereist
DELETE
/api/v1/watchlists/{watchlist_id}

Volglijst Verwijderen

Verwijdert een volglijst. Historische matches worden bewaard in het auditlog. Actieve waarschuwingen gebaseerd op deze volglijst worden gesloten.

Authenticatie Vereist
GET
/api/v1/watchlists

Volglijsten Weergeven

Retourneert alle volglijsten die toegankelijk zijn voor de gebruiker. Bevat persoonlijke volglijsten en gedeelde teamvolglijsten. Toont matchaantallen en laatste activiteit.

Authenticatie Vereist
POST
/api/v1/watchlists/{watchlist_id}/entities

Entiteit aan Volglijst Toevoegen

Voegt een specifieke entiteit toe aan een volglijst voor monitoring. Geef optioneel monitoringparameters en waarschuwingsdrempels op.

Authenticatie Vereist
DELETE
/api/v1/watchlists/{watchlist_id}/entities/{entity_id}

Entiteit van Volglijst Verwijderen

Verwijdert een entiteit uit volglijstmonitoring. Bestaande matches en waarschuwingen worden bewaard in de geschiedenis.

Authenticatie Vereist
POST
/api/v1/watchlists/{watchlist_id}/check

Controleren Tegen Volglijst

Controleert of een gegeven entiteit of gegevens overeenkomt met criteria in de volglijst. Retourneert overeenkomende regels en overeenkomstscores.

Authenticatie Vereist
POST
/api/v1/watchlists/batch-check

Batchgewijs Controleren Tegen Volglijsten

Controleert meerdere entiteiten tegen alle actieve volglijsten in een enkel verzoek. Efficiënt voor bulkscreeningbewerkingen. Maximaal 100 entiteiten per verzoek.

Authenticatie Vereist
GET
/api/v1/watchlists/{watchlist_id}/matches

Volglijstmatches Ophalen

Retourneert alle matches voor een volglijst met matchdetails, tijdstempels en dispositiestatus. Ondersteunt filtering op datumbereik en dispositie.

Authenticatie Vereist

Bewijsbeheer

Rechtbankbestendig bewijsregistratie met bewijsketen, integriteitsverificatie en verzegeling.

POST
/api/v1/evidence

Bewijsregistratie Aanmaken

Maakt een formele bewijsregistratie aan met bewijsketentracking. Berekent cryptografische hash voor integriteitsverificatie. Wijst uniek bewijsnummer toe.

Authenticatie Vereist
GET
/api/v1/evidence/{evidence_id}

Bewijs Ophalen

Retourneert bewijsregistratie met metadata, integriteitsstatus en bewijsketen. Bevat bijbehorende bijlagen en analyseresultaten.

Authenticatie Vereist
PUT
/api/v1/evidence/{evidence_id}

Bewijs Bijwerken

Werkt bewijsmetadata bij. Inhoudswijzigingen activeren nieuwe hashberekening en bewaringregistratie. Verzegeld bewijs kan niet worden gewijzigd.

Authenticatie Vereist
GET
/api/v1/cases/{case_id}/evidence

Bewijs per Dossier Weergeven

Retourneert alle bewijsstukken voor een dossier. Ondersteunt filtering op type, status en datum. Standaard geordend op verzameldatum.

Authenticatie Vereist
POST
/api/v1/evidence/{evidence_id}/custody-transfer

Bewaringsoverdracht Registreren

Registreert een bewaringsoverdracht van de ene bewaarder naar de andere. Beide partijen moeten de overdracht erkennen. Maakt een onveranderbare bewaringsregistratie aan.

Authenticatie Vereist
GET
/api/v1/evidence/{evidence_id}/chain-of-custody

Bewijsketen Ophalen

Retourneert de volledige bewijsketengeschiedenis voor een bewijsstuk. Toont elke bewaringsgebeurtenis met tijdstempels, bewaarders en doeleinden.

Authenticatie Vereist
POST
/api/v1/evidence/{evidence_id}/verify-integrity

Bewijsintegriteit Verifiëren

Verifieert bewijsintegriteit door hash opnieuw te berekenen en te vergelijken met de opgeslagen waarde. Retourneert verificatieresultaat met gedetailleerde vergelijking.

Authenticatie Vereist
POST
/api/v1/evidence/{evidence_id}/seal

Bewijs Verzegelen

Verzegelt een bewijsstuk waardoor verdere wijzigingen worden voorkomen. Genereert digitaal verzegelingscertificaat. Verzegeld bewijs kan alleen worden gekopieerd, niet gewijzigd.

Authenticatie Vereist
GET
/api/v1/evidence/{evidence_id}/audit-trail

Bewijsaudittrail Ophalen

Retourneert de volledige audittrail voor bewijs inclusief alle toegangsgebeurtenissen, weergaven, downloads en analyseactiviteiten. Essentieel voor toelaatbaarheid bij de rechtbank.

Authenticatie Vereist

OSINT & Gegevensverrijking

Bevraag meerdere inlichtingenproviders voor persoons-, organisatie-, telefoon-, e-mail-, sociale media-, voertuig-, domein-, IP- en cryptovaluta-inlichtingen.

GET
/api/v1/osint/providers

OSINT-providers Weergeven

Retourneert alle geconfigureerde OSINT-dataproviders met hun mogelijkheden, dekkingsgebieden en huidige beschikbaarheidsstatus.

Authenticatie Vereist
GET
/api/v1/osint/providers/{provider_id}/status

Providerstatus Ophalen

Retourneert gedetailleerde status voor een specifieke inlichtingenprovider inclusief API-gezondheid, quotagebruik en recente prestatiestatistieken.

Authenticatie Vereist
POST
/api/v1/osint/search/person

Persoon Zoeken

Zoekt over OSINT-bronnen naar informatie over een persoon. Accepteert naam, geboortedatum, adressen en identificatoren. Voegt resultaten van meerdere providers samen.

Authenticatie Vereist
POST
/api/v1/osint/search/organization

Organisatie Zoeken

Zoekt naar organisatie-informatie inclusief bedrijfsregisters, bestuurders, financiële gegevens en regelgevingsaangiftes over meerdere databases.

Authenticatie Vereist
POST
/api/v1/osint/search/phone

Telefoonnummer Zoeken

Omgekeerde telefoonopzoeking over providerdatabases, sociale platforms en openbare registers. Retourneert eigenaarinformatie, providerdetails en gekoppelde accounts.

Authenticatie Vereist
POST
/api/v1/osint/search/email

E-mailadres Zoeken

E-mailinlichtingenopzoeking die blootstelling bij datalekken, sociale accounts en identiteitsverificatie retourneert. Ondersteunt bulk-e-mailvalidatie.

Authenticatie Vereist
POST
/api/v1/osint/search/social

Sociale Media Zoeken

Zoekt op sociale mediaplatforms naar profielen die voldoen aan criteria. Retourneert profielmetadata, connecties en inhoudsvoorbeelden waar beschikbaar.

Authenticatie Vereist
POST
/api/v1/osint/search/vehicle

Voertuig Zoeken

Voertuigopzoeking op VIN, kenteken of beschrijving. Retourneert registratiegeschiedenis, eigenaarinformatie en incidentregistraties uit beschikbare databases.

Authenticatie Vereist
POST
/api/v1/osint/search/domain

Domein Zoeken

Domeininlichtingen inclusief WHOIS-geschiedenis, DNS-records, SSL-certificaten en hostinginformatie. Identificeert gerelateerde domeinen en infrastructuur.

Authenticatie Vereist
POST
/api/v1/osint/search/ip

IP-adres Zoeken

IP-adres-inlichtingen inclusief geolocatie, ASN, reputatiescores en hostingdetails. Historische gegevens beschikbaar voor het volgen van infrastructuurwijzigingen.

Authenticatie Vereist
POST
/api/v1/osint/search/crypto

Cryptovaluta Zoeken

Cryptovaluta-adresanalyse inclusief transactiegeschiedenis, clusteridentificatie en risicoscoring. Ondersteunt Bitcoin, Ethereum en grote altcoins.

Authenticatie Vereist
POST
/api/v1/osint/batch-enrich

Batchgewijs Verrijken

Verrijkt meerdere entiteiten met OSINT-gegevens in een enkel verzoek. Plaatst verzoeken in de wachtrij over providers met inachtneming van snelheidslimieten. Retourneert taak-ID voor statuscontrole.

Authenticatie Vereist
GET
/api/v1/osint/usage

OSINT-gebruik Ophalen

Retourneert OSINT-querygebruiksstatistieken voor de organisatie inclusief quotaverbruik per provider, resterende tegoeden en gebruikstrends.

Authenticatie Vereist

Sjablonen & Automatisering

Herbruikbare sjablonen voor dossiers, rapporten en workflows om processen te standaardiseren.

POST
/api/v1/templates/case

Dossiersjabloon Aanmaken

Maakt een herbruikbaar dossiersjabloon aan met vooraf gedefinieerde taken, checklists, velden en workflowfasen. Sjablonen standaardiseren onderzoeksprocessen.

Beheerder/Manager
GET
/api/v1/templates/case

Dossiersjablonen Weergeven

Retourneert alle dossiersjablonen die beschikbaar zijn voor de organisatie. Bevat ingebouwde en aangepaste sjablonen met gebruiksstatistieken.

Authenticatie Vereist
GET
/api/v1/templates/case/{template_id}

Dossiersjabloon Ophalen

Retourneert volledige dossiersjabloonconfiguratie inclusief alle secties, taken en workflowdefinities.

Authenticatie Vereist
PUT
/api/v1/templates/case/{template_id}

Dossiersjabloon Bijwerken

Werkt dossiersjabloonconfiguratie bij. Wijzigingen hebben geen invloed op bestaande dossiers die vanuit het sjabloon zijn aangemaakt.

Beheerder/Manager
DELETE
/api/v1/templates/case/{template_id}

Dossiersjabloon Verwijderen

Verwijdert een dossiersjabloon. Het sjabloon mag niet worden verwezen door actieve workflows. Historische gebruiksstatistieken worden bewaard.

Beheerder/Superuser
POST
/api/v1/templates/report

Rapportsjabloon Aanmaken

Maakt een rapportsjabloon aan met lay-out, secties, gegevensbindingen en opmaakregels. Sjablonen genereren consistente professionele rapporten.

Beheerder/Manager
GET
/api/v1/templates/report

Rapportsjablonen Weergeven

Retourneert alle rapportsjablonen inclusief systeemsjablonen en aangepaste organisatiesjablonen. Toont sjablooncategorieën en vereiste parameters.

Authenticatie Vereist
POST
/api/v1/templates/workflow

Workflowsjabloon Aanmaken

Maakt een automatiseringsworkflowsjabloon aan met triggers, voorwaarden en acties. Workflows automatiseren repetitieve onderzoekstaken.

Beheerder/Manager
GET
/api/v1/templates/workflow

Workflowsjablonen Weergeven

Retourneert alle workflowsjablonen met uitvoeringsstatistieken. Toont triggervoorwaarden en actiesamenvattingen.

Authenticatie Vereist

Workflows & Automatisering

Geautomatiseerde workflows met triggers, voorwaarden en acties voor onderzoeksautomatisering.

POST
/api/v1/workflows

Workflow Aanmaken

Maakt een geautomatiseerde workflow aan met gedefinieerde triggers, voorwaarden en acties. Workflows worden automatisch uitgevoerd op basis van gebeurtenissen of schema's.

Beheerder/Manager
GET
/api/v1/workflows/{workflow_id}

Workflow Ophalen

Retourneert workflowconfiguratie inclusief alle stappen, voorwaarden en uitvoeringsgeschiedenis. Toont huidige status en prestatiestatistieken.

Authenticatie Vereist
PUT
/api/v1/workflows/{workflow_id}

Workflow Bijwerken

Werkt workflowconfiguratie bij. Actieve workflows blijven de huidige uitvoeringen draaien; nieuwe triggers gebruiken de bijgewerkte configuratie.

Beheerder/Manager
DELETE
/api/v1/workflows/{workflow_id}

Workflow Verwijderen

Verwijdert een workflow. Lopende uitvoeringen worden voltooid maar er starten geen nieuwe uitvoeringen. Uitvoeringsgeschiedenis wordt bewaard voor audit.

Beheerder/Superuser
GET
/api/v1/workflows

Workflows Weergeven

Retourneert alle workflows die toegankelijk zijn voor de gebruiker. Ondersteunt filtering op status, triggertype en uitvoeringsfrequentie.

Authenticatie Vereist
POST
/api/v1/workflows/{workflow_id}/execute

Workflow Uitvoeren

Activeert handmatig een workflowuitvoering met opgegeven invoerparameters. Retourneert uitvoerings-ID voor het monitoren van voortgang.

Authenticatie Vereist
GET
/api/v1/workflows/{workflow_id}/executions

Workflowuitvoeringen Weergeven

Retourneert uitvoeringsgeschiedenis voor een workflow. Toont status, duur en uitvoer voor elke run. Ondersteunt filtering op datum en status.

Authenticatie Vereist
POST
/api/v1/workflows/{workflow_id}/pause

Workflow Pauzeren

Pauzeert een actieve workflow. Lopende uitvoeringen worden voltooid maar nieuwe triggers worden in de wachtrij geplaatst. Nuttig voor onderhoud of onderzoek.

Authenticatie Vereist
POST
/api/v1/workflows/{workflow_id}/resume

Workflow Hervatten

Hervat een gepauzeerde workflow. Triggers in de wachtrij beginnen met verwerking. Retourneert het aantal wachtende uitvoeringen.

Authenticatie Vereist

Realtime Communicatie

WebSocket-gebaseerde realtime berichten- en samenwerkingseindpunten.

POST
/api/v1/channels

Kanaal Aanmaken

Maakt een realtime berichtenkanaal aan voor teamsamenwerking. Kanalen kunnen worden gekoppeld aan dossiers of onderzoeken. Retourneert kanaal-ID voor WebSocket-abonnement.

Authenticatie Vereist
GET
/api/v1/channels/{channel_id}

Kanaal Ophalen

Retourneert kanaaldetails inclusief leden, recente activiteit en configuratie. Toont het aantal ongelezen berichten voor de aanvragende gebruiker.

Authenticatie Vereist
GET
/api/v1/channels

Kanalen Weergeven

Retourneert alle kanalen waartoe de gebruiker toegang heeft. Bevat directe berichten, dossierkanalen en teamkanalen. Geordend op recente activiteit.

Authenticatie Vereist
POST
/api/v1/channels/{channel_id}/messages

Bericht Verzenden

Verzendt een bericht naar een kanaal. Ondersteunt tekst, vermeldingen en bijlagen. Berichten worden in realtime afgeleverd via WebSocket aan verbonden clients.

Authenticatie Vereist
GET
/api/v1/channels/{channel_id}/messages

Kanaalberichten Ophalen

Retourneert berichtengeschiedenis voor een kanaal. Ondersteunt paginering voor het laden van oudere berichten. Bevat reacties en antwoordtellingen.

Authenticatie Vereist
POST
/api/v1/channels/{channel_id}/members

Kanaallid Toevoegen

Voegt een gebruiker toe aan een kanaal. Gebruiker ontvangt een melding en kan berichtengeschiedenis zien vanaf het moment van toetreding. Kanaaleigenaars kunnen leden toevoegen.

Authenticatie Vereist
DELETE
/api/v1/channels/{channel_id}/members/{user_id}

Kanaallid Verwijderen

Verwijdert een gebruiker uit een kanaal. Gebruiker verliest toegang tot het kanaal en toekomstige berichten. Historische berichten blijven zichtbaar voor andere leden.

Authenticatie Vereist
GET
/api/v1/users/presence

Gebruikersaanwezigheid Ophalen

Retourneert online-/offlinestatus en laatste activiteitstijd voor opgegeven gebruikers of alle teamleden. Wordt in realtime bijgewerkt via WebSocket.

Authenticatie Vereist

GraphQL API

De primaire GraphQL API (api.knogin.com/graphql) biedt 100+ queries, 80+ mutations en realtime subscriptions met behulp van het Strawberry GraphQL-framework. GraphQL biedt flexibele gegevensopvraging, waardoor clients precies de gegevens kunnen opvragen die ze nodig hebben in één verzoek.

GraphQL-eindpunt

GraphQL-eindpuntPOST https://api.knogin.com/graphql
GraphQL PlaygroundGET https://api.knogin.com/graphql

Onderzoeken

Maak, beheer en volg onderzoeken met volledige levenscyclusondersteuning inclusief teamtoewijzing, bestandsbeheer en voortgangsregistratie.

Queries
  • getInvestigation(investigationId: ID!)
  • getInvestigations(status: [Status], limit: Int, offset: Int)
  • investigationTimeline(investigationId: ID!)
  • investigationStatistics(investigationId: ID!)
  • investigationTeam(investigationId: ID!)
Mutations
  • startNewInvestigation(input: CreateInvestigationInput!)
  • updateInvestigation(investigationId: ID!, input: UpdateInvestigationInput!)
  • deleteInvestigation(investigationId: ID!)
  • addFilesToInvestigation(investigationId: ID!, fileIds: [ID!]!)
  • assignInvestigationTeam(investigationId: ID!, userIds: [ID!]!)

Dossiers

Volledig dossierbeheer met sjablonen, workflows, statustracking, profielkoppeling en bulkbewerkingen voor efficiënte dossierafhandeling.

Queries
  • 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)
Mutations
  • 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!)

Taken

Takenbeheer met toewijzingen, checklists, afhankelijkheden en voortgangsregistratie voor gestructureerde onderzoeksworkflows.

Queries
  • task(taskId: ID!)
  • tasks(caseId: ID!, status: [TaskStatus], assignee: ID)
  • myTasks(status: [TaskStatus], dueDate: DateRange)
  • taskChecklist(taskId: ID!)
  • taskDependencies(taskId: ID!)
Mutations
  • 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!)

Notities & Bijlagen

Onderzoeksnotities met rich text, threading en bestandsbijlagen. Volledige bewijsketentracking voor bewijswaardige bestanden.

Queries
  • note(noteId: ID!)
  • notes(caseId: ID!, type: NoteType, visibility: Visibility)
  • attachment(attachmentId: ID!)
  • attachments(caseId: ID!, fileType: String)
  • attachmentChainOfCustody(attachmentId: ID!)
Mutations
  • 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!)

Profielen & Entiteiten

Entiteitsprofielbeheer voor personen, organisaties en andere entiteiten met OSINT-verrijking en relatiemapping.

Queries
  • 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)
Mutations
  • 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!)

Waarschuwingen & Monitors

Realtime waarschuwingssysteem met configureerbare monitors, ernstniveaus en besluitvormingsworkflows voor dreigingsdetectie.

Queries
  • 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!)
Mutations
  • 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!)

Graafanalyse

Kennisgraafbewerkingen inclusief padvinding, centraliteitsanalyse, gemeenschapsdetectie en linkvoorspelling voor netwerkinlichtingen.

Queries
  • 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)
Mutations
  • 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!)

Geospatiale Inlichtingen

Locatiegebaseerde zoekopdrachten, clustering, heatmaps, geofencing en tijdlijnanalyse voor geografische inlichtingenoperaties.

Queries
  • 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!)
Mutations
  • createLocation(input: CreateLocationInput!)
  • updateLocation(locationId: ID!, input: UpdateLocationInput!)
  • deleteLocation(locationId: ID!)
  • linkLocationToEntity(locationId: ID!, entityId: ID!)
  • createGeofence(input: CreateGeofenceInput!)
  • updateGeofence(geofenceId: ID!, input: UpdateGeofenceInput!)

Dashboards & Visualisatie

Maak en beheer aanpasbare dashboards met panelen, grafieken en realtime statistieken voor operationeel bewustzijn.

Queries
  • getDashboard(dashboardId: ID!)
  • listDashboards(type: DashboardType, shared: Boolean)
  • getDashboardMetrics(dashboardId: ID!)
  • panelData(panelId: ID!, dateRange: DateRange)
  • dashboardTemplates(category: String)
Mutations
  • 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!)

Zoeken & Ontdekken

Globaal zoeken met semantische mogelijkheden, geavanceerde filters en opgeslagen zoekopdrachten voor snelle inlichtingenontdekking.

Queries
  • globalSearch(query: String!, limit: Int, offset: Int)
  • semanticSearch(query: String!, entityTypes: [EntityType])
  • advancedSearch(input: AdvancedSearchInput!)
  • searchSuggestions(prefix: String!, limit: Int)
  • searchHistory(limit: Int)
  • savedSearches
Mutations
  • saveSearch(input: SaveSearchInput!)
  • deleteSavedSearch(searchId: ID!)
  • clearSearchHistory

Bewijsbeheer

Rechtbankbestendig bewijsregistratie met bewijsketen, integriteitsverificatie en verzegeling voor juridische procedures.

Queries
  • evidence(evidenceId: ID!)
  • evidenceByCase(caseId: ID!, type: EvidenceType)
  • evidenceChainOfCustody(evidenceId: ID!)
  • verifyEvidenceIntegrity(evidenceId: ID!)
  • evidenceAuditTrail(evidenceId: ID!)
Mutations
  • createEvidence(input: CreateEvidenceInput!)
  • updateEvidence(evidenceId: ID!, input: UpdateEvidenceInput!)
  • recordCustodyTransfer(evidenceId: ID!, input: CustodyTransferInput!)
  • sealEvidence(evidenceId: ID!)
  • linkEvidenceToCase(evidenceId: ID!, caseId: ID!)

OSINT & Verrijking

Open-source inlichtingenqueries bij meerdere providers voor persoons-, organisatie-, telefoon-, e-mail-, sociale media-, voertuig-, domein-, IP- en cryptovalutagegevens.

Queries
  • osintProviders
  • osintProviderStatus(providerId: ID!)
  • osintUsage(dateRange: DateRange)
Mutations
  • 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])

Teams & Gebruikers

Teambeheer met ledenrollen, machtigingen en hiërarchieën voor gezamenlijke onderzoeksoperaties.

Queries
  • team(teamId: ID!)
  • teams(parentId: ID)
  • teamMembers(teamId: ID!)
  • myTeams
  • user(userId: ID!)
  • users(role: Role, status: UserStatus)
  • currentUser
Mutations
  • createTeam(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!)

Workflows & Automatisering

Geautomatiseerde workflows met triggers, voorwaarden en acties voor gestroomlijnde onderzoeksprocessen.

Queries
  • workflow(workflowId: ID!)
  • workflows(status: WorkflowStatus, trigger: TriggerType)
  • workflowExecutions(workflowId: ID!, status: ExecutionStatus)
  • workflowExecution(executionId: ID!)
  • workflowTemplates(category: String)
Mutations
  • 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!)

AI-services

AI-gestuurde tekstanalyse, entiteitsextractie, samenvatting, vertaling en documentverwerkingsmogelijkheden.

Queries
  • aiProcessingStatus(jobId: ID!)
  • aiProcessingHistory(entityId: ID!)
  • aiCapabilities
Mutations
  • analyzeText(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)

Meldingen & Opmerkingen

Realtime meldingen met voorkeuren, geneste opmerkingen, vermeldingen en reacties voor teamsamenwerking.

Queries
  • notifications(status: NotificationStatus, limit: Int)
  • unreadNotificationCount
  • notificationPreferences
  • comments(entityId: ID!, entityType: EntityType)
  • comment(commentId: ID!)
Mutations
  • markNotificationRead(notificationId: ID!)
  • markAllNotificationsRead
  • updateNotificationPreferences(input: NotificationPreferencesInput!)
  • createComment(input: CreateCommentInput!)
  • updateComment(commentId: ID!, content: String!)
  • deleteComment(commentId: ID!)
  • replyToComment(parentId: ID!, content: String!)
  • reactToComment(commentId: ID!, reaction: String!)

Realtime Abonnementen

Abonneer u op realtime updates via WebSocket voor live datastreaming in alle domeinen.

Waarschuwingen
  • alertStream
  • alertUpdates(alertId: ID!)
  • monitorAlerts(monitorId: ID!)
Onderzoeken
  • investigationProgress(investigationId: ID!)
  • caseUpdates(caseId: ID!)
  • taskUpdates(caseId: ID!)
Dashboards
  • dashboardUpdates(dashboardId: ID!)
  • panelData(panelId: ID!)
  • metricsStream(dashboardId: ID!)
Samenwerking
  • channelMessages(channelId: ID!)
  • userPresence(userIds: [ID!]!)
  • typingIndicator(channelId: ID!)
Verwerking
  • processingProgress(jobId: ID!)
  • enrichmentProgress(profileId: ID!)
  • workflowExecution(executionId: ID!)
Meldingen
  • notificationStream
  • mentionStream
  • systemAnnouncements

Voorbeeld: Onderzoek met Dossiers Opvragen

GraphQL Query
query 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
    }
  }
}

Voorbeeld: Waarschuwing Aanmaken Mutation

GraphQL Mutation
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"
  }
}

WebSocket & Realtime

Realtime communicatie via WebSocket voor live updates, GraphQL-abonnementen en samenwerkingsfuncties.

WebSocket-eindpunten

WS
wss://api.knogin.com/graphql

GraphQL Subscriptions

WebSocket-eindpunt voor GraphQL subscriptions met gebruik van het graphql-ws protocol. Ondersteunt alle subscription-bewerkingen inclusief waarschuwingsstromen, onderzoeksupdates en realtime samenwerking.

Authenticatie Vereist
WS
wss://api.knogin.com/ws

Algemene Evenementstroom

WebSocket-eindpunt voor algemene realtime evenementstreaming inclusief onderzoeksupdates, systeemmeldingen en gebruikersaanwezigheid. Ondersteunt kanaalgebaseerde abonnementen.

Authenticatie Vereist

Abonnementsvoorbeeld

GraphQL Subscription
subscription AlertStream {
  alertStream {
    id
    title
    severity
    confidence
    createdAt
    entities {
      id
      name
    }
    locations {
      latitude
      longitude
    }
  }
}

Responsformaten

Standaard responsstructuren die in de gehele API worden gebruikt.

Succesrespons

{
  "success": true,
  "data": { ... },
  "message": "Operation completed successfully",
  "timestamp": "2024-01-15T10:30:00Z",
  "request_id": "req_abc123"
}

Foutrespons

{
  "error": "VALIDATION_ERROR",
  "message": "Invalid input parameters",
  "code": "ERR_VALIDATION_001",
  "details": {
    "field": "email",
    "reason": "Invalid email format"
  },
  "timestamp": "2024-01-15T10:30:00Z"
}

HTTP-statuscodes

Veelvoorkomende statuscodes die door de API worden geretourneerd.

  • 200OK - Verzoek geslaagd
  • 201Created - Bron aangemaakt
  • 204No Content - Succes zonder inhoud
  • 400Bad Request - Ongeldige parameters
  • 401Unauthorized - Authenticatie vereist
  • 403Forbidden - Toegang geweigerd
  • 404Not Found - Bron niet gevonden
  • 422Unprocessable Entity - Validatiefout
  • 429Too Many Requests - Limiet bereikt
  • 500Internal Server Error

Limieten

API-limieten om eerlijk gebruik en systeemstabiliteit te waarborgen.

  • Standaard Eindpunten1000 verzoeken per minuut
  • Authenticatie-eindpunten5 verzoeken per minuut (inloggen, MFA-verificatie)
  • Batchbewerkingen100 profielen per batchverzoek, 10 voor verrijking
  • Bestandsuploads50MB maximale bestandsgrootte
  • AI-verwerkingOnderhevig aan tokenlimieten per organisatieniveau

Klaar om te Integreren?

Ga aan de slag met onze SDK's of neem contact op met ons integratieteam voor ondersteuning.