Busqueda de Articulos

Selecciona un Producto

Directorio de soporte de null

Explore todos los artículos de null (Last Updated )

No se encontraron articulos.

Resultados de busqueda

No se encontraron articulos.

Reach 360: API de informes

Artículo actualizado por última vez el 16 ene 2026

Qué hace este punto final de API

Con la API de informes, puede recuperar el informe de actividad del usuario (con todas las sesiones de usuario de toda la cuenta), obtener una lista de las sesiones de los alumnos para un curso o una ruta de aprendizaje específicos, una lista de las sesiones del curso dentro de una ruta de aprendizaje o una lista de todas las sesiones del curso para un alumno específico.

Puntos finales

  • GET /reports/activity- informe de actividad del usuario (lista de sesiones de usuario)
  • GET /reports/courses/{courseId}- informe de los alumnos del curso (lista de las sesiones de los alumnos de un curso)
  • GET /reports/learners/{userId}- informe del curso del alumno (lista de las sesiones del curso para un alumno)
  • GET /reports/learning-paths/{learningPathId}/courses- informe de cursos de la ruta de aprendizaje (lista de las sesiones del curso en una ruta de aprendizaje)
  • GET /reports/learning-paths/{learningPathId}/learners- informe de los alumnos sobre la ruta de aprendizaje (lista de las sesiones de los alumnos en una ruta de aprendizaje)
  • GET /reports/groups/{groupId}/courses- Informe sobre los cursos grupales de Learn• (lista de las sesiones del curso en un grupo)

Objeto de sesión (actividad del usuario en un curso)

  • courseId(cadena): identificador del curso
  • courseTitle(cadena): título del curso
  • courseReportUrl(string): URL para obtener el informe del curso desde la API
  • courseUrl(string): URL para obtener los detalles del curso desde la API
  • userId(string): identificador de usuario
  • email(cadena): dirección de correo electrónico del usuario
  • firstName(cadena): nombre del usuario
  • lastName(cadena): apellido del usuario
  • learnerReportUrl(cadena): URL para obtener el informe de aprendizaje del usuario desde la API
  • userUrl(string): URL para obtener los detalles del usuario desde la API
  • duration(cadena): duración de la sesión de usuario con formato ISO 8601
  • numberOfLessonsCompleted(entero): número de apartados completados
  • quizScorePercent(entero): porcentaje de puntuación del cuestionario (si el cuestionario está presente)
  • isQuizPassed(bool): si el usuario aprobó el cuestionario o no (si el cuestionario está presente)
  • startedAt(cadena): marca de tiempo UTC con formato ISO 8601 del inicio de la sesión
  • userDeleted(bool): si el usuario ha sido eliminado de Reach 360 o no.
  • courseDeleted(bool): si el curso se ha eliminado.

Objeto de aprendizaje del curso (usuario inscrito en un curso)

  • userId(cadena): identificador de usuario
  • email(cadena): dirección de correo electrónico del usuario
  • firstName(cadena): nombre del usuario
  • lastName(cadena): apellido del usuario
  • learnerReportUrl(cadena): URL para obtener el informe de aprendizaje del usuario desde la API
  • userUrl(string): URL para obtener los detalles del usuario desde la API
  • duration(string): duración media de la sesión de usuario con formato ISO 8601
  • quizScorePercent(entero): porcentaje de puntuación del cuestionario (si el cuestionario está presente)
  • dueAt(cadena): marca horaria UTC con formato ISO 8601 que indica la fecha límite del curso para el usuario (si corresponde)
  • status(cadena): estado del curso para el usuario (uno de, o) Not Started In Progress Complete
  • completedAt(cadena): marca de tiempo del momento en que el alumno completó el curso o. null
  • userDeleted(bool): si el usuario ha sido eliminado de Reach 360 o no.
  • progress(entero): porcentaje de progreso

Objeto del curso del alumno (curso en el que está inscrito un alumno)

  • courseId(cadena): identificador del curso
  • courseTitle(cadena): título del curso
  • courseReportUrl(string): URL para obtener el informe del curso desde la API
  • courseUrl(string): URL para obtener los detalles del curso desde la API
  • duration(string): duración media de la sesión de usuario con formato ISO 8601
  • quizScorePercent(entero): porcentaje de puntuación del cuestionario (si el cuestionario está presente)
  • dueAt(cadena): marca horaria UTC con formato ISO 8601 que indica la fecha límite del curso para el usuario (si corresponde)
  • status(cadena): estado del curso para el usuario (uno de, o) Not Started In Progress Complete
  • completedAt(cadena): marca de tiempo del momento en que el alumno completó el curso o. null
  • courseDeleted(bool): si el curso se ha eliminado.
  • progress(entero): porcentaje de progreso

Objeto de curso de la ruta de aprendizaje (curso en una ruta de aprendizaje)

  • courseId(cadena) ****- identificador del curso
  • courseTitle(cadena): título del curso
  • courseUrl(cadena): URL para obtener los detalles del curso desde la API
  • numberOfLessons(entero): número de apartados del curso
  • averageDuration(cadena): duración media de la sesión de usuario con formato ISO 8601
  • courseReportUrl(string): URL para obtener el informe del curso desde la API
  • courseDeleted(bool): si el curso se ha eliminado.

Objeto de aprendizaje de la ruta de aprendizaje (alumno en una ruta de aprendizaje)

  • userId(cadena): identificador de usuario
  • email(cadena): dirección de correo electrónico del usuario
  • firstName(cadena): nombre del usuario
  • lastName(cadena): apellido del usuario
  • learnerReportUrl(cadena): URL para obtener el informe de aprendizaje del usuario desde la API
  • userUrl(string): URL para obtener los detalles del usuario desde la API
  • duration(string): duración media de la sesión de usuario con formato ISO 8601
  • dueAt(cadena): marca de tiempo UTC con formato ISO 8601 que indica cuándo debe finalizar la ruta de aprendizaje para el usuario (si corresponde)
  • status(cadena): estado de la ruta de aprendizaje del usuario (una de Not StartedIn Progress, oComplete)
  • userDeleted(bool): si el usuario ha sido eliminado de la cuenta de Reach 360 o no.

Objeto de curso grupal (curso en grupo)

  • courseId(cadena) ****- identificador del curso
  • courseTitle(cadena): título del curso
  • courseUrl(cadena): URL para obtener los detalles del curso desde la API
  • averageDuration(string): duración media de la sesión de usuario con formato ISO 8601
  • courseReportUrl(string): URL para obtener el informe del curso desde la API
  • courseDeleted(bool): si el curso se ha eliminado
  • enrollmentDeleted(bool): si se canceló la inscripción del grupo en el curso

Obtenga un informe de actividad

GET /reports/activity

Parámetros de solicitud (cadena de consulta)

  • limit(entero, opcional): el número máximo de resultados que se devolverán en una sola respuesta (consulte Paginación); debe estar entre 1 y 2000 (el valor predeterminado es 50)

Ejemplo de respuesta

{
«sessions»: [
{
«courseID»: «example-course-id-1", «courseDeleted»: false, 
 «courseTitle»: «CourseTitle»: 
 «CourseReportUrl»: "https://api.reach360.com/reports/courses/example-course-id-1 «, «courseURL»: "https://api.reach360.com/courses/example-course-id-1 
 «, «userID»: «example-user-id-1", 
 «firstName»: «Ejemplo de nombre 1", «LastName»: 
 «LastName»: «Ejemplo de apellido 1", «learnerReportUrl»: "https://api.reach360.com/reports/learners/example-user-id-1 
 «, «userDeleted»: false, 
 
 
 
«userURL»: "https://api.reach360.com/users/example-user-id-1 «, 
 «duration»: «PT37.578S», 
 «Numero de lecciones completadas»: 1, 
 «QuizScorePercent»: nulo, 
 «isQuizPassed»: nulo, 
 «StartedAt»: «2020-01-01T 12:30:00.000 Z»
},... 
]
, «URL siguiente
»: "https://url-for-next-page-of-results"}

Obtenga el informe del alumno del curso

GET /reports/courses/{courseId}

Parámetros de solicitud (cadena de consulta)

  • limit(entero, opcional): el número máximo de resultados que se devolverán en una sola respuesta (consulte Paginación); debe estar entre 1 y 2000 (el valor predeterminado es 50)

Ejemplo de respuesta

{
«courseDeleted»: false, 
 «courseURL»: "https://api.reach360.com/courses/example-course-id «, «
alumnos»: [
{«userID»: «example-user-id-1", 
 «firstName»: «Ejemplo de nombre 1", 
 «lastName»: «Ejemplo de apellido 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», progreso»: 51, 
 «QuizScorePercent»: nulo, «DueAT»: 
 «2020-01-01T 12:30:00.000 Z», 
 
 
 
 «status»: «Completo», 
 «UserDeleted»: false, 
 «completedAt»: «2019-12-31T 12:30:00.000 Z»,
},... 
], 
 «nextUrl»: "https://url-for-next-page-of-results"} 

Códigos de error específicos de un terminal

  • course_not_found- no se puede recuperar el informe porque el curso no existe

Obtenga el informe del curso para estudiantes

GET /reports/learners/{userId}

Parámetros de solicitud (cadena de consulta)

  • limit(entero, opcional): el número máximo de resultados que se devolverán en una sola respuesta (consulte Paginación); debe estar entre 1 y 2000 (el valor predeterminado es 50)

Ejemplo de respuesta

{
«userDeleted»: false, 
 «userURL»: "https://api.reach360.com/users/example-user-id «, «courses»: [
{
«completedAT»: 
 «2019-12-31T 12:30:00.000 Z», «courseDeleted»: false, «courseID»: «example-course-id-1", 
 «CourseTitle»: 
 «CourseTitle»: «CourseOrl», «CourseReportURL»: "https://api.reach360.com/reports/courses/example-course-id-1 
 «, «CourseURL»: "https://api.reach360.com/courses/example-course-id-1 «, «duration»: 
 «PT37.578S», «progreso»: 51, «QuizScorePercent»: null, 
 «DueAT»: 
 
 
 
 «2020-01-01T 12:30:00.000 Z», 
 «estado»: «Completo»
},... 
], «nextURL»: "https://url-for-next-page-of-results"} 
 

Códigos de error específicos de un terminal

  • user_not_found- no se puede recuperar el informe porque el usuario no existe

Obtenga el informe de los cursos de Learning Path

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

Parámetros de solicitud (cadena de consulta)

  • limit(entero, opcional): el número máximo de resultados que se devolverán en una sola respuesta (consulte Paginación); debe estar entre 1 y 2000 (el valor predeterminado es 50)

Ejemplo de respuesta

{
«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 
 «, «courses»: [
{«courseDeleted»: false, 
 «courseID»: «example-course-1", 
 «CourseTitle»: 
 «Ejemplo de curso», «CourseURL»: "https://api.reach360.com/courses/example-course-1 «, «NumberOfLessons»: 6, 
 «AverageDuration»: «PT37.578S»,
» 
 
 
 URL del informe del curso»: "https://api.reach360.com/reports/courses/example-course-1"
},... 
], 
 «nextUrl»: "https://url-for-next-page-of-results"} 

Códigos de error específicos de un terminal

  • learning_path_not_found- no se puede recuperar el informe porque la ruta de aprendizaje no existe

Obtenga el informe de los alumnos de Learning Path

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

Parámetros de solicitud (cadena de consulta)

  • limit(entero, opcional): el número máximo de resultados que se devolverán en una sola respuesta (consulte Paginación); debe estar entre 1 y 2000 (el valor predeterminado es 50)

Ejemplo de respuesta

{
«learningPathURL»: "https://api.reach360.com/learning-paths/example-learning-path-id «, 
 «coursesReportURL»: "https://api.reach360.com/reports/learning-paths/example-learning-path-id/courses «, «
alumnos»: [
{«DueAT»: null, 
 «duration»: «PT37.578S», 
 «firstName»: «Ejemplo de nombre 1", 
 «lastName»: «Ejemplo de apellido 1", 
 «learnerReportUrl»: "https://api.reach360.com/reports/learners/example-user-id-1 «, «status»: 
 «Complete», «userDeleted»: false, 
 «ID de usuario» 
 
 : «example-user-id-1", 
 «userURL»: "https://api.reach360.com/users/example-user-id-1"
},... 
], 
 «nextUrl»: "https://url-for-next-page-of-results"} 

Códigos de error específicos de un terminal

  • learning_path_not_found- no se puede recuperar el informe porque la ruta de aprendizaje no existe

Obtenga el informe de los cursos grupales

GET /reports/groups/{groupId}/courses

Parámetros de solicitud (cadena de consulta)

  • limit(entero, opcional): el número máximo de resultados que se devolverán en una sola respuesta (consulte Paginación); debe estar entre 1 y 2000 (el valor predeterminado es 50)

Ejemplo de respuesta

< https://api.reach360.com/groups/example-group-1 >{ 
 «courses»: [
{
«courseDeleted»: false, 
 «courseID»: «example-course-1", «courseTitle»: 
 «Curso de ejemplo», «courseURL»: «», 
 «< https://api.reach360.com/courses/example-course-1 > AverageDuration»: «PT0S», 
 «CourseReportUrl»: «», 
 «< https://api.reach360.com/reports/courses/example-course-1 > EnrollmentDeleted»: false, «groupUrl» L»: 
 «», «URL siguiente»: «< 
 
 
 {«courses
»: [{«courseDeleted»: false, «courseID»: «example-course-1", «courseTitle»: «Curso de ejemplo», «courseURL»: «», «AverageDuration»: «PT0S», «CourseReportUrl»: «», «EnrollmentDeleted»: false, «groupUrl» L»: «», «siguiente URL»: «»}

Códigos de error específicos de un punto final

  • group_not_found- no se puede recuperar el informe porque el grupo no existe