Alterações na API na versão de setembro de 2026 do Adobe Learning Manager

API para verificar o acesso ao catálogo dos objetos de aprendizado

Determine se o aluno atual tem acesso direto ao catálogo de um ou mais objetos de aprendizado, independentemente de o aluno ter alcançado esse conteúdo por meio de um caminho de aprendizado ou certificação.

Finalidade da API

Quando um aluno abre um caminho de aprendizado ou uma certificação, ele pode navegar nos cursos individuais dentro dele, mesmo se um curso específico não for atribuído diretamente a ele por meio de um catálogo. Isso suporta a descoberta de conteúdo: os alunos podem explorar o que um caminho de aprendizado contém antes de decidir se o perseguirão.

No entanto, poder ver um curso dessa maneira não deve significar automaticamente que o aluno possa se inscrever nele. A inscrição deve depender de o aluno ter acesso direto ao catálogo desse curso específico, não apenas acesso indireto por meio de um caminho de aprendizado contendo.

Essa API permite verificar, para um determinado aluno, se um ou mais objetos de aprendizado podem ser acessados diretamente por meio de um catálogo atribuído a ele. Use o resultado para controlar a interface de usuário relacionada à inscrição, por exemplo, mostrando uma opção de Inscrição somente quando o acesso direto ao catálogo for confirmado, mantendo a própria página do curso visível em ambos os casos.

Ponto de extremidade

GET /primeapi/v2/learningObjects/isMemberOfVisibleCatalogs

Parâmetros de consulta

Solicitação de exemplo

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

Exemplo de resposta - 200 OK

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

Códigos de resposta

Exemplo de resposta de erro

{
  "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"
  }
}

Usar esta API na integração

Um caso de uso comum é uma página do curso que um aluno acessa navegando de um caminho de aprendizado. Você deseja que a própria página do curso permaneça acessível para descoberta, ao mesmo tempo em que mostra a ação de Inscrição somente se o aluno tiver acesso direto ao catálogo desse curso.

API de trabalho para relatório de registro de auditoria do administrador apiaudittrailreport

Finalidade da API

O Relatório de registro de auditoria do administrador lista as alterações de configuração feitas em um
Conta da Adobe Learning Manager. Por exemplo, alterações em Noções básicas, Integrações ou
Configurações avançadas da conta em um determinado intervalo de datas. A geração do relatório de Trilha de Auditoria requer a consulta e a agregação de registros de alteração de configuração no intervalo de datas solicitado e nos tipos de configuração. Dependendo do tamanho do intervalo e do volume de alterações, isso pode exceder os limites de tempo de uma solicitação HTTP síncrona, o que coloca em risco os timeouts do cliente ou gateway.

Para evitar isso, o relatório é gerado de forma assíncrona por meio da API de Trabalho genérica:

URL base e convenções

IDs

O trabalho id retornado quando um trabalho é criado é uma cadeia de caracteres opaca (por exemplo,
4593). Sempre passar para trás o valor exato de id recebido da criação
resposta ao pesquisar status. Nunca o construa ou analise.

Escopos de autenticação

Cada ponto de extremidade requer um token OAuth com o seguinte escopo e a
o usuário chamador deve ter a função de administrador de conta:

As solicitações feitas por um chamador que não mantém ROLE_ADMIN na conta são
rejeitado; consulte Manipulação de erros

Pontos finais

Criar um trabalho de Relatório de registro de auditoria

POST /primeapi/v2/jobs

Cria um trabalho assíncrono que gera um relatório de Registro de Auditoria de Alteração de Configuração
para o intervalo de datas e tipos de configuração especificados. A resposta retorna imediatamente
com um recurso de trabalho no estado QUEUED; o próprio relatório é produzido no estado
fundo.

Escopo: admin:write

Amostra do corpo da solicitação

{
  "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"]
      }
    }
  }
}

Resposta: 202 Created. O corpo da resposta é o recurso de trabalho em sua
Estado QUEUED.

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

Obter o status de um trabalho de Relatório de registro de auditoria

GET /primeapi/v2/jobs/{id}

Retorna o status atual de um job criado anteriormente. Enquanto o trabalho for
ainda em execução, attributes.status é QUEUED ou IN_PROGRESS e
attributes.result está ausente. Quando o trabalho for concluído, attributes.status é
COMPLETED, com o local do relatório em attributes.result, ou
FAILED, com detalhes da falha em attributes.error.

Escopo: admin:read

Exemplo de resposta enquanto o job ainda está em execução

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

Exemplo de resposta depois que o trabalho for concluído

{
  "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 recurso

Atributos do trabalho

Carga (incorporada, dentro da solicitação de criação)

Resultado (incorporado, dentro de um trabalho concluído)

Manipulação de erros audit-trail-report-error-handling

Os códigos a seguir se aplicam a esses parâmetros:

Exemplo de resposta de erro

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

Usar esta API na integração

Um caso de uso comum é uma ação “Baixar trilha de auditoria” voltada para o administrador na
tela configurações da conta.