API Modules

Cet objet représente les modules du site Le Temps.

Endpoints disponibles

Recherche de modules

URL : https://www.letemps.ch/api/modules
Type d’appel : GET

Paramètre	Type	Obligatoire	Commentaire	Exemple
sirius_id	`string`	Non		c3RnLWxldGVtcHM6QXJ0aWNsZTo3ODg2MA
title	`string`	Non	La chaîne qu’on va chercher dans les titres de modules	Lorem ipsum
page	`integer`	Non	Le numéro de page que vous souhaitez	2

Exemple d'appel

https://www.letemps.ch/api/modules?sirius_id=c3RnLWxldGVtcHM6QXJ0aWNsZTo3ODg2MA

⚠️

Le critères de recherche sont cumulables, si vous précisez un sirius_id ET un titre la recherche filtrera sur ces deux critères.
Ces paramètres ne sont pas obligatoires. Si vous ne les renseignez pas les derniers modules seront affichés.
La liste renvoyée est paginée. Utilisez le paramètre optionnel page pour ajouter un offset. Par exemple un paramètre page = 1 (équivalent à aucun paramètre page fourni) affichera les 21 derniers modules, alors qu’un paramètre page = 2 affichera les 21 précédents.

L’appel renvoie un statut 200 à partir du moment où la recherche s’effectue correctement, même si elle ne trouve pas de résultats.
Si la requête est valable il renvoie également un tableau modules contenant les objets trouvés.

Réponse correcte

{
    "modules": [
        {
            "id": 123456,
            "sirius_id": "c3RnLWxldGVtcHM6QXJ0aWNsZTo3ODg2MA",
            "title": "Lorem ipsum dolor",
            "surtitle": "Lorem ipsum dolor sit amet",
            "publication_date": "2025-07-01T11:40:11.021+02:00",
            "authors": [
              1234,
              2345                
            ]
        },
        {...}
    ]
}

Détail d’un module

URL : https://www.letemps.ch/api/modules/:id
Type d’appel : GET

Paramètre	Type	Obligatoire	Exemple
id (dans l’url directement)	`integer`	Oui	123456

Exemple d'appel

https://www.letemps.ch/api/modules/123456

L’appel renvoie un statut 200 si le module a bien été trouvé, ou un statut 404 en cas d’échec.
Si le module a été trouvé il renvoie également un objet module, sinon il renvoie un code d’erreur.

Réponse correcte

{
    "module": {
        "id": 123456,
        "sirius_id": "c3RnLWxldGVtcHM6QXJ0aWNsZTo3ODg2MA",
        "title": "Lorem ipsum",
        "surtitle": "Lorem ipsum dolor sit amet",
        "publication_date": "2025-07-01T11:40:11.021+02:00",
        "authors": [
          1234,
          2345                
        ],
        "body": "Lorem ipsum dolor sit amet, consectetur adipiscing elit"
    }
}

Réponse erronnée

{
    "code": "not_found"
}