Cambios en la API de la versión de septiembre de 2026 de Adobe Learning Manager

API para comprobar el acceso al catálogo de objetos de aprendizaje

Determine si el alumno actual tiene acceso directo al catálogo de uno o varios objetos de aprendizaje, independientemente de si el alumno ha alcanzado ese contenido a través de una ruta de aprendizaje o certificación.

Propósito de la API

Cuando un alumno abre una ruta de aprendizaje o una certificación, puede examinar los cursos individuales que contiene, incluso si un curso específico no se le ha asignado directamente a través de un catálogo. Esto es compatible con la detección de contenido: los alumnos pueden explorar el contenido de una ruta de aprendizaje antes de decidir si desean continuar con ella.

Sin embargo, poder ver un curso de esta forma no debería significar automáticamente que el alumno pueda inscribirse en él. La inscripción debe depender de si el alumno tiene acceso directo al catálogo de ese curso específico, no solo acceso indirecto a través de una ruta de aprendizaje contenedora.

Esta API le permite comprobar, para un alumno determinado, si se puede acceder directamente a uno o varios objetos de aprendizaje a través de un catálogo asignado a ellos. Utilice el resultado para controlar la interfaz de usuario relacionada con la inscripción; por ejemplo, para mostrar una opción de inscripción solo cuando se confirma el acceso directo al catálogo, mientras que la propia página del curso se mantiene visible en ambos casos.

Punto final

GET /primeapi/v2/learningObjects/isMemberOfVisibleCatalogs

Parámetros de consulta

Ejemplo de solicitud

GET /primeapi/v2/learningObjects/isMemberOfVisibleCatalogs?ids=course%3A2400159%2Ccourse%3A2400160%2Ccourse%3A2400161%2Ccourse%3A2400162
Accept: application/vnd.api+json
Authorization: oauth <access-token>

Ejemplo de respuesta - 200 OK

{
  "course:2400162": false,
  "course:2400161": false,
  "course:2400160": true,
  "course:2400159": true
}

Códigos de respuesta

Ejemplo de respuesta de error

{
  "status": "BAD_REQUEST",
  "title": "Bad request. Check url, params and headers",
  "source": {
    "info": "Either LO id is blank or not as per public api specification"
  }
}

Utilice esta API en su integración

Un caso de uso común es una página del curso a la que llega un alumno que navega desde una ruta de aprendizaje. Desea que la página del curso en sí siga siendo accesible para su detección, al tiempo que muestra la acción Inscribir solo si el alumno tiene acceso directo al catálogo de ese curso.

API de trabajos para el informe de seguimiento de auditoría de administración apiaudittrailreport

Propósito de la API

El informe de seguimiento de auditoría del administrador enumera los cambios de configuración realizados en un
Cuenta de Adobe Learning Manager. Por ejemplo, cambios en Conceptos básicos, Integraciones o
Configuración avanzada de la cuenta para un intervalo de fechas determinado. Para generar el informe de seguimiento de auditoría es necesario consultar y agregar registros de cambios de configuración en el intervalo de fechas solicitado y en los tipos de configuración. Según el tamaño del intervalo y el volumen de cambios, esto puede superar los límites de tiempo de una solicitud HTTP síncrona, lo que supone un riesgo de tiempo de espera de cliente o puerta de enlace.

Para evitar esto, el informe se genera de forma asincrónica a través de la API de trabajos genérica:

URL base y convenciones

ID

El trabajo id devuelto cuando se crea un trabajo es una cadena opaca (por ejemplo,
4593). Devolver siempre el valor exacto de id que recibió del archivo creado
respuesta al sondear por estado. Nunca lo construya ni lo analice.

Ámbitos de autenticación

Cada extremo requiere un token de OAuth que incluya el siguiente ámbito, y el
el usuario que realiza la llamada debe tener la función de administrador de la cuenta:

Las solicitudes realizadas por un llamador que no tiene ROLE_ADMIN en la cuenta son
rechazada; consulte Control de errores

Terminales

Crear un trabajo de informe de seguimiento de auditoría

POST /primeapi/v2/jobs

Crea un trabajo asincrónico que genera un informe de seguimiento de auditoría de cambio de configuración
para el intervalo de fechas y los tipos de configuración especificados. La respuesta regresa inmediatamente
con un recurso de trabajo en el estado QUEUED; el propio informe se elabora en el
fondo.

Ámbito: admin:write

Cuerpo de solicitud de muestra

{
  "data": {
    "type": "job",
    "attributes": {
      "jobType": "generateConfigChangeAuditReport",
      "payload": {
        "fromDate": "2026-09-15T00:00:00.000+05:30",
        "toDate": "2026-09-23T23:59:59.000+05:30",
        "settingTypes": ["Basics", "Integrations", "Advanced"]
      }
    }
  }
}

Respuesta: 202 Created. El cuerpo de respuesta es el recurso de trabajo en su
Estado QUEUED.

{
  "data": {
    "id": "4593",
    "type": "job",
    "attributes": {
      "jobType": "generateConfigChangeAuditReport",
      "status": "QUEUED",
      "dateCreated": "2026-09-23T18:12:04.000+05:30"
    }
  }
}

Obtener el estado de un trabajo de informe de seguimiento de auditoría

GET /primeapi/v2/jobs/{id}

Devuelve el estado actual de un trabajo creado anteriormente. Mientras que el trabajo es
aún en ejecución, attributes.status es QUEUED o IN_PROGRESS y
attributes.result está ausente. Una vez que finalice el trabajo, attributes.status se
COMPLETED, con la ubicación del informe en attributes.result, o
FAILED, con detalles de error en attributes.error.

Ámbito: admin:read

Ejemplo de respuesta mientras el trabajo aún se está ejecutando

{
  "data": {
    "id": "4593",
    "type": "job",
    "attributes": {
      "jobType": "generateConfigChangeAuditReport",
      "status": "IN_PROGRESS",
      "dateCreated": "2026-09-23T18:12:04.000+05:30"
    }
  }
}

Muestra de respuesta una vez completado el trabajo

{
  "data": {
    "id": "4593",
    "type": "job",
    "attributes": {
      "jobType": "generateConfigChangeAuditReport",
      "status": "COMPLETED",
      "dateCreated": "2026-09-23T18:12:04.000+05:30",
      "dateCompleted": "2026-09-23T18:12:41.000+05:30",
      "result": {
        "downloadUrl": "https://learningmanager.adobe.com/primeapi/v2/jobs/4593/download",
        "expiresAt": "2026-09-24T18:12:41.000+05:30"
      }
    }
  }
}

Esquema de recursos

Atributos de trabajo

Carga útil (incrustada, dentro de la solicitud de creación)

Resultado (incrustado, dentro de un trabajo completado)

Gestión de errores audit-trail-report-error-handling

Los siguientes códigos se aplican a estos puntos finales:

Ejemplo de respuesta de error

{
  "status": "BAD_REQUEST",
  "title": "Bad request. Check url, params and headers",
  "source": {
    "info": "toDate must be on or after fromDate"
  }
}

Utilice esta API en su integración

Un caso de uso común es una acción de “Descargar seguimiento de auditoría” orientada al administrador en el
la pantalla de configuración de cuenta.