O que esse endpoint de API faz

A API Import Course Completion fornece informações diferentes, dependendo se é um curso do Articulate 360 ou um curso de conteúdo importado de terceiros. Para todos os cursos, os administradores verão quando os usuários foram matriculados no curso. O curso será adicionado às bibliotecas do aluno e marcado como concluído. Quando lançado, ele começa do início. Os cursos importados não incluem dados de relatórios em nível de pergunta.

Os cursos de terceiros não mostrarão a pontuação do questionário quando importados. Isso pode fazer com que um curso seja marcado como concluído com uma pontuação baixa no questionário, mesmo que o questionário seja um requisito de conclusão. Responder ao questionário após a conclusão ser importada registrará uma nova pontuação do questionário.

Quando as conclusões do curso do Articulate 360 forem importadas, se houver um requisito de questionário, ele será definido para uma pontuação de 100% que será refletida na biblioteca do aluno. Os alunos veem a página de resultados do questionário ao visualizar o questionário e, se permitido, podem responder ao questionário novamente. A tentativa deles é registrada no relatório de atividades com uma nova pontuação do questionário, mas o status do curso e a pontuação de 100% do questionário permanecem.

• Endpoints
• Importar dados de conclusão

Endpoints

• POST /courses/{courseId}/users/{userId}/completions- importe dados de conclusão de um único par de curso/usuário para o Rise.

Importar dados de conclusão

POST /courses/{courseId}/users/{userId}/completions

Notas:

• O registro de conclusão está associado à versão atual publicada do curso
• Os parâmetros de data são refletidos nas colunas Duração de vários relatórios (ou seja, a duração de uma conclusão importada é calculada como a diferença entre startedAt ecompletedAt). As visualizações de relatórios no Reach 360 podem levar até 5 minutos para serem atualizadas.
• Várias chamadas para esse endpoint com o mesmo courseId e userId substituirão os parâmetros de data fornecidos nas chamadas anteriores (ou seja, esse endpoint criará apenas um único registro de conclusão para um determinado par de cursos e usuários, independentemente de quantas vezes ele for chamado)
• O usuário não precisa estar matriculado no curso antes da solicitação. Nesse caso, uma nova matrícula de aluno é criada. Se eles estiverem matriculados, no entanto, a inscrição existente será usada.

Parâmetros de solicitação (JSON)

• completedAt(Data ISO 8601, obrigatória) - quando o usuário concluiu o curso
• startedAt(Data ISO 8601, obrigatória) - quando o usuário iniciou o curso

Resposta de sucesso

202 “Aceito”

Códigos de erro específicos do endpoint:

• course_not_found
• course_not_published
• user_not_found