• Site Logo, Articulate

Recherche d'articles

Sélectionnez un produit

Répertoire d'assistance de null

Explorez tous les articles de null (Last Updated )

Aucun article trouvé.

Résultats de recherche

Aucun article trouvé.

Reach 360 : API de rapports

Article mis à jour pour la dernière fois le 16 janv. 2026

Ce que fait ce point de terminaison d'API

Avec l'API Reports, vous pouvez récupérer le rapport d'activité des utilisateurs (avec toutes les sessions utilisateur à l'échelle du compte), obtenir une liste des sessions d'apprenants pour un cours ou un parcours d'apprentissage spécifique, une liste des sessions de cours au sein d'un parcours d'apprentissage ou une liste de toutes les sessions de cours pour un apprenant spécifique.

Points de terminaison

  • GET /reports/activity- rapport d'activité utilisateur (liste des sessions utilisateur)
  • GET /reports/courses/{courseId}- rapport de l'apprenant (liste des sessions des apprenants pour un cours)
  • GET /reports/learners/{userId}- rapport de cours de l'apprenant (liste des sessions de cours bien sûres pour un apprenant)
  • GET /reports/learning-paths/{learningPathId}/courses- rapport sur les modules du chemin d'apprentissage (liste des sessions de cours d'un parcours d'apprentissage)
  • GET /reports/learning-paths/{learningPathId}/learners- rapport sur les apprenants du chemin d'apprentissage (liste des sessions des apprenants dans un parcours d'apprentissage)
  • GET /reports/groups/{groupId}/courses- Rapport sur les modules Learn• en groupe (liste des sessions de cours bien sûres d'un groupe)

Objet de session (activité de l'utilisateur avec un module)

  • courseId(chaîne) - identifiant du module
  • courseTitle(chaîne) - titre du cours
  • courseReportUrl(string) - URL pour récupérer le rapport du module depuis l'API
  • courseUrl(string) - URL pour récupérer les détails du cours depuis l'API
  • userId(chaîne) - identifiant de l'utilisateur
  • email(chaîne) - adresse e-mail de l'utilisateur
  • firstName(chaîne) - le prénom de l'utilisateur
  • lastName(chaîne) - le nom de famille de l'utilisateur
  • learnerReportUrl(string) - URL pour récupérer le rapport d'apprenant de l'utilisateur depuis l'API
  • userUrl(string) - URL pour récupérer les informations de l'utilisateur depuis l'API
  • duration(chaîne) - Durée de session utilisateur au format ISO 8601
  • numberOfLessonsCompleted(entier) - nombre de leçons terminées
  • quizScorePercent(entier) - pourcentage du score du quiz (si le quiz est présent)
  • isQuizPassed(bool) - si l'utilisateur a réussi le quiz ou non (si le quiz est présent)
  • startedAt(chaîne) - Horodatage UTC au format ISO 8601 indiquant le début de la session
  • userDeleted(bool) : si l'utilisateur a été supprimé de Reach 360 ou non.
  • courseDeleted(bool) : indique si le module a été supprimé.

Module Learner Object (utilisateur inscrit à un cours)

  • userId(chaîne) - identifiant de l'utilisateur
  • email(chaîne) - adresse e-mail de l'utilisateur
  • firstName(chaîne) - le prénom de l'utilisateur
  • lastName(chaîne) - le nom de famille de l'utilisateur
  • learnerReportUrl(string) - URL pour récupérer le rapport d'apprenant de l'utilisateur depuis l'API
  • userUrl(string) - URL pour récupérer les informations de l'utilisateur depuis l'API
  • duration(chaîne) - Durée moyenne d'une session utilisateur au format ISO 8601
  • quizScorePercent(entier) - pourcentage du score du quiz (si le quiz est présent)
  • dueAt(chaîne) - Horodatage UTC au format ISO 8601 indiquant la date d'échéance du module pour l'utilisateur (le cas échéant)
  • status(chaîne) - statut du cours bien sûr pour l'utilisateur (un des Not StartedIn Progress, ouComplete)
  • completedAt(string) - Horodatage indiquant à quel moment le module a été terminé par l'apprenant ou. null
  • userDeleted(bool) : si l'utilisateur a été supprimé de Reach 360 ou non.
  • progress(entier) - pourcentage de progression

Objet du cours destiné aux apprenants (module auquel un apprenant est inscrit)

  • courseId(chaîne) - identifiant du module
  • courseTitle(chaîne) - titre du cours
  • courseReportUrl(string) - URL pour récupérer le rapport du module depuis l'API
  • courseUrl(string) - URL pour récupérer les détails du cours depuis l'API
  • duration(chaîne) - Durée moyenne d'une session utilisateur au format ISO 8601
  • quizScorePercent(entier) - pourcentage du score du quiz (si le quiz est présent)
  • dueAt(chaîne) - Horodatage UTC au format ISO 8601 indiquant la date d'échéance du module pour l'utilisateur (le cas échéant)
  • status(chaîne) - statut du cours bien sûr pour l'utilisateur (un des Not StartedIn Progress, ouComplete)
  • completedAt(string) - Horodatage indiquant à quel moment le module a été terminé par l'apprenant ou. null
  • courseDeleted(bool) : indique si le module a été supprimé.
  • progress(entier) - pourcentage de progression

Objet du cours (module dans un parcours d'apprentissage)

  • courseId(chaîne) ****- identifiant du module
  • courseTitle(string) - titre du module
  • courseUrl(string) - URL pour récupérer les détails du cours depuis l'API
  • numberOfLessons(entier) - nombre de leçons dans le module
  • averageDuration(chaîne) - Durée moyenne d'une session utilisateur au format ISO 8601
  • courseReportUrl(string) - URL pour récupérer le rapport du module depuis l'API
  • courseDeleted(bool) : indique si le module a été supprimé.

Objet d'apprentissage (apprenant dans un parcours d'apprentissage)

  • userId(chaîne) - identifiant de l'utilisateur
  • email(chaîne) - adresse e-mail de l'utilisateur
  • firstName(chaîne) - le prénom de l'utilisateur
  • lastName(chaîne) - le nom de famille de l'utilisateur
  • learnerReportUrl(string) - URL pour récupérer le rapport d'apprenant de l'utilisateur depuis l'API
  • userUrl(string) - URL pour récupérer les informations de l'utilisateur depuis l'API
  • duration(chaîne) - Durée moyenne d'une session utilisateur au format ISO 8601
  • dueAt(chaîne) - Horodatage UTC au format ISO 8601 indiquant la date d'échéance du chemin d'apprentissage pour l'utilisateur (le cas échéant)
  • status(chaîne) - état du chemin d'apprentissage de l'utilisateur (l'un In Progress des Not Started deuxComplete)
  • userDeleted(bool) : si l'utilisateur a été supprimé du compte Reach 360 ou non.

Objet de cours en groupe (cours en groupe)

  • courseId(chaîne) ****- identifiant du module
  • courseTitle(string) - titre du module
  • courseUrl(string) - URL pour récupérer les détails du cours depuis l'API
  • averageDuration(chaîne) - Durée moyenne d'une session utilisateur au format ISO 8601
  • courseReportUrl(string) - URL pour récupérer le rapport du module depuis l'API
  • courseDeleted(bool) - si le module a été supprimé
  • enrollmentDeleted(bool) : indique si le groupe a été désinscrit du module

Obtenir le rapport d'activité

GET /reports/activity

Paramètres de demande (chaîne de requête)

  • limit(entier, facultatif) - le nombre maximum de résultats à renvoyer dans une seule réponse (voir Pagination) ; doit être compris entre 1 et 2 000 (50 par défaut)

Exemple de réponse

{
« sessions » : [
{
« courseId » : « example-course-id-1", « courseDeleted » : false, 
 « CourseTitle » : « 
 Titre du cours 1", « CourseReportURL » : « https://api.reach360.com/reports/courses/example-course-id-1 », « CourseUrl » : 
 « https://api.reach360.com/courses/example-course-id-1 », « example-user-id-id-1", « FirstName » : 
 « Exemple de prénom 1 », « Exemple de prénom 1 », 
 « Nom de famille » : « Nom de famille 1", « LearnerReportURL » : 
 « https://api.reach360.com/reports/learners/example-user-id-1 », « UserDeleted » : faux, 
 
 
 
« UserURL » : « https://api.reach360.com/users/example-user-id-1 », 
 « duration » : « PT37.578S », « NumberOfLessonsCompleted » : 1, 
 « QuizScorePercent » : null, « isQuizPassed » : null, 
 « StartedAt » : « 2020-01-01T 
 12:30:00.000 Z »},... 
 
 
], 
 « URL suivante » : "https://url-for-next-page-of-results"}

Obtenir le rapport sur les apprenants du Module

GET /reports/courses/{courseId}

Paramètres de demande (chaîne de requête)

  • limit(entier, facultatif) - le nombre maximum de résultats à renvoyer dans une seule réponse (voir Pagination) ; doit être compris entre 1 et 2 000 (50 par défaut)

Exemple de réponse

{
« courseDeleted » : false, 
 « courseURL » : "https://api.reach360.com/courses/example-course-id «, « 
 apprenants » : [
{« userId » : 
 « example-user-id-1", « firstName » : « Exemple de prénom 1 », 
 « lastName » : « Exemple de nom de famille 1", « learnerReportURL » : "https://api.reach360.com/reports/learners/example-user-id-1 
 «, « userURL » : "https://api.reach360.com/users/example-user-id-1 
 «, « duration » : « PT37.578S », « progress » » : 51, 
 « QuizScorePercent » : nul, 
 « DueAt » : « 2020-01-01T 12:30:00.000 Z », 
 
 
 
 « status » : « Terminé », 
 « UserDeleted » : faux, 
 « CompletedAt » : « 2019-12-31T 12:30:00.000 Z »,},... 
 
], 
 « URL suivante » : "https://url-for-next-page-of-results"}

Codes d'erreur spécifiques aux terminaux

  • course_not_found- Impossible de récupérer le rapport car le module n'existe pas

Obtenir le rapport du module destiné aux apprenants

GET /reports/learners/{userId}

Paramètres de demande (chaîne de requête)

  • limit(entier, facultatif) - le nombre maximum de résultats à renvoyer dans une seule réponse (voir Pagination) ; doit être compris entre 1 et 2 000 (50 par défaut)

Exemple de réponse

{
« userDeleted » : false, 
 « userURL » : "https://api.reach360.com/users/example-user-id «, « 
 cours » : [
{« completedAt » : 
 « 2019-12-31T 12:30:00.000 Z », « courseDeleted » : false, « 
 courseID » : 
 « example-course-id-1", « courseTitle » : « 
 Titre du cours 1", « courseReportURL » : "https://api.reach360.com/reports/courses/example-course-id-1 «, « courseURL » : « https://api.reach360.com/courses/example-course-id-1 », « durée » : « PT37.578S », 
 « progression » : 51, « QuizScorePercent » : nul, 
 « duEat » : 
 
 
 
 « 2020-01-01T 12:30:00.000 Z », 
 « status » : « Terminé »},... 
 
], 
 « URL suivante » : "https://url-for-next-page-of-results"}

Codes d'erreur spécifiques aux terminaux

  • user_not_found- Impossible de récupérer le rapport car l'utilisateur n'existe pas

Obtenir le rapport sur les Modules du parcours de formation

GET /reports/learning-paths/{learningPathId}/courses

Paramètres de demande (chaîne de requête)

  • limit(entier, facultatif) - le nombre maximum de résultats à renvoyer dans une seule réponse (voir Pagination) ; doit être compris entre 1 et 2 000 (50 par défaut)

Exemple de réponse

{
« learningPathDeleted » : false, 
 « learningPathURL » : "https://api.reach360.com/learning-paths/example-learning-path-id «, « learnersReportURL » : "https://api.reach360.com/reports/learning-paths/example-learning-path-id/learners 
 «, « modules » : 
 [
{« courseDeleted » : false, 
 « courseID » : « example-course-1"
, « courseTitle » : « Exemple de cours », « courseURL » : « https://api.reach360.com/courses/example-course-1 »
, « numberOfLessons » : 6, Durée moyenne » : « PT37.578S 
 », » 
 
 
 URL du rapport de cours » : "https://api.reach360.com/reports/courses/example-course-1"},... 
 
], 
 « URL suivante » : "https://url-for-next-page-of-results"}

Codes d'erreur spécifiques aux terminaux

  • learning_path_not_found- Impossible de récupérer le rapport car le chemin d'apprentissage n'existe pas

Obtenir le rapport sur les apprenants du parcours de formation

GET /reports/learning-paths/{learningPathId}/learners

Paramètres de demande (chaîne de requête)

  • limit(entier, facultatif) - le nombre maximum de résultats à renvoyer dans une seule réponse (voir Pagination) ; doit être compris entre 1 et 2 000 (50 par défaut)

Exemple de réponse

{
« learningPathURL » : "https://api.reach360.com/learning-paths/example-learning-path-id «, 
 « coursesReportURL » : "https://api.reach360.com/reports/learning-paths/example-learning-path-id/courses «, « 
 apprenants » : [
{
« duEat » : null, « duration » : 
 « PT37.578S », « firstName » : 
 « Exemple de prénom 1 », « LearnerReportURL » : 
 « https://api.reach360.com/reports/learners/example-user-id-1 », « status » : « Complet », 
 « userDeleted » : faux, 
 « ID utilisateur » 
 
 : « exemple-user-id-1", 
 « UserURL » : "https://api.reach360.com/users/example-user-id-1"},... 
 
], 
 « URL suivante » : "https://url-for-next-page-of-results"}

Codes d'erreur spécifiques aux terminaux

  • learning_path_not_found- Impossible de récupérer le rapport car le chemin d'apprentissage n'existe pas

Obtenir le rapport sur les Modules de groupe

GET /reports/groups/{groupId}/courses

Paramètres de demande (chaîne de requête)

  • limit(entier, facultatif) - le nombre maximum de résultats à renvoyer dans une seule réponse (voir Pagination) ; doit être compris entre 1 et 2 000 (50 par défaut)

Exemple de réponse

< https://api.reach360.com/groups/example-group-1 >{ 
 « modules » : [
{
« courseDeleted » : false, « courseID » : 
 « example-course-1", « 
 CourseTitle » : « Exemple de cours », « CourseURL » : « », « < https://api.reach360.com/courses/example-course-1 > averageDuration » : 
 « PT0S », « courseReportURL » : 
 « », « < https://api.reach360.com/reports/courses/example-course-1 > EnrollmentDeleted » : false},...], 
 « groupDeleted » : false, « groupDeleted » : false » : 
 « », « URL suivante » : « < 
 
 
 https://url-for-next-page-of-results > »
}

Codes d'erreur spécifiques au point de terminaison

  • group_not_found- Impossible de récupérer le rapport car le groupe n'existe pas