TEMPO

Documentation de l'API TEMPO

L'accès à l'API se fait sans création de compte ou d'authentification particulière.

Les données sont mises en cache à intervalle régulière, ainsi il n'est pas nécessaire de faire de multiples appels chaque jour, veuillez vous référer à chaque entrée d'API pour connaître la fréquence de rafraichissement des données.

GET /api/now

Récupérer la couleur du jour et du lendemain

Les données sont mises à jour à minuit puis à 10h30 chaque jour.

La date et l'heure sont celles du fuseau de Paris.

Pour l'attribut "color", R signifie un jour rouge, W un jour blanc et B un jour bleu. Avant 10h30, le lendemain sera noté U pour inconnu.

Tant que la couleur du jour n'est pas connue, les jours restant seront à -1

Les messages d'absences sont les mêmes que ceux affiché sur la page principale du site.

                        
[
    "messages" :
        { "message de maintenance"
        },
    {
        "day":"2023-08-28 00:00:00Z",
        "color":"U",
        "blue_left":250,
        "white_left":10,
        "red_left":5
    },
    {
        "day":"2023-08-29 00:00:00Z",
        "color":"U",
        "blue_left":-1,
        "white_left":-1,
        "red_left":-1
    }
]
                        
                    

GET /api/day/2024-05-17

Récupérer la couleur d'une journée en particulier

Les données sont mises à jour à minuit puis à 10h30 chaque jour.

La date et l'heure sont celles du fuseau de Paris.

Pour l'attribut "color", R signifie un jour rouge, W un jour blanc et B un jour bleu. Avant 10h30, le lendemain sera noté U pour inconnu.

Les messages d'absences sont les mêmes que ceux affiché sur la page principale du site.

                        
[
    "messages" :
        { "message de maintenance"
        },
    {
        "day":"2023-08-28 00:00:00Z",
        "color":"B",
        "blue_left":250,
        "white_left":10,
        "red_left":5
    }
]
                        
                    
                        
[
    "message" : "La date YYYY-MM-DD ne peut être affichée.",
    "@see" :
        [
            "min" : "URI de la date la plus ancienne accessible"
            "max" : "URI de la date du lendemain"
        ]

]
                        
                    

GET /api/stats/users

Récupérer les statistiques anonymisées des accès utilisateurs

Cette entrée permet de récupérer les 365 derniers jours (hors jour en cours) de statistiques anonymisées des accès utilisateurs aux différentes parties du site.

Les données sont mises à jour chaque jour à minuit.

La date et les heures sont celles du fuseau de Paris.

L'attribut 'first_access' contient les heures de premier accès à chaque partie de l'application pour le jour 'day'.

  • web: correspond à l'affichage de la page d'accueil du site (ou de sa version LOW)
  • api: correspond à l'accès à l'une des entrées concernant la couleur des jours, cela exclu cette page ainsi que les entrées d'api concernant les statistiques
  • rss: en cours de création
  • cal: correspond à l'accès à la page d'explication du calendrier
  • web_push: correspond à la souscription aux notifications push

Une valeur null signifie qu'aucun accès n'a eu lieu pour le jour.

L'attribut 'web_push_notification' contient le nombre total de souscriptions aux notifications push ainsi que le nombre de desinscriptions. Ces deux données sont mis à jour au moment de la découverte de la couleur du lendemain, soit vers 10h30, et non minuit.

                        
[
    {
        "day":"2023-08-25",
        "first_access":
            {
                "web":"10:12:31",
                "api":null,
                "rss":null,
                "cal":null,
                'web_push':null,
            }',
        "web_push_notification": {
                "total": 42,
                "unsubscribes": 0,
            },
    },
    {
        "day":"2023-08-26",
        "first_access":
            {
                "web":"17:55:16",
                "api":null,
                "rss":"14:12:45",
                "cal":null,
                "webPush":"09:14:23",
            },
        "web_push_notification": {
                "total": 30,
                "unsubscribes": 12,
            },
    }
]