GET /v1/projects

Les projets sont le pivot central de l’API : chaque stack de veille, alerte CVE et abonnement EOL est rattaché à un projet. Commencez toujours par récupérer vos IDs de projet.

Lister les projets

GET /api/v1/projects
Authorization: Bearer twa_votre_cle_ici

Retourne tous les projets dont l’utilisateur est propriétaire ou membre.

Aucun paramètre

Réponse 200 OK

[
  {
    "id": "018e1234-abcd-7000-8000-000000000010",
    "name": "Infrastructure prod",
    "description": "Serveurs et dépendances en production",
    "is_default": true,
    "created_at": "2024-03-15T10:22:00Z"
  },
  {
    "id": "018e1234-abcd-7000-8000-000000000011",
    "name": "Stack frontend",
    "description": null,
    "is_default": false,
    "created_at": "2024-06-01T08:00:00Z"
  }
]

Champs

Champ	Type	Description
id	string (UUID)	Identifiant du projet — à utiliser dans tous les endpoints /projects/{id}/...
name	string	Nom du projet
description	string | null	Description (null si non renseignée)
is_default	boolean	true pour le projet créé automatiquement à l’inscription
created_at	string (ISO 8601)	Date de création

---

Détail d’un projet

GET /api/v1/projects/{project_id}
Authorization: Bearer twa_votre_cle_ici

Paramètres de chemin

Paramètre	Type	Description
project_id	UUID	Identifiant du projet

Réponse 200 OK

Même structure qu’un élément de la liste.

{
  "id": "018e1234-abcd-7000-8000-000000000010",
  "name": "Infrastructure prod",
  "description": "Serveurs et dépendances en production",
  "is_default": true,
  "created_at": "2024-03-15T10:22:00Z"
}

Erreurs

Code	Détail	Cause
404	Projet introuvable	project_id inexistant
403	Accès refusé à ce projet	Projet existant mais vous n’en êtes ni propriétaire ni membre

---

Exemples

Récupérer tous les IDs de projets

curl -s \
  -H "Authorization: Bearer twa_votre_cle_ici" \
  https://app.techwatchalert.com/api/v1/projects \
  | jq '.[].id'

Stocker l’ID du projet par défaut

DEFAULT_PROJECT=$(curl -s \
  -H "Authorization: Bearer twa_votre_cle_ici" \
  https://app.techwatchalert.com/api/v1/projects \
  | jq -r '.[] | select(.is_default == true) | .id')

echo "Projet par défaut : $DEFAULT_PROJECT"

Python — mapper nom → id

import httpx

BASE_URL = "https://app.techwatchalert.com/api/v1"
headers = {"Authorization": "Bearer twa_votre_cle_ici"}

projects = httpx.get(f"{BASE_URL}/projects", headers=headers).json()
by_name = {p["name"]: p["id"] for p in projects}

prod_id = by_name["Infrastructure prod"]