GET /v1/organizations/{org_id}/projects/{id}/urls

Les URLs surveillées d’un projet : état de joignabilité, expiration du certificat TLS et technologies détectées lors du dernier scan passif.

Liste des URLs

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

Paramètres de chemin

Paramètre	Type	Description
org_id	UUID	Identifiant de l’organisation
project_id	UUID	Identifiant du projet

Réponse 200 OK

[
  {
    "id": "018e7777-0000-7000-8000-000000000030",
    "url": "https://www.example.com",
    "label": "Site vitrine",
    "is_enabled": true,
    "last_status": "ok",
    "last_http_status": 200,
    "cert_expires_at": "2025-01-15T00:00:00Z",
    "cert_issuer": "Let's Encrypt",
    "last_scanned_at": "2024-07-01T06:00:00Z",
    "created_at": "2024-03-15T10:22:00Z"
  }
]

Champs

Champ	Type	Description
id	string (UUID)	Identifiant de l’URL surveillée
url	string	URL surveillée
label	string | null	Libellé
is_enabled	boolean	Surveillance active
last_status	string	ok, error, timeout, pending
last_http_status	integer | null	Dernier code HTTP renvoyé
cert_expires_at	string (ISO 8601) | null	Expiration du certificat TLS
cert_issuer	string | null	Émetteur du certificat
last_scanned_at	string (ISO 8601) | null	Date du dernier scan
created_at	string (ISO 8601)	Date d’ajout

Détail d’une URL

GET /api/v1/organizations/{org_id}/projects/{project_id}/urls/{url_id}
Authorization: Bearer twa_votre_cle_ici

Ajoute le champ technologies (technologies détectées au dernier scan) :

{
  "id": "018e7777-0000-7000-8000-000000000030",
  "url": "https://www.example.com",
  "technologies": [
    { "name": "Nginx", "version": "1.18.0", "categories": ["Web servers"], "confidence": 100 }
  ]
}

Erreurs

Code	Détail	Cause
404	Projet introuvable	Projet inexistant, d’une autre organisation, ou hors de la restriction de projets de la clé
403	Cette clé API n'a pas le droit d'accéder à cette ressource.	Le scope urls manque à la clé
404	URL introuvable	url_id inexistant sur ce projet

Exemple

Certificats expirant dans moins de 30 jours

ORG_ID="018e5678-abcd-7000-8000-000000000001"
PROJECT_ID="018e1234-abcd-7000-8000-000000000010"

curl -s \
  -H "Authorization: Bearer twa_votre_cle_ici" \
  "https://app.techwatchalert.com/api/v1/organizations/${ORG_ID}/projects/${PROJECT_ID}/urls" \
  | jq --arg limit "$(date -u -d '+30 days' +%Y-%m-%dT%H:%M:%SZ)" \
       '.[] | select(.cert_expires_at != null and .cert_expires_at < $limit) | {url, cert_expires_at}'