Documentation complète pour toutes les API Public Safety incluant les points d'accès GraphQL, REST et WebSocket. Tous les points d'accès nécessitent un argus_auth_token valide pour retourner des données.
Public Safety Command Center expose deux services API principaux avec plus de 200 points d'accès REST et 180+ opérations GraphQL. Tous les points d'accès authentifiés nécessitent un argus_auth_token valide obtenu via le Service d'Auth.
auth.knogin.com
Gère toute l'authentification, la gestion des utilisateurs, MFA, SSO, clés API, rôles, permissions et gestion des sessions. C'est ici que vous obtenez les jetons pour accéder au Service API.
api.knogin.com
L'API principale de la plateforme de renseignement fournissant des points d'accès REST et GraphQL pour les enquêtes, cas, profils, preuves, alertes, moniteurs, services IA et communication en temps réel.
https://auth.knogin.comhttps://api.knogin.comhttps://auth-staging.knogin.comhttps://api-staging.knogin.comToutes les requêtes API authentifiées nécessitent un argus_auth_token valide. Les jetons sont obtenus via le Service d'Auth et doivent être inclus dans toutes les requêtes suivantes aux deux services. Les clés API peuvent être générées dans le tableau de bord du Service d'Auth sous votre profil utilisateur pour l'accès programmatique.
Après une connexion réussie, les cookies sont définis automatiquement :
platform_access_token=eyJhbGc... # Short-lived access token
knogin_refresh_token=eyJhbGc... # Long-lived refresh tokenIncluez le jeton dans l'en-tête Authorization :
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...# Using username/password (OAuth2 form)
curl -X POST https://auth.knogin.com/v1/token \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "[email protected]&password=your_password"
# Using API Key (recommended for service-to-service)
curl -X POST https://auth.knogin.com/v1/auth/token \
-H "Content-Type: application/json" \
-d '{"api_key": "your_api_key", "platform": "publicSafety"}'
# Response
{
"access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"token_type": "bearer",
"expires_in": 3600
}Le Service d'Auth (auth.knogin.com) gère toute l'authentification, l'autorisation, la gestion des utilisateurs, MFA, SSO, clés API, rôles, permissions, drapeaux de fonctionnalités et gestion multi-locataire. Il contient plus de 80 points d'accès organisés par fonctionnalité.
Points d'accès d'authentification principaux pour l'obtention, le rafraîchissement et la gestion des jetons d'accès et des sessions.
/v1/tokenPoint d'accès de connexion compatible OAuth2 qui accepte l'email et le mot de passe encodés en formulaire. Émet des jetons d'accès spécifiques à la plateforme et définit des cookies HTTP-only (platform_access_token, knogin_refresh_token) pour les sessions navigateur. Si MFA est activé, retourne un cookie de défi nécessitant une vérification via /v1/mfa/verify-login. Supporte redirect_uri pour la navigation post-connexion.
/v1/auth/tokenAuthentification utilisant une clé API pour recevoir un jeton JWT spécifique à la plateforme. Idéal pour l'authentification service-à-service, les pipelines CI/CD et l'accès programmatique. Les clés API peuvent être générées dans le tableau de bord du Service d'Auth sous votre profil utilisateur. Le corps de la requête nécessite les champs api_key et platform.
/v1/auth/refreshRafraîchit les jetons d'accès expirés en utilisant le cookie knogin_refresh_token. Retourne de nouveaux cookies de jeton d'accès sans nécessiter de réauthentification. Supporte un paramètre de chemin platform optionnel pour le rafraîchissement de jeton spécifique à la plateforme. Essentiel pour maintenir des sessions de longue durée dans les applications navigateur.
/v1/auth/logoutTermine la session utilisateur actuelle en invalidant tous les jetons et supprimant les cookies d'authentification. Supprime la session du magasin de sessions côté serveur. Supporte un paramètre de chemin platform optionnel. Retourne 204 No Content en cas de succès.
/v1/auth/revoke-user-sessions/{user_id}Termine de force toutes les sessions actives pour un utilisateur spécifique sur tous les appareils et plateformes. Utilisé pour les incidents de sécurité ou lorsque l'accès d'un utilisateur doit être immédiatement révoqué. Retourne le nombre de sessions révoquées. Nécessite le rôle admin ou superutilisateur.
Points d'accès permettant aux utilisateurs de gérer leurs propres profils, consulter leurs informations et mettre à jour leurs paramètres.
/v1/users/meRetourne le profil complet de l'utilisateur actuellement authentifié incluant l'email, le nom d'affichage, l'organisation, les rôles, les permissions, le statut MFA, la date de création et l'horodatage de dernière connexion. Utilisé par les applications frontend pour remplir les tableaux de bord utilisateur et vérifier les permissions.
/v1/users/mePermet aux utilisateurs de mettre à jour leurs propres informations de profil incluant le nom d'affichage, le numéro de téléphone et le mot de passe. Si le mot de passe est changé, toutes les autres sessions sont automatiquement terminées pour la sécurité. Nécessite la vérification du mot de passe actuel pour les changements sensibles.
/v1/auth/meRetourne le profil utilisateur actuel avec les drapeaux de fonctionnalités évalués pour le locataire de l'utilisateur et les remplacements spécifiques à l'utilisateur. Utilisé par les applications frontend pour déterminer quelles fonctionnalités afficher selon le niveau d'abonnement et les expériences activées.
/v1/users/createPoint d'accès public pour les nouveaux utilisateurs pour créer un compte. Accepte l'email et le mot de passe, crée l'utilisateur dans le système et envoie un email de vérification. Limité à 2 requêtes par heure par IP pour prévenir les abus. Retourne l'objet utilisateur créé.
Support MFA complet incluant TOTP (applications d'authentification), passkeys WebAuthn et vérification vocale. Les utilisateurs peuvent activer plusieurs méthodes pour une sécurité renforcée.
/v1/portal/mfa/totp/enableGénère un nouveau secret TOTP et le retourne avec une image de code QR (encodée en base64) pour scanner avec des applications d'authentification comme Google Authenticator, Authy ou 1Password. Le secret est stocké en état en attente jusqu'à vérification.
/v1/portal/mfa/totp/verify-and-activateVérifie un code TOTP de l'application d'authentification de l'utilisateur et active le MFA TOTP pour son compte. Nécessite le code à 6 chiffres de l'application d'authentification. Une fois activé, TOTP sera requis pour toutes les connexions futures.
/v1/portal/mfa/totp/disableDésactive le MFA basé sur TOTP pour l'utilisateur actuel. Toutes les sessions actives sont terminées pour la sécurité après désactivation. L'utilisateur doit avoir une autre méthode MFA activée ou le MFA ne doit pas être requis par la politique de l'organisation.
/v1/mfa/verify-loginValide le code MFA (TOTP) pendant le flux de défi de connexion. Appelé après la connexion initiale lorsque MFA est requis. Nécessite le cookie de défi TF_AUTH et le code TOTP à 6 chiffres. En cas de succès, émet les jetons d'accès complets.
/v1/portal/mfa/passkey/generate-registrationGénère les options d'enregistrement WebAuthn pour créer une nouvelle credential passkey. Retourne le défi, les informations de la partie de confiance et les algorithmes supportés. Utilisé par l'API WebAuthn du navigateur (navigator.credentials.create) pour créer une nouvelle passkey.
/v1/portal/mfa/passkey/verify-registrationVérifie la réponse d'attestation WebAuthn du navigateur et sauvegarde la nouvelle credential passkey. Stocke la clé publique, l'ID de credential et les métadonnées. Les utilisateurs peuvent enregistrer plusieurs passkeys pour différents appareils.
/v1/portal/mfa/passkey/{credential_id}Supprime une credential passkey spécifique par son ID. Les utilisateurs peuvent gérer leurs passkeys enregistrées et supprimer les anciens appareils ou ceux compromis. Retourne 204 No Content en cas de succès.
/v1/portal/mfa/passkey/generate-authenticationGénère les options d'authentification WebAuthn pour la connexion basée sur passkey. Accepte l'adresse email et retourne le défi avec les credentials autorisées. Utilisé par navigator.credentials.get pour l'initiation de connexion sans mot de passe.
/v1/portal/mfa/passkey/verify-authenticationVérifie la réponse d'assertion WebAuthn et complète la connexion basée sur passkey. En cas de vérification réussie, émet les jetons d'accès complets et les cookies. Supporte redirect_uri pour la navigation post-connexion.
/v1/portal/mfa/voice/enrollEnregistre un échantillon vocal pour le MFA basé sur la voix. Accepte des données audio encodées en base64 de l'utilisateur prononçant une phrase de passe. L'empreinte vocale est traitée et stockée pour vérification future. Nécessite plusieurs échantillons pour un enregistrement précis.
/v1/portal/mfa/voice/verifyVérifie un échantillon vocal contre le profil vocal enregistré lors du défi MFA. Accepte l'audio encodé en base64 et retourne un score de correspondance. Nécessite le cookie de défi MFA. Utilisé comme alternative au TOTP pour les utilisateurs qui préfèrent l'authentification vocale.
/v1/portal/mfa/voiceDésactive le MFA basé sur la voix et supprime le profil vocal stocké. Retourne 204 No Content en cas de succès. L'utilisateur doit avoir une autre méthode MFA activée si MFA est requis par la politique de l'organisation.
/v1/portal/mfa/challenge-infoRetourne les informations sur les méthodes MFA disponibles pour le défi de connexion en attente. La réponse inclut les drapeaux totp_enabled, voice_enabled et passkey_enabled. Utilisé par l'interface de connexion pour afficher les options MFA appropriées.
Intégration SSO basée sur OAuth2/OIDC avec les fournisseurs d'identité d'entreprise incluant Google Workspace et Microsoft Entra ID (Azure AD).
/v1/portal/sso/available-providersRetourne une liste des fournisseurs SSO configurés pour le locataire actuel. La réponse inclut les noms des fournisseurs et le nombre. Utilisé par l'interface de connexion pour afficher les boutons de connexion SSO disponibles (ex: 'Se connecter avec Google', 'Se connecter avec Microsoft').
/v1/portal/login/{provider}Initie le flux d'autorisation OAuth2/OIDC avec le fournisseur d'identité spécifié. Redirige l'utilisateur vers la page de connexion du fournisseur (Google, Microsoft). Accepte redirect_uri pour la navigation post-connexion.
/v1/portal/auth/{provider}Point d'accès de callback OAuth2/OIDC qui gère le code d'autorisation retourné par le fournisseur d'identité. Échange le code contre des jetons, crée ou met à jour le compte utilisateur et établit la session avec les cookies.
Créez et gérez les clés API pour l'accès programmatique. Les clés API peuvent être limitées à des plateformes spécifiques et avoir une expiration configurable.
/v1/portal/users/me/keysCrée une nouvelle clé API pour l'accès programmatique. La clé complète n'est retournée qu'une seule fois à la création - stockez-la en sécurité. Supporte le cadrage par plateforme et une date d'expiration optionnelle. Retourne le préfixe de clé pour identification.
/v1/portal/users/me/keysRetourne toutes les clés API pour l'utilisateur actuel. Affiche le préfixe de clé, la date de création, la date de dernière utilisation et les plateformes associées. Ne retourne pas la valeur complète de la clé pour la sécurité.
/v1/portal/users/me/keys/{key_id}Révoque définitivement une clé API, invalidant immédiatement tous les jetons émis avec cette clé. Toutes les applications utilisant cette clé perdront immédiatement l'accès. Ne peut pas être annulé.
Points d'accès administratifs pour la gestion des utilisateurs, rôles et permissions. L'accès varie selon la hiérarchie des rôles.
/v1/portal/admin/usersRetourne tous les utilisateurs selon le rôle de l'appelant. Les gestionnaires voient uniquement les utilisateurs de leur organisation. Les superutilisateurs voient tous les utilisateurs de toutes les organisations. Supporte la pagination et le filtrage par rôle, statut et organisation.
/v1/portal/admin/usersCrée un nouvel utilisateur avec l'email, le mot de passe, les rôles et l'affectation d'organisation spécifiés. Envoie optionnellement un email de bienvenue. Peut attribuer l'accès initial aux plateformes et le niveau d'habilitation de sécurité. Superutilisateur uniquement.
/v1/portal/admin/users/{user_id}Retourne les informations détaillées de l'utilisateur incluant le profil, les rôles, les permissions, le statut MFA et l'historique d'activité. Les gestionnaires ne peuvent voir que les utilisateurs de leur organisation.
/v1/portal/admin/users/{user_id}Met à jour les détails de l'utilisateur incluant les rôles, les permissions, l'accès aux plateformes et l'habilitation de sécurité. Peut activer/désactiver les utilisateurs. Les changements de rôle prennent effet au prochain rafraîchissement de jeton. Superutilisateur uniquement pour les changements inter-organisations.
/v1/portal/admin/users/{user_id}Supprime définitivement un compte utilisateur et toutes les données associées incluant les clés API et les sessions. Cette action est irréversible. Superutilisateur uniquement. Les utilisateurs supprimés ne peuvent pas être récupérés.
/v1/users/{user_id}/permissionsMet à jour les permissions granulaires d'un utilisateur indépendamment de ses permissions basées sur les rôles. Permet un contrôle d'accès précis. Admin ou superutilisateur uniquement. Retourne l'ensemble des permissions mis à jour.
Définissez des rôles personnalisés et des permissions granulaires pour un contrôle d'accès précis au sein des organisations.
/v1/rolesRetourne tous les rôles disponibles dans le système incluant les rôles intégrés (admin, gestionnaire, analyste, lecteur) et les rôles personnalisés définis pour l'organisation. Inclut les permissions associées à chaque rôle.
/v1/rolesCrée un nouveau rôle personnalisé avec les permissions spécifiées. Les rôles personnalisés étendent la hiérarchie des rôles intégrés. Superutilisateur uniquement. Les noms de rôle doivent être uniques au sein de l'organisation.
/v1/roles/{role_id}Met à jour le nom, la description ou les permissions d'un rôle personnalisé. Les changements affectent tous les utilisateurs ayant ce rôle au prochain rafraîchissement de jeton. Ne peut pas modifier les rôles intégrés. Superutilisateur uniquement.
/v1/roles/{role_id}Supprime un rôle personnalisé. Les utilisateurs ayant ce rôle perdront les permissions associées. Ne peut pas supprimer les rôles actuellement attribués à des utilisateurs. Ne peut pas supprimer les rôles intégrés. Superutilisateur uniquement.
Contrôlez la disponibilité des fonctionnalités au niveau locataire et utilisateur pour des déploiements progressifs et tests A/B.
/v1/feature-flags/tenantRetourne tous les drapeaux de fonctionnalités et leurs valeurs pour le locataire actuel. Ce sont les drapeaux de base qui s'appliquent à tous les utilisateurs de l'organisation sauf s'ils sont remplacés au niveau utilisateur.
/v1/feature-flags/tenantMet à jour les drapeaux de fonctionnalités pour le locataire. Les changements s'appliquent à tous les utilisateurs de l'organisation sauf s'ils ont des remplacements au niveau utilisateur. Utilisé pour activer/désactiver des fonctionnalités pour toute l'organisation.
/v1/feature-flags/user/{user_id}Retourne les remplacements de drapeaux de fonctionnalités spécifiques à l'utilisateur. Ceux-ci remplacent les drapeaux au niveau locataire pour les utilisateurs individuels. Utilisé pour les tests bêta avec des utilisateurs spécifiques ou pour fournir des fonctionnalités premium à des comptes sélectionnés.
/v1/feature-flags/user/{user_id}Définit les remplacements de drapeaux de fonctionnalités spécifiques à l'utilisateur. Les remplacements ne peuvent être qu'un sous-ensemble des drapeaux de l'organisation - ne peut pas activer des drapeaux non disponibles pour le locataire. Retourne les drapeaux utilisateur mis à jour.
Gérez la hiérarchie multi-locataire incluant les Intégrateurs Systèmes (IS) qui revendent et gèrent les déploiements Public Safety pour leurs clients.
/v1/systems-integratorsCrée une nouvelle organisation Intégrateur Système qui peut gérer plusieurs locataires clients. Admin Vectis Consilium uniquement. L'IS reçoit son propre portail admin et peut créer/gérer les déploiements clients.
/v1/systems-integratorsRetourne tous les Intégrateurs Systèmes de la plateforme. Admin Vectis Consilium uniquement. Inclut les métadonnées comme le nombre de clients, le niveau d'abonnement et les informations de contact.
/v1/systems-integrators/{si_id}Retourne les informations détaillées sur un Intégrateur Système spécifique incluant leurs clients, statistiques d'utilisation et configuration. Les admins IS ne peuvent accéder qu'à leur propre IS.
/v1/systems-integrators/{si_id}/customersRetourne tous les locataires clients gérés par un Intégrateur Système. Les admins IS ne peuvent voir que leurs propres clients. Inclut le statut du locataire, le nombre d'utilisateurs et l'activation des fonctionnalités.
/v1/systems-integrators/{si_id}/customersCrée un nouveau locataire client sous un Intégrateur Système. L'IS devient l'entité gestionnaire pour la facturation et le support. Configure les fonctionnalités initiales selon le niveau d'abonnement de l'IS.
/v1/tenants/{tenant_id}Retourne les informations détaillées sur un locataire spécifique incluant la configuration, les fonctionnalités, les quotas d'utilisation et le statut de facturation. Les admins IS ne peuvent accéder qu'aux locataires qu'ils gèrent.
/v1/tenants/{tenant_id}Met à jour la configuration du locataire incluant le nom, les fonctionnalités, les quotas et les métadonnées. Utilisé pour activer/désactiver des fonctionnalités ou ajuster les limites de ressources pour un client.
/v1/tenants/{tenant_id}Archive ou supprime un locataire et toutes les données associées. Admin Vectis Consilium uniquement. Les données sont conservées 30 jours avant suppression permanente. Utilisé lors du départ d'un client ou du nettoyage.
Points d'accès de configuration administrative et utilitaires.
/v1/portal/admin/configRetourne les données de configuration pour l'interface admin incluant les rôles disponibles, le catalogue des permissions, la liste des pays, les plateformes supportées et la disponibilité des fonctionnalités. Utilisé pour remplir les menus déroulants et formulaires du tableau de bord admin.
/v1/portal/data/countriesRetourne une liste de tous les pays avec leurs régions/états pour les formulaires d'adresse. Inclut les codes ISO, les noms et les subdivisions. Point d'accès public utilisé par les formulaires d'inscription et de profil.
/healthPoint d'accès de vérification de santé simple qui retourne le statut du service. Utilisé par les équilibreurs de charge et les systèmes de surveillance. Retourne status: healthy, service: auth_service.
/v1/platforms/supportedRetourne la liste des plateformes qui peuvent être spécifiées lors de l'émission de jetons. Les plateformes représentent différents produits/modules Public Safety auxquels un utilisateur pourrait accéder. Récupéré depuis la configuration Firestore.
/audit/logsRetourne les journaux d'audit de sécurité pour le service d'authentification. Inclut les tentatives de connexion, les changements de permissions et les actions administratives. Administrateur avec permission d'audit requis.
Le Service API (api.knogin.com) est la plateforme de renseignement principale fournissant plus de 130 points d'accès REST pour les enquêtes, cas, profils, preuves, alertes, services IA, communication en temps réel et plus encore. Tous les points d'accès nécessitent une authentification sauf indication contraire.
Points d'accès de surveillance de la santé du système et de découverte des capacités pour l'intégration et la surveillance.
/api/v1/healthRetourne le statut de santé détaillé de tous les composants système incluant la base de données graphe Neo4j, la base de données relationnelle PostgreSQL, le cache Redis, les services IA (OpenAI, Anthropic, Google AI) et les intégrations externes. La réponse inclut les métriques de latence et le statut de connexion pour chaque composant. Utilisé pour la surveillance opérationnelle et la réponse aux incidents.
/api/v1/health/simpleVérification de santé légère retournant une réponse minimale pour les équilibreurs de charge et les systèmes d'orchestration (Kubernetes, Cloud Run). Retourne 200 OK si le service fonctionne. Ne vérifie pas les dépendances en aval pour un temps de réponse plus rapide.
/api/v1/health/db-checkVérifie la connectivité à tous les systèmes de base de données (Neo4j, PostgreSQL, Firestore). Retourne le statut individuel pour chaque base de données. Utilisé pour la vérification de déploiement et le dépannage des problèmes de connectivité.
/api/v1/health/connectivityVérifie la connectivité à tous les services externes incluant les fournisseurs IA, les sources de données OSINT, les systèmes de stockage et les services de notification. Retourne le statut détaillé pour chaque point d'intégration.
/api/v1/capabilitiesRetourne les capacités système complètes pour la configuration frontend incluant les domaines supportés, les fournisseurs OSINT disponibles, les formats de fichiers acceptés, les points d'accès API, les fonctionnalités activées, les limites de taux et les tailles maximales de fichiers. Essentiel pour la configuration dynamique de l'interface.
Traitement de documents propulsé par IA pour l'extraction d'entités, relations et renseignements à partir de fichiers texte, images, audio et vidéo.
/api/v1/intelligence/process-textTéléversez et traitez des fichiers texte, PDF ou DOCX pour enquête. Utilise l'IA pour extraire les entités (personnes, organisations, lieux), les relations, les événements et les renseignements clés des documents. Supporte les fichiers jusqu'à 50 Mo. Les résultats sont stockés et liés à l'enquête.
/api/v1/intelligence/process-text/base64Point d'accès compatible Cloudflare pour le traitement des fichiers documents encodés en base64. Accepte un corps JSON avec file_content, filename et mime_type. Supporte les formats .txt, .pdf et .docx. Idéal pour les environnements serverless.
/api/v1/process-image-fileTéléversez et traitez des images pour l'analyse visuelle propulsée par IA. Effectue l'extraction de texte OCR, la détection d'objets, la détection de visages, l'identification de lieux et la classification de scènes. Supporte les formats JPEG, PNG, GIF et WebP.
/api/v1/process-image-file/base64Point d'accès compatible Cloudflare pour le traitement des images encodées en base64. Retourne le texte extrait, les objets détectés, les visages et les lieux identifiés. Idéal pour les environnements serverless avec des limites de taille de corps de requête.
/api/v1/process-audio-fileTéléversez et traitez des fichiers audio pour la transcription et l'identification des locuteurs. Utilise la reconnaissance vocale avancée et la diarisation des locuteurs. Supporte les formats MP3, WAV, OGG et M4A jusqu'à 100 Mo.
/api/v1/process-audio-file/base64Point d'accès compatible Cloudflare pour le traitement de l'audio encodé en base64. Retourne la transcription complète avec les horodatages et les étiquettes de locuteurs. Note : les gros fichiers audio devraient utiliser le point d'accès de téléversement direct.
/api/v1/process-video-fileTéléversez et traitez des fichiers vidéo pour une analyse complète. Extrait la transcription audio, détecte les visages à travers les images, identifie les scènes et objets, et génère une chronologie visuelle. Supporte MP4, MOV, AVI, WebM jusqu'à 500 Mo.
/api/v1/process-video-file/base64Point d'accès compatible Cloudflare pour le traitement de la vidéo encodée en base64. Limité aux fichiers plus petits en raison de la surcharge d'encodage. Pour les vidéos plus grandes, utilisez le téléversement par URL présignée.
Créez, mettez à jour et enrichissez les profils d'entités avec des données de fournisseurs OSINT. Supporte les opérations individuelles et par lots.
/api/v1/profilesCrée un nouveau profil d'entité (personne, organisation, véhicule, etc.). Accepte les données initiales et valide/normalise automatiquement les champs. Déclenche l'enrichissement en arrière-plan si auto_enrich est activé.
/api/v1/profiles/{profile_id}Retourne les données complètes du profil incluant tous les attributs, les entités liées, la chronologie et les données d'enrichissement. Supporte la sélection de champs pour l'optimisation des performances.
/api/v1/profiles/{profile_id}Met à jour les champs du profil. Supporte les mises à jour partielles. Maintient une piste d'audit de tous les changements. Déclenche un ré-enrichissement si les champs d'identification principaux sont modifiés.
/api/v1/profiles/{profile_id}Supprime doucement un profil et toutes les données liées. Le profil peut être récupéré dans les 30 jours. Suppression permanente après la période de rétention. La piste d'audit est préservée.
/api/v1/profiles/{profile_id}/enrichEnrichit un profil avec des données de fournisseurs OSINT. Spécifiez optionnellement quels fournisseurs utiliser (social, criminel, financier, etc.). Retourne les données agrégées incluant la présence sur les réseaux sociaux, les registres publics et le renseignement open source.
/api/v1/batch/profilesRécupère plusieurs profils par ID en une seule requête. Maximum 100 profils par requête. Retourne les profils dans le même ordre que les ID demandés. Les profils manquants retournent null.
/api/v1/batch/enrichEnrichit plusieurs profils en une seule requête. Maximum 10 profils par requête pour gérer les limites de taux des fournisseurs. Retourne le statut de succès/échec individuel pour chaque profil.
/api/v1/profiles/searchRecherche plein texte à travers tous les champs de profil. Supporte les filtres par type, statut, plage de dates et champs personnalisés. Retourne des résultats paginés avec un score de pertinence.
/api/v1/profiles/linkCrée une relation entre deux profils (ex: 'travaille_pour', 'lié_à', 'possède'). Stocke les métadonnées et preuves de la relation. Les relations bidirectionnelles sont créées automatiquement.
/api/v1/profiles/linkSupprime une relation entre deux profils. Maintient une piste d'audit de la suppression. Les données de la relation originale sont préservées pour la conformité.
Gérez les enquêtes, cas, tâches et le cycle de vie complet des enquêtes.
/api/v1/investigationsCrée un nouvel espace de travail d'enquête avec titre, description et niveau de classification. Attribue automatiquement le créateur comme enquêteur principal. Retourne l'ID de l'enquête pour les opérations suivantes.
/api/v1/investigations/{investigation_id}Retourne les détails complets de l'enquête incluant les métadonnées, les membres de l'équipe, les cas, les profils, les fichiers et la chronologie des activités. Supporte la sélection de champs pour les grandes enquêtes.
/api/v1/investigations/{investigation_id}Met à jour les métadonnées de l'enquête incluant le titre, la description, le statut et la classification. Les changements déclenchent des notifications aux membres de l'équipe. Journalisé dans l'audit.
/api/v1/investigations/{investigation_id}Supprime doucement une enquête et toutes les données contenues. Nécessite confirmation pour les enquêtes avec des cas actifs. Données conservées pour la période de conformité.
/api/v1/investigationsRetourne les enquêtes accessibles à l'utilisateur actuel. Supporte le filtrage par statut, date, membre de l'équipe et requête de recherche. Paginé avec options de tri.
/api/v1/investigations/{investigation_id}/filesAssocie les fichiers téléversés à une enquête. Les fichiers sont automatiquement mis en file d'attente pour le traitement IA selon le type. Déclenche l'indexation pour la recherche.
Configurez les règles de surveillance et gérez les alertes déclenchées par les flux de données en temps réel.
/api/v1/alertsCrée programmatiquement une alerte. Typiquement les alertes sont créées par les moniteurs, mais la création manuelle est supportée pour les intégrations. Nécessite un titre, une sévérité et au moins une référence d'entité.
/api/v1/alerts/{alert_id}Retourne les détails complets de l'alerte incluant les données déclenchantes, les entités correspondantes, l'historique des décisions et les enquêtes liées. Supporte l'expansion des entités liées.
/api/v1/alerts/{alert_id}Met à jour les métadonnées ou le statut de l'alerte. Les transitions de statut sont validées (ex: ne peut pas rouvrir une alerte rejetée). Tous les changements sont journalisés avec l'utilisateur et l'horodatage.
/api/v1/alerts/{alert_id}/decideEnregistre une décision sur une alerte : escalader, enquêter, rejeter ou faux positif. La décision inclut la justification et la disposition optionnelle de l'entité. Les alertes fermées peuvent déclencher des workflows de suivi.
/api/v1/alertsRetourne les alertes correspondant aux critères de filtre. Supporte le filtrage par sévérité, statut, moniteur, plage de dates et entité. Paginé avec taille de page configurable.
Configurez les règles de surveillance et gérez les alertes déclenchées par les flux de données en temps réel.
/api/v1/monitorsCrée une règle de surveillance qui déclenche des alertes basées sur les patterns de flux de données. Supporte des conditions complexes avec correspondance d'entités, limites géographiques, patterns temporels et déclencheurs de seuils.
/api/v1/monitors/{monitor_id}Retourne la configuration et les statistiques du moniteur incluant le compte d'alertes, le dernier temps de déclenchement et les métriques de performance. Inclut les détails des conditions et les paramètres de notification.
/api/v1/monitors/{monitor_id}Met à jour les conditions, seuils ou paramètres de notification du moniteur. Les changements prennent effet immédiatement. Mettre en pause un moniteur arrête les nouvelles alertes mais préserve l'historique.
/api/v1/monitors/{monitor_id}Supprime définitivement un moniteur. Les alertes associées sont préservées mais marquées comme orphelines. Considérez la mise en pause plutôt pour préserver la piste d'audit.
/api/v1/monitorsRetourne tous les moniteurs pour le locataire actuel. Supporte le filtrage par statut, type et activité d'alertes. Inclut les statistiques résumées pour chaque moniteur.
/api/v1/ai/generate-monitor-specUtilise l'IA pour convertir des descriptions en langage naturel en spécifications de moniteur structurées. Inclut l'analyse de sécurité, l'extraction de paramètres et l'estimation du volume d'alertes. Aide les utilisateurs non techniques à créer des moniteurs complexes.
Accès direct aux capacités IA incluant l'analyse de texte, l'extraction d'entités, la cartographie des relations et le traitement du langage naturel.
/api/v1/ai/analyze-textEffectue une analyse IA complète sur le contenu textuel. Extrait les entités, relations, événements, sentiment et thèmes clés. Supporte plusieurs langues avec détection automatique.
/api/v1/ai/generate-graphCrée un graphe de connaissances à partir de texte non structuré. Identifie les entités, infère les relations et génère des données de graphe structurées adaptées à la visualisation ou à l'import Neo4j.
/api/v1/ai/summarizeGénère des résumés concis de contenu long. Supporte plusieurs longueurs et styles de résumé (exécutif, technique, points). Préserve les entités et faits clés.
/api/v1/ai/translateTraduit le contenu entre les langues supportées tout en préservant les noms d'entités et les termes techniques. Retourne à la fois la traduction et la langue source détectée.
/api/v1/ai/extract-entitiesExtrait et classifie les entités nommées du texte. Retourne les étendues d'entités, types, scores de confiance et identifiants résolus lorsque disponibles. Supporte les types d'entités personnalisés.
Téléversez, téléchargez et gérez les fichiers avec application complète du RBAC et journalisation d'audit.
/api/v1/filesTéléverse un fichier vers le stockage sécurisé. Détecte automatiquement le type de fichier et met en file d'attente pour le traitement approprié. Retourne l'ID du fichier et le statut de traitement. Supporte les téléversements par morceaux pour les gros fichiers.
/api/v1/files/{file_id}/downloadTélécharge un fichier avec application complète du RBAC et journalisation d'audit. Vérifie que l'utilisateur a accès à l'enquête/cas associé. Supporte les requêtes de plage pour les gros fichiers. Retourne le fichier avec les en-têtes content-type appropriés.
/api/v1/files/{file_id}/streamDiffuse un fichier pour le chargement progressif des gros fichiers. Supporte les requêtes de plage HTTP pour le positionnement dans les fichiers audio/vidéo. Plus efficace que le téléchargement complet pour les gros fichiers médias.
/api/v1/files/{file_id}/presigned-urlGénère une URL présignée à durée limitée pour l'accès direct aux fichiers depuis le stockage Cloudflare R2. L'URL expire après une durée configurable (par défaut 1 heure). Utile pour intégrer des fichiers dans des rapports ou partager avec des outils externes.
/api/v1/admin/filesRetourne tous les fichiers du système avec les métadonnées et statistiques d'accès. Admin ou superutilisateur uniquement. Supporte le filtrage par locataire pour les déploiements multi-locataires. Utilisé pour la gestion du stockage et l'audit.
/api/v1/admin/files/{file_id}/auditRetourne la piste d'audit complète pour un fichier spécifique incluant tous les événements d'accès, téléchargements et modifications. Admin ou superutilisateur uniquement. Essentiel pour la documentation de chaîne de garde.
Points d'accès API auto-descriptifs pour l'intégration dynamique et la documentation.
/api/v1/docs/endpointsRetourne la documentation complète de tous les points d'accès API incluant les chemins, méthodes, paramètres et schémas de réponse. Utilisé pour générer les SDK clients et la documentation d'intégration.
/api/v1/metadata/domainsRetourne les métadonnées sur tous les domaines disponibles (types d'entités) incluant leurs propriétés, relations et configuration UI. Essentiel pour construire des interfaces dynamiques qui s'adaptent aux changements de schéma.
/api/v1/metadata/enumsRetourne tous les types d'énumération utilisés dans l'API incluant les codes de statut, niveaux de priorité, niveaux de classification et autres valeurs catégorielles. Utilisé pour remplir les menus déroulants.
/api/v1/metadata/providersRetourne les métadonnées sur les fournisseurs OSINT et de données disponibles incluant les capacités, limites de taux et identifiants requis. Utilisé pour configurer les préférences de sources de données.
Pistes d'audit cryptographiques avec vérification par arbre de Merkle pour une journalisation inviolable.
/api/v1/audit/anchor/latestRetourne le hash racine de l'arbre de Merkle le plus récent ancrant le journal d'audit. Utilisé pour la vérification cryptographique de l'intégrité du journal. L'ancre est périodiquement publiée sur la blockchain pour l'immuabilité.
/api/v1/audit/anchor/proof/{entry_id}Retourne une preuve d'inclusion Merkle pour une entrée d'audit spécifique. La preuve peut être vérifiée indépendamment contre l'ancre publiée. Essentielle pour les exigences de chaîne de garde médico-légale.
AI-assisted mission planning and operational support.
/api/v1/mission-plansPlanification de mission assistée par IA basée sur la description du scénario, les profils cibles, les contraintes géographiques et l'évaluation des menaces. Retourne un plan structuré avec allocation des ressources, chronologie et contingences.
/api/v1/mission-plans/{plan_id}Affine itérativement un plan de mission existant basé sur de nouvelles contraintes ou retours. Maintient l'historique des plans pour comparaison. Supporte les mises à jour partielles de sections spécifiques du plan.
Gestion complète du cycle de vie des dossiers avec flux de travail, affectations, modèles et suivi chronologique.
/api/v1/casesCrée un nouveau dossier au sein d'une enquête avec titre, description, priorité, statut et utilisateur assigné.
/api/v1/cases/{case_id}Retourne les détails complets du dossier incluant métadonnées, utilisateurs assignés, profils liés, tâches, notes et chronologie.
/api/v1/cases/{case_id}Met à jour les métadonnées du dossier incluant titre, description, priorité, statut, date limite et champs personnalisés.
/api/v1/cases/{case_id}Suppression douce d'un dossier et toutes les données associées. Les données sont conservées pour la période de conformité.
/api/v1/casesRetourne les dossiers avec filtrage par enquête, statut, priorité, assigné, plage de dates et tags.
/api/v1/cases/{case_id}/assignAssigne ou réassigne un dossier à un utilisateur ou une équipe. Supporte plusieurs assignés.
/api/v1/cases/{case_id}/statusMet à jour le statut du dossier avec validation du flux de travail.
/api/v1/cases/{case_id}/link-profileAssocie un profil d'entité à un dossier en spécifiant le type de relation.
/api/v1/cases/{case_id}/link-profile/{profile_id}Supprime l'association entre un profil et un dossier.
/api/v1/cases/{case_id}/timelineRetourne la chronologie complète d'activité du dossier.
/api/v1/cases/bulk-updateMet à jour plusieurs dossiers en une seule requête.
/api/v1/cases/from-templateCrée un nouveau dossier à partir d'un modèle prédéfini.
Créer et gérer des tâches avec affectations, listes de contrôle, dépendances et suivi de progression.
/api/v1/tasksCrée une nouvelle tâche au sein d'un dossier avec titre, description, assigné et date limite.
/api/v1/tasks/{task_id}Retourne les détails complets de la tâche incluant liste de contrôle et sous-tâches.
/api/v1/tasks/{task_id}Met à jour les champs de la tâche incluant titre, description, date limite et progression.
/api/v1/tasks/{task_id}Supprime une tâche et optionnellement ses sous-tâches.
/api/v1/cases/{case_id}/tasksRetourne toutes les tâches d'un dossier avec filtrage.
/api/v1/tasks/{task_id}/assignAssigne ou réassigne une tâche à un utilisateur.
/api/v1/tasks/{task_id}/completeMarque une tâche comme complétée avec notes optionnelles.
/api/v1/tasks/{task_id}/checklistMet à jour les éléments de la liste de contrôle d'une tâche.
/api/v1/tasks/my-tasksRetourne toutes les tâches assignées à l'utilisateur courant.
/api/v1/tasks/bulk-updateMet à jour plusieurs tâches en une seule requête.
Notes d'enquête avec texte enrichi, fils de discussion, pièces jointes et contrôles de visibilité.
/api/v1/notesCrée une nouvelle note attachée à un dossier ou enquête avec texte enrichi et mentions.
/api/v1/notes/{note_id}Retourne le contenu de la note avec métadonnées, pièces jointes et réponses.
/api/v1/notes/{note_id}Met à jour le contenu ou métadonnées de la note. Maintient l'historique des versions.
/api/v1/notes/{note_id}Suppression douce d'une note. Le contenu est conservé pour la conformité.
/api/v1/cases/{case_id}/notesRetourne toutes les notes d'un dossier respectant les règles de visibilité.
/api/v1/notes/{note_id}/attachmentsAttache un fichier à une note existante.
/api/v1/notes/{note_id}/replyCrée une réponse en fil à une note existante.
Gérer les pièces jointes avec traitement, chaîne de possession et vérification d'intégrité.
/api/v1/attachmentsTéléverse et attache un fichier à un dossier, note ou tâche.
/api/v1/attachments/{attachment_id}Retourne les métadonnées de la pièce jointe incluant le statut de traitement.
/api/v1/attachments/{attachment_id}Suppression douce d'une pièce jointe.
/api/v1/cases/{case_id}/attachmentsRetourne toutes les pièces jointes d'un dossier avec filtrage.
/api/v1/attachments/{attachment_id}/processDéclenche le retraitement d'une pièce jointe avec des modèles mis à jour.
/api/v1/attachments/{attachment_id}/chain-of-custodyRetourne le journal complet de chaîne de possession.
Analyse de réseaux, recherche de chemins, métriques de centralité et détection de communautés sur le graphe de connaissances.
/api/v1/graph/node/{node_id}Retourne un nœud du graphe de connaissances avec toutes ses propriétés.
/api/v1/graph/node/{node_id}/neighborsRetourne tous les nœuds directement connectés dans la profondeur spécifiée.
/api/v1/graph/pathTrouve le chemin le plus court entre deux nœuds.
/api/v1/graph/subgraphExtrait un sous-graphe autour de nœuds semences spécifiés.
/api/v1/graph/queryExécute une requête Cypher en lecture seule. Administrateurs uniquement.
/api/v1/graph/statisticsRetourne les statistiques agrégées du graphe de connaissances.
/api/v1/graph/centralityCalcule les métriques de centralité pour identifier les entités clés.
/api/v1/graph/community-detectionExécute les algorithmes de détection de communautés.
/api/v1/graph/link-predictionUtilise le ML de graphes pour prédire les relations probables.
Requêtes basées sur la localisation, clustering, cartes thermiques, routage et analyse chronologique géographique.
/api/v1/geo/searchRecherche les entités avec données de localisation correspondant aux critères spatiaux.
/api/v1/geo/within-boundsRetourne les entités dans un rectangle délimiteur.
/api/v1/geo/within-radiusRetourne les entités dans un rayon spécifié d'un point central.
/api/v1/geo/within-polygonRetourne les entités dans un polygone GeoJSON.
/api/v1/geo/clustersRetourne les données de localisation groupées pour l'affichage cartographique.
/api/v1/geo/heatmapRetourne les données de densité pour la visualisation en carte thermique.
/api/v1/geo/routeCalcule l'itinéraire optimal entre les localisations.
/api/v1/geo/timeline/{entity_id}Retourne l'historique chronologique des localisations d'une entité.
/api/v1/geo/geocodeConvertit une adresse texte en coordonnées géographiques.
/api/v1/geo/reverse-geocodeConvertit les coordonnées en une adresse lisible.
Créer des tableaux de bord personnalisables avec graphiques, cartes, métriques et vues partagées d'équipe.
/api/v1/dashboardsCrée un nouveau tableau de bord avec titre, description et configuration de mise en page.
/api/v1/dashboards/{dashboard_id}Retourne la configuration du tableau de bord incluant tous les panneaux.
/api/v1/dashboards/{dashboard_id}Met à jour les métadonnées ou la configuration de mise en page.
/api/v1/dashboards/{dashboard_id}Supprime un tableau de bord et tous ses panneaux.
/api/v1/dashboardsRetourne tous les tableaux de bord accessibles à l'utilisateur.
/api/v1/dashboards/{dashboard_id}/panelsAjoute un nouveau panneau au tableau de bord.
/api/v1/dashboards/{dashboard_id}/panels/{panel_id}Met à jour la configuration du panneau.
/api/v1/dashboards/{dashboard_id}/panels/{panel_id}Supprime un panneau du tableau de bord.
/api/v1/dashboards/{dashboard_id}/sharePartage un tableau de bord avec des utilisateurs ou équipes spécifiques.
/api/v1/dashboards/{dashboard_id}/cloneCrée une copie d'un tableau de bord avec tous les panneaux.
Générer des rapports professionnels, dossiers judiciaires et exports de données dans plusieurs formats.
/api/v1/reports/generateGénère un rapport depuis un modèle ou une configuration personnalisée.
/api/v1/reports/{report_id}Retourne les métadonnées du rapport incluant le statut de génération.
/api/v1/reports/{report_id}/downloadTélécharge un fichier de rapport généré.
/api/v1/reportsRetourne tous les rapports générés par l'utilisateur ou l'équipe.
/api/v1/reports/{report_id}Supprime un fichier de rapport généré.
/api/v1/exports/case/{case_id}Exporte un package complet du dossier.
/api/v1/exports/investigation/{investigation_id}Exporte une enquête complète avec tous les dossiers.
/api/v1/exports/court-packageGénère un package de preuves prêt pour le tribunal.
/api/v1/reports/templatesRetourne les modèles de rapport disponibles.
/api/v1/reports/schedulePlanifie la génération automatique de rapports.
Recherche plein texte globale, recherche sémantique et capacités de requête avancées sur toutes les données.
/api/v1/searchRecherche plein texte dans toutes les données accessibles.
/api/v1/search/entitiesRecherche spécifique dans les profils d'entités.
/api/v1/search/documentsRecherche dans le contenu des documents.
/api/v1/search/advancedRecherche structurée avec requêtes booléennes complexes.
/api/v1/search/semanticRecherche sémantique par IA comprenant l'intention.
/api/v1/search/suggestionsRetourne les suggestions d'autocomplétion.
/api/v1/search/historyRetourne les requêtes de recherche récentes de l'utilisateur.
/api/v1/search/saveSauvegarde une requête de recherche pour accès rapide.
Organiser les entités avec des tags pour la catégorisation, le filtrage et la découverte inter-domaines.
/api/v1/tagsCrée un nouveau tag avec nom, couleur et description optionnelle.
/api/v1/tagsRetourne tous les tags disponibles avec les compteurs d'utilisation.
/api/v1/tags/{tag_id}Met à jour les propriétés du tag.
/api/v1/tags/{tag_id}Supprime un tag de toutes les entités.
/api/v1/tags/applyApplique des tags à une entité.
/api/v1/tags/removeRetire les tags spécifiés d'une entité.
/api/v1/tags/{tag_id}/entitiesRetourne toutes les entités avec un tag spécifique.
Commentaires en fils avec mentions, réactions et fonctionnalités de collaboration en temps réel.
/api/v1/commentsCrée un commentaire sur n'importe quelle entité avec mentions et formatage.
/api/v1/comments/{comment_id}Retourne un commentaire avec métadonnées, réponses et réactions.
/api/v1/comments/{comment_id}Met à jour le contenu du commentaire. L'historique est préservé.
/api/v1/comments/{comment_id}Supprime un commentaire. Les réponses restent visibles.
/api/v1/{entity_type}/{entity_id}/commentsRetourne tous les commentaires d'une entité spécifique.
/api/v1/comments/{comment_id}/replyCrée une réponse en fil à un commentaire.
/api/v1/comments/{comment_id}/reactAjoute ou retire une réaction emoji à un commentaire.
Gérer les notifications à travers les canaux avec préférences personnalisables et heures calmes.
/api/v1/notificationsRetourne toutes les notifications de l'utilisateur courant.
/api/v1/notifications/unread-countRetourne le nombre de notifications non lues.
/api/v1/notifications/{notification_id}/readMarque une notification comme lue.
/api/v1/notifications/mark-all-readMarque toutes les notifications comme lues.
/api/v1/notifications/{notification_id}Supprime définitivement une notification.
/api/v1/notifications/preferencesRetourne les préférences de notification de l'utilisateur.
/api/v1/notifications/preferencesMet à jour les préférences de notification.
Gestion d'équipes avec membres, rôles, permissions et hiérarchies organisationnelles.
/api/v1/teamsCrée une nouvelle équipe avec nom, description et membres initiaux.
/api/v1/teams/{team_id}Retourne les détails de l'équipe incluant membres et rôles.
/api/v1/teams/{team_id}Met à jour les métadonnées de l'équipe.
/api/v1/teams/{team_id}Supprime une équipe. Les membres perdent les permissions d'équipe.
/api/v1/teamsRetourne toutes les équipes que l'utilisateur peut voir.
/api/v1/teams/{team_id}/membersAjoute un utilisateur à l'équipe avec un rôle spécifié.
/api/v1/teams/{team_id}/members/{user_id}Retire un utilisateur de l'équipe.
/api/v1/teams/{team_id}/members/{user_id}/roleChange le rôle d'un membre de l'équipe.
Surveiller les entités contre les listes de surveillance avec correspondance automatique et génération d'alertes.
/api/v1/watchlistsCrée une nouvelle liste de surveillance avec critères de correspondance.
/api/v1/watchlists/{watchlist_id}Retourne la configuration de la liste de surveillance.
/api/v1/watchlists/{watchlist_id}Met à jour la configuration de la liste de surveillance.
/api/v1/watchlists/{watchlist_id}Supprime une liste de surveillance.
/api/v1/watchlistsRetourne toutes les listes de surveillance accessibles.
/api/v1/watchlists/{watchlist_id}/entitiesAjoute une entité spécifique pour surveillance.
/api/v1/watchlists/{watchlist_id}/entities/{entity_id}Retire une entité de la surveillance.
/api/v1/watchlists/{watchlist_id}/checkVérifie si une entité correspond aux critères.
/api/v1/watchlists/batch-checkVérifie plusieurs entités contre toutes les listes actives.
/api/v1/watchlists/{watchlist_id}/matchesRetourne toutes les correspondances d'une liste de surveillance.
Suivi des preuves admissibles en cour avec chaîne de possession, vérification d'intégrité et scellé.
/api/v1/evidenceCrée un enregistrement formel de preuve avec suivi de possession.
/api/v1/evidence/{evidence_id}Retourne l'enregistrement de preuve avec métadonnées et chaîne de possession.
/api/v1/evidence/{evidence_id}Met à jour les métadonnées de preuve. Le contenu scellé ne peut être modifié.
/api/v1/cases/{case_id}/evidenceRetourne tous les éléments de preuve d'un dossier.
/api/v1/evidence/{evidence_id}/custody-transferEnregistre un transfert de possession entre dépositaires.
/api/v1/evidence/{evidence_id}/chain-of-custodyRetourne l'historique complet de la chaîne de possession.
/api/v1/evidence/{evidence_id}/verify-integrityVérifie l'intégrité de la preuve en recalculant le hash.
/api/v1/evidence/{evidence_id}/sealScelle l'élément de preuve empêchant les modifications.
/api/v1/evidence/{evidence_id}/audit-trailRetourne la piste d'audit complète de la preuve.
Interroger plusieurs fournisseurs OSINT pour l'intelligence sur les personnes, organisations, téléphones, emails, réseaux sociaux, véhicules, domaines, IP et cryptomonnaies.
/api/v1/osint/providersRetourne tous les fournisseurs OSINT configurés.
/api/v1/osint/providers/{provider_id}/statusRetourne le statut détaillé d'un fournisseur OSINT.
/api/v1/osint/search/personRecherche des informations sur une personne dans les sources OSINT.
/api/v1/osint/search/organizationRecherche des informations d'organisation incluant les registres corporatifs.
/api/v1/osint/search/phoneRecherche inversée de téléphone dans les bases de données.
/api/v1/osint/search/emailRecherche d'intelligence email.
/api/v1/osint/search/socialRecherche des profils sur les réseaux sociaux.
/api/v1/osint/search/vehicleRecherche de véhicule par VIN ou plaque.
/api/v1/osint/search/domainIntelligence de domaine incluant WHOIS et DNS.
/api/v1/osint/search/ipIntelligence d'adresse IP incluant géolocalisation.
/api/v1/osint/search/cryptoAnalyse d'adresse de cryptomonnaie.
/api/v1/osint/batch-enrichEnrichit plusieurs entités avec des données OSINT.
/api/v1/osint/usageRetourne les statistiques d'utilisation des requêtes OSINT.
Modèles réutilisables pour les dossiers, rapports et flux de travail pour standardiser les processus.
/api/v1/templates/caseCrée un modèle de dossier réutilisable.
/api/v1/templates/caseRetourne tous les modèles de dossier disponibles.
/api/v1/templates/case/{template_id}Retourne la configuration complète du modèle.
/api/v1/templates/case/{template_id}Met à jour la configuration du modèle.
/api/v1/templates/case/{template_id}Supprime un modèle de dossier.
/api/v1/templates/reportCrée un modèle de rapport avec mise en page et sections.
/api/v1/templates/reportRetourne tous les modèles de rapport.
/api/v1/templates/workflowCrée un modèle de flux de travail automatisé.
/api/v1/templates/workflowRetourne tous les modèles de flux de travail.
Flux de travail automatisés avec déclencheurs, conditions et actions pour l'automatisation des enquêtes.
/api/v1/workflowsCrée un flux de travail automatisé avec déclencheurs et actions.
/api/v1/workflows/{workflow_id}Retourne la configuration du flux de travail et l'historique.
/api/v1/workflows/{workflow_id}Met à jour la configuration du flux de travail.
/api/v1/workflows/{workflow_id}Supprime un flux de travail.
/api/v1/workflowsRetourne tous les flux de travail accessibles.
/api/v1/workflows/{workflow_id}/executeDéclenche manuellement une exécution de flux de travail.
/api/v1/workflows/{workflow_id}/executionsRetourne l'historique des exécutions du flux de travail.
/api/v1/workflows/{workflow_id}/pauseMet en pause un flux de travail actif.
/api/v1/workflows/{workflow_id}/resumeReprend un flux de travail en pause.
Points d'accès de messagerie et collaboration en temps réel basés sur WebSocket.
/api/v1/channelsCrée un canal de messagerie en temps réel.
/api/v1/channels/{channel_id}Retourne les détails du canal incluant les membres.
/api/v1/channelsRetourne tous les canaux accessibles à l'utilisateur.
/api/v1/channels/{channel_id}/messagesEnvoie un message à un canal.
/api/v1/channels/{channel_id}/messagesRetourne l'historique des messages d'un canal.
/api/v1/channels/{channel_id}/membersAjoute un utilisateur à un canal.
/api/v1/channels/{channel_id}/members/{user_id}Retire un utilisateur d'un canal.
/api/v1/users/presenceRetourne le statut en ligne/hors ligne des utilisateurs.
L'API GraphQL principale (api.knogin.com/graphql) fournit plus de 100 requêtes, 80+ mutations et des abonnements en temps réel utilisant le framework Strawberry GraphQL. GraphQL offre une récupération de données flexible, permettant aux clients de demander exactement les données dont ils ont besoin en une seule requête.
POST https://api.knogin.com/graphqlGET https://api.knogin.com/graphqlCréer, gérer et suivre les enquêtes avec un support complet du cycle de vie incluant l'affectation d'équipe, la gestion des fichiers et le suivi de progression.
getInvestigation(investigationId: ID!)getInvestigations(status: [Status], limit: Int, offset: Int)investigationTimeline(investigationId: ID!)investigationStatistics(investigationId: ID!)investigationTeam(investigationId: ID!)startNewInvestigation(input: CreateInvestigationInput!)updateInvestigation(investigationId: ID!, input: UpdateInvestigationInput!)deleteInvestigation(investigationId: ID!)addFilesToInvestigation(investigationId: ID!, fileIds: [ID!]!)assignInvestigationTeam(investigationId: ID!, userIds: [ID!]!)Gestion complète des dossiers avec modèles, flux de travail, suivi de statut, liaison de profils et opérations en masse pour une gestion efficace des dossiers.
case(caseId: ID!)cases(investigationId: ID, status: [CaseStatus], priority: [Priority], limit: Int, offset: Int)caseByNumber(caseNumber: String!)caseTimeline(caseId: ID!)caseStatistics(caseId: ID!)myCases(status: [CaseStatus], limit: Int)caseTemplates(category: String)createCase(input: CreateCaseInput!)createCaseFromTemplate(templateId: ID!, input: CreateCaseInput!)updateCase(caseId: ID!, input: UpdateCaseInput!)deleteCase(caseId: ID!)assignCase(caseId: ID!, userId: ID!)updateCaseStatus(caseId: ID!, status: CaseStatus!)linkProfileToCase(caseId: ID!, profileId: ID!, role: ProfileRole!)bulkUpdateCases(caseIds: [ID!]!, input: BulkUpdateCaseInput!)Gestion des tâches avec affectations, listes de contrôle, dépendances et suivi de progression pour des flux de travail d'enquête structurés.
task(taskId: ID!)tasks(caseId: ID!, status: [TaskStatus], assignee: ID)myTasks(status: [TaskStatus], dueDate: DateRange)taskChecklist(taskId: ID!)taskDependencies(taskId: ID!)createTask(input: CreateTaskInput!)updateTask(taskId: ID!, input: UpdateTaskInput!)deleteTask(taskId: ID!)assignTask(taskId: ID!, userId: ID!)completeTask(taskId: ID!, notes: String)updateTaskChecklist(taskId: ID!, items: [ChecklistItemInput!]!)bulkUpdateTasks(taskIds: [ID!]!, input: BulkUpdateTaskInput!)Notes d'enquête avec texte enrichi, fils de discussion et pièces jointes. Suivi complet de la chaîne de possession pour les fichiers de qualité probante.
note(noteId: ID!)notes(caseId: ID!, type: NoteType, visibility: Visibility)attachment(attachmentId: ID!)attachments(caseId: ID!, fileType: String)attachmentChainOfCustody(attachmentId: ID!)createNote(input: CreateNoteInput!)updateNote(noteId: ID!, input: UpdateNoteInput!)deleteNote(noteId: ID!)replyToNote(parentNoteId: ID!, content: String!)createAttachment(input: CreateAttachmentInput!)deleteAttachment(attachmentId: ID!)reprocessAttachment(attachmentId: ID!)Gestion des profils d'entité pour personnes, organisations et autres entités avec enrichissement OSINT et cartographie des relations.
getProfile(profileId: ID!)listProfiles(type: ProfileType, tags: [String], limit: Int, offset: Int)searchProfiles(query: String!, filters: ProfileFilters)getPerson(personId: ID!)listPersons(filters: PersonFilters)getOrganization(orgId: ID!)listOrganizations(filters: OrgFilters)getEntity(entityId: ID!)searchEntities(query: String!, entityTypes: [EntityType])profileRelationships(profileId: ID!, depth: Int)createProfile(input: CreateProfileInput!)updateProfile(profileId: ID!, input: UpdateProfileInput!)deleteProfile(profileId: ID!)enrichProfile(profileId: ID!, providers: [String])batchEnrichProfiles(profileIds: [ID!]!, providers: [String])linkProfiles(sourceId: ID!, targetId: ID!, relationType: String!)unlinkProfiles(sourceId: ID!, targetId: ID!)mergeProfiles(sourceIds: [ID!]!, targetId: ID!)Système d'alertes en temps réel avec moniteurs configurables, niveaux de sévérité et flux de travail de décision pour la détection des menaces.
getAlertById(alertId: ID!)listAlerts(severity: [Severity], status: [AlertStatus], limit: Int)alertsByMonitor(monitorId: ID!, dateRange: DateRange)alertStatistics(dateRange: DateRange)getMonitor(monitorId: ID!)listMonitors(status: MonitorStatus, type: MonitorType)monitorPerformance(monitorId: ID!)createAlert(input: CreateAlertInput!)updateAlert(alertId: ID!, input: UpdateAlertInput!)decideAlert(alertId: ID!, decision: AlertDecision!, notes: String)bulkDecideAlerts(alertIds: [ID!]!, decision: AlertDecision!)createMonitor(input: CreateMonitorInput!)updateMonitor(monitorId: ID!, input: UpdateMonitorInput!)deleteMonitor(monitorId: ID!)pauseMonitor(monitorId: ID!)resumeMonitor(monitorId: ID!)Opérations sur le graphe de connaissances incluant la recherche de chemins, l'analyse de centralité, la détection de communautés et la prédiction de liens pour l'intelligence réseau.
graphNode(nodeId: ID!)graphNeighbors(nodeId: ID!, depth: Int, relationTypes: [String])findPath(sourceId: ID!, targetId: ID!, maxDepth: Int)shortestPath(sourceId: ID!, targetId: ID!)subgraph(seedIds: [ID!]!, depth: Int)graphStatistics(investigationId: ID)centrality(nodeIds: [ID!]!, algorithm: CentralityAlgorithm)communities(investigationId: ID!, algorithm: CommunityAlgorithm)linkPrediction(nodeId: ID!, limit: Int)createGraphNode(input: CreateNodeInput!)updateGraphNode(nodeId: ID!, input: UpdateNodeInput!)deleteGraphNode(nodeId: ID!)createGraphEdge(input: CreateEdgeInput!)updateGraphEdge(edgeId: ID!, input: UpdateEdgeInput!)deleteGraphEdge(edgeId: ID!)mergeNodes(sourceIds: [ID!]!, targetId: ID!)Requêtes basées sur la localisation, clustering, cartes de chaleur, géorepérage et analyse chronologique pour les opérations d'intelligence géographique.
getLocation(locationId: ID!)listLocations(bounds: BoundingBox, entityType: EntityType)entitiesWithinBounds(bounds: BoundingBox!, filters: GeoFilters)entitiesWithinRadius(center: LatLng!, radiusKm: Float!)entitiesWithinPolygon(polygon: GeoJSONPolygon!)locationClusters(bounds: BoundingBox!, zoomLevel: Int!)heatmapData(bounds: BoundingBox!, resolution: Int)locationTimeline(entityId: ID!, dateRange: DateRange)geocode(address: String!)reverseGeocode(coordinates: LatLng!)createLocation(input: CreateLocationInput!)updateLocation(locationId: ID!, input: UpdateLocationInput!)deleteLocation(locationId: ID!)linkLocationToEntity(locationId: ID!, entityId: ID!)createGeofence(input: CreateGeofenceInput!)updateGeofence(geofenceId: ID!, input: UpdateGeofenceInput!)Créer et gérer des tableaux de bord personnalisables avec panneaux, graphiques et métriques en temps réel pour la conscience opérationnelle.
getDashboard(dashboardId: ID!)listDashboards(type: DashboardType, shared: Boolean)getDashboardMetrics(dashboardId: ID!)panelData(panelId: ID!, dateRange: DateRange)dashboardTemplates(category: String)createDashboard(input: CreateDashboardInput!)updateDashboard(dashboardId: ID!, input: UpdateDashboardInput!)deleteDashboard(dashboardId: ID!)addPanelToDashboard(dashboardId: ID!, input: PanelInput!)updatePanel(panelId: ID!, input: UpdatePanelInput!)deletePanel(panelId: ID!)shareDashboard(dashboardId: ID!, userIds: [ID!]!)cloneDashboard(dashboardId: ID!, newName: String!)Recherche globale avec capacités sémantiques, filtres avancés et requêtes enregistrées pour une découverte rapide du renseignement.
globalSearch(query: String!, limit: Int, offset: Int)semanticSearch(query: String!, entityTypes: [EntityType])advancedSearch(input: AdvancedSearchInput!)searchSuggestions(prefix: String!, limit: Int)searchHistory(limit: Int)savedSearchessaveSearch(input: SaveSearchInput!)deleteSavedSearch(searchId: ID!)clearSearchHistorySuivi des preuves admissibles en cour avec chaîne de possession, vérification d'intégrité et scellé pour les procédures judiciaires.
evidence(evidenceId: ID!)evidenceByCase(caseId: ID!, type: EvidenceType)evidenceChainOfCustody(evidenceId: ID!)verifyEvidenceIntegrity(evidenceId: ID!)evidenceAuditTrail(evidenceId: ID!)createEvidence(input: CreateEvidenceInput!)updateEvidence(evidenceId: ID!, input: UpdateEvidenceInput!)recordCustodyTransfer(evidenceId: ID!, input: CustodyTransferInput!)sealEvidence(evidenceId: ID!)linkEvidenceToCase(evidenceId: ID!, caseId: ID!)Requêtes de renseignement de sources ouvertes à travers plusieurs fournisseurs pour les données sur personnes, organisations, téléphones, emails, réseaux sociaux, véhicules, domaines, IP et cryptomonnaies.
osintProvidersosintProviderStatus(providerId: ID!)osintUsage(dateRange: DateRange)searchPerson(input: PersonSearchInput!)searchOrganization(input: OrgSearchInput!)searchPhone(phoneNumber: String!, providers: [String])searchEmail(email: String!, providers: [String])searchSocialMedia(input: SocialSearchInput!)searchVehicle(input: VehicleSearchInput!)searchDomain(domain: String!)searchIP(ipAddress: String!)searchCrypto(address: String!, blockchain: String!)batchEnrich(entityIds: [ID!]!, providers: [String])Gestion d'équipes avec rôles de membres, permissions et hiérarchies pour les opérations d'enquête collaboratives.
team(teamId: ID!)teams(parentId: ID)teamMembers(teamId: ID!)myTeamsuser(userId: ID!)users(role: Role, status: UserStatus)currentUsercreateTeam(input: CreateTeamInput!)updateTeam(teamId: ID!, input: UpdateTeamInput!)deleteTeam(teamId: ID!)addTeamMember(teamId: ID!, userId: ID!, role: TeamRole!)removeTeamMember(teamId: ID!, userId: ID!)updateTeamMemberRole(teamId: ID!, userId: ID!, role: TeamRole!)Flux de travail automatisés avec déclencheurs, conditions et actions pour des processus d'enquête rationalisés.
workflow(workflowId: ID!)workflows(status: WorkflowStatus, trigger: TriggerType)workflowExecutions(workflowId: ID!, status: ExecutionStatus)workflowExecution(executionId: ID!)workflowTemplates(category: String)createWorkflow(input: CreateWorkflowInput!)updateWorkflow(workflowId: ID!, input: UpdateWorkflowInput!)deleteWorkflow(workflowId: ID!)executeWorkflow(workflowId: ID!, input: JSON)pauseWorkflow(workflowId: ID!)resumeWorkflow(workflowId: ID!)cancelExecution(executionId: ID!)Analyse de texte alimentée par l'IA, extraction d'entités, résumé, traduction et capacités de traitement de documents.
aiProcessingStatus(jobId: ID!)aiProcessingHistory(entityId: ID!)aiCapabilitiesanalyzeText(text: String!, options: AnalysisOptions)extractEntities(text: String!, entityTypes: [EntityType])generateSummary(text: String!, style: SummaryStyle)translateText(text: String!, targetLanguage: String!)generateGraph(text: String!)processDocument(fileId: ID!, options: ProcessingOptions)processImage(fileId: ID!, options: ImageProcessingOptions)processAudio(fileId: ID!, options: AudioProcessingOptions)processVideo(fileId: ID!, options: VideoProcessingOptions)Notifications en temps réel avec préférences, commentaires en fils, mentions et réactions pour la collaboration d'équipe.
notifications(status: NotificationStatus, limit: Int)unreadNotificationCountnotificationPreferencescomments(entityId: ID!, entityType: EntityType)comment(commentId: ID!)markNotificationRead(notificationId: ID!)markAllNotificationsReadupdateNotificationPreferences(input: NotificationPreferencesInput!)createComment(input: CreateCommentInput!)updateComment(commentId: ID!, content: String!)deleteComment(commentId: ID!)replyToComment(parentId: ID!, content: String!)reactToComment(commentId: ID!, reaction: String!)S'abonner aux mises à jour en temps réel via WebSocket pour le streaming de données en direct à travers tous les domaines.
alertStreamalertUpdates(alertId: ID!)monitorAlerts(monitorId: ID!)investigationProgress(investigationId: ID!)caseUpdates(caseId: ID!)taskUpdates(caseId: ID!)dashboardUpdates(dashboardId: ID!)panelData(panelId: ID!)metricsStream(dashboardId: ID!)channelMessages(channelId: ID!)userPresence(userIds: [ID!]!)typingIndicator(channelId: ID!)processingProgress(jobId: ID!)enrichmentProgress(profileId: ID!)workflowExecution(executionId: ID!)notificationStreammentionStreamsystemAnnouncementsquery GetInvestigationWithCases($investigationId: ID!) {
getInvestigation(investigationId: $investigationId) {
id
title
status
createdAt
profiles {
id
name
type
riskScore
}
}
cases(investigationId: $investigationId) {
id
title
status
priority
assignedTo {
id
displayName
}
tasks {
id
title
status
dueDate
}
}
}mutation CreateAlert($input: CreateAlertInput!) {
createAlert(input: $input) {
id
title
severity
confidence
createdAt
entities {
id
name
type
}
}
}
# Variables
{
"input": {
"title": "Suspicious Activity Detected",
"summary": "Multiple failed login attempts from unusual location",
"severity": "HIGH",
"confidence": 0.85,
"entities": ["entity-123"],
"monitorId": "monitor-456"
}
}Communication en temps réel via WebSocket pour les mises à jour en direct, les abonnements GraphQL et les fonctionnalités de collaboration.
wss://api.knogin.com/graphqlPoint d'accès WebSocket pour les abonnements GraphQL utilisant le protocole graphql-ws. Supporte toutes les opérations d'abonnement incluant les flux d'alertes, les mises à jour d'enquêtes et la collaboration en temps réel.
wss://api.knogin.com/wsPoint d'accès WebSocket pour le streaming d'événements en temps réel général incluant les mises à jour d'enquêtes, les notifications système et la présence utilisateur. Supporte les abonnements basés sur les canaux.
subscription AlertStream {
alertStream {
id
title
severity
confidence
createdAt
entities {
id
name
}
locations {
latitude
longitude
}
}
}Structures de réponse standard utilisées dans toute l'API.
{
"success": true,
"data": { ... },
"message": "Operation completed successfully",
"timestamp": "2024-01-15T10:30:00Z",
"request_id": "req_abc123"
}{
"error": "VALIDATION_ERROR",
"message": "Invalid input parameters",
"code": "ERR_VALIDATION_001",
"details": {
"field": "email",
"reason": "Invalid email format"
},
"timestamp": "2024-01-15T10:30:00Z"
}Codes de statut courants retournés par l'API.
Limites de taux de l'API pour garantir une utilisation équitable et la stabilité du système.