GET /v1/articles

Le flux d’articles de veille agrégés par TechWatchAlert (actualités, avis, publications). Données globales — aucun projet requis.

Requête

GET /api/v1/articles
Authorization: Bearer twa_votre_cle_ici

Paramètres de requête

Paramètre	Type	Description
q	string	Recherche dans le titre et la description
source	string	Filtre par source exacte
page	integer	Page (défaut 1)
page_size	integer	Taille de page, max 100 (défaut 20)

Réponse 200 OK

{
  "items": [
    {
      "id": "018e9999-0000-7000-8000-000000000050",
      "title": "Une faille critique dans OpenSSH permet l'exécution de code à distance",
      "description": "Les chercheurs ont publié les détails...",
      "published_at": "2024-07-01T08:30:00Z",
      "source": "The Hacker News",
      "author": "Jane Doe",
      "url": "https://example.com/article",
      "image_url": "https://example.com/cover.jpg"
    }
  ],
  "total": 1,
  "page": 1,
  "page_size": 20
}

Champs

Champ	Type	Description
id	string (UUID)	Identifiant de l’article
title	string	Titre
description	string | null	Résumé
published_at	string (ISO 8601) | null	Date de publication
source	string | null	Source (média / éditeur)
author	string | null	Auteur
url	string	Lien vers l’article original
image_url	string | null	Image de couverture

Exemple

Derniers articles d’une source

curl -s \
  -H "Authorization: Bearer twa_votre_cle_ici" \
  "https://app.techwatchalert.com/api/v1/articles?source=The%20Hacker%20News&page_size=10" \
  | jq '.items[] | {title, published_at, url}'