Celcat

Interconnexion planning AppScho avec Celcat

L'intégration Celcat utilisée par AppScho utilise la Web API intégrée à Celcat afin de récupérer des informations sur un utilisateur Celcat ainsi que les événements présents dans son agenda.

AppScho a besoin d'accéder à l'API de Celcat depuis ses infrastructures, il est de la responsabilité de l'établissement de fournir ces accès à AppScho et d'assurer les permissions nécessaires à son utilisation.

Les informations à fournir à AppScho pour réaliser cette intégration sont les suivantes :

• l'adresse vers une instance de Celcat

• une clé d'API liée à compte de service autorisé à requêter l'API.

Récupération de l'ID de l'utilisateur

La première étape se déroule lors de la récupération des informations utilisateur par AppScho. Il s'agit ici de déterminer, à partir d'une information canonique sur l'utilisateur connecté, l'ID Celcat lui correspondant.

Pour cela, nous utilisons deux points d'API fournis par Celcat, /students et /staff, afin qu'en fonction du rôle de l'utilisateur, nous puissions en dériver son ID Celcat.

Récupération du planning

A partir de l'ID récupéré à l'étape précédente, nous sommes en mesure de requêter le point d'API /event-snapshots afin d'obtenir la liste des événements pertinents pour l'utilisateur sur une période donnée.