API REST v1

Ce que fait le connecteur

L'API REST v1, décrite en OpenAPI, donne accès aux projets, à la stack, aux alertes, aux dossiers, aux fins de vie, aux statistiques et à la base CVE de votre organisation. Elle est en lecture seule, sauf trois droits d'écriture à cocher explicitement : dépôt de scans, dépôt de SBOM et écriture de workflows.

Ce qui remonte dans TechWatchAlert

• Lecture : projets, stack, alertes, dossiers, fins de vie, URL surveillées, workflows, statistiques, base CVE et articles
• Écriture sur droit explicite : dépôt de rapports de scan et de SBOM, gestion des workflows
• Clés restreignables par famille de ressources, par projet et par date d'expiration

Mise en place

1. Dans les réglages de l'organisation, onglet API, créez une clé (rôle admin requis)
2. Copiez-la : elle n'est affichée qu'une fois
3. Appelez https://app.techwatchalert.com/api/v1 avec l'en-tête « Authorization: Bearer <clé> »