Documentation

Vue d’ensemble

L’API TechWatchAlert vous permet d’accéder programmatiquement à vos données de veille : CVE alertées, stacks surveillées et suivi End-of-Life, tous organisés par projet.

Clés API

Générez vos clés depuis Réglages de l’organisation → API (plan PRO requis, rôle admin). Chaque clé est rattachée à l’organisation et préfixée twa_.

Base URL

Tous les endpoints sont préfixés par https://app.techwatchalert.com/api/v1

Lecture seule

L’API publique est en lecture seule (GET uniquement). Aucune modification de données n’est possible.

Format

Toutes les réponses sont en JSON. Les dates sont au format ISO 8601 avec timezone UTC.

Endpoints disponibles

Méthode	Endpoint	Description
GET	/v1/me	Organisation rattachée à la clé et son plan
GET	/v1/organizations	L’organisation rattachée à la clé
GET	/v1/organizations/{id}/projects	Projets d’une organisation
GET	/v1/organizations/{org_id}/projects/{id}	Détail d’un projet
GET	/v1/organizations/{org_id}/projects/{id}/stack	Stack de veille CVE d’un projet
GET	/v1/organizations/{org_id}/projects/{id}/alerts	Alertes CVE déclenchées sur un projet
GET	/v1/organizations/{org_id}/projects/{id}/alerts/{alert_id}	Détail d’une alerte CVE
GET	/v1/organizations/{org_id}/projects/{id}/eol	Abonnements End-of-Life d’un projet
GET	/v1/organizations/{org_id}/projects/{id}/urls	URLs surveillées (certificats, technos détectées)
GET	/v1/organizations/{org_id}/projects/{id}/urls/{url_id}	Détail d’une URL surveillée
GET	/v1/organizations/{org_id}/projects/{id}/cases	Cas de traitement des CVE (triage)
GET	/v1/organizations/{org_id}/projects/{id}/cases/{cve_id}	Détail d’un cas + historique
GET	/v1/organizations/{org_id}/projects/{id}/workflows	Workflows d’automatisation du projet
GET	/v1/organizations/{org_id}/projects/{id}/workflows/{workflow_id}/runs	Historique d’exécutions d’un workflow
GET	/v1/organizations/{org_id}/projects/{id}/stats	Statistiques du projet (alertes, KEV, PoC…)
GET	/v1/cves	Recherche dans la base CVE
GET	/v1/cves/{cve_id}	Fiche CVE complète
GET	/v1/articles	Flux d’articles de veille
GET	/v1/eol/products	Catalogue complet des produits EOL
GET	/v1/eol/products/{product_id}/cycles	Cycles de vie d’un produit

Codes HTTP

Code	Signification
200	Succès
401	Clé API manquante, invalide ou révoquée
403	Plan de l’organisation insuffisant (accès API non inclus)
404	Ressource introuvable
422	Paramètres invalides