Resumo
Qwickly se integra aos sistemas LMS (como Blackboard, Canvas e Desire2Learn) utilizando LTI 1.3 para o lançamento da ferramenta e REST APIs para comunicação contínua, autenticando usuários via OAuth para acessar informações do curso e do usuário. A ferramenta gerencia tokens de API com duração aproximada de 60 minutos e realiza requisições GET para obter dados, além de POST/PUT/DELETE para atualizar ou remover registros de presença e notas, garantindo a sincronização entre Qwickly e o LMS.
1. Usando LTI para iniciar a ferramenta
Qwickly Attendance, Course Tools e Jot estão instalados no seu LMS (Blackboard Learn/Canvas/Desire2Learn Brightspace) como uma ferramenta LTI 1.3. Essa conexão LTI 1.3 é usada simplesmente como um ponto de lançamento para o Qwickly a partir do seu LMS, e a maior parte da comunicação subsequente entre o Qwickly e seu LMS é feita através das APIs REST do seu LMS.
- O Qwickly apenas utiliza os seguintes valores da requisição inicial de lançamento LTI: o domínio do LMS solicitante, o ID do curso no LMS de onde o link foi aberto e o ID do usuário atual no LMS
2. Usando APIs REST para comunicar-se com o LMS
O Qwickly segue um fluxo OAuth de 3 etapas com seu LMS para gerar um token de API para o usuário que está usando o Qwickly. Esse processo permite que o LMS autentique a identidade do usuário logado e gere um token de API em nome dele, que será usado pelo Qwickly. Esse token é usado pelo Qwickly em nome do usuário logado para carregar informações do LMS (como informações do usuário, informações do curso, informações de matrícula, etc.)
- Se um usuário já possui um token/sessão existente com o Qwickly no mesmo navegador, o Qwickly terá armazenado em cache alguns dados da sessão anterior e pode evitar fazer certas requisições (como recarregar as matrículas de um curso se essa informação já estiver armazenada em cache anteriormente)
- Cada token de API gerado a partir de um LMS dura aproximadamente 60 minutos. Portanto, se um usuário estiver usando o Qwickly continuamente por mais de 60 minutos, ele pode perceber que certas ações, como a integração com o livro de notas, podem não estar funcionando como esperado (pois o token de API terá expirado). Nesse caso, o usuário pode simplesmente fechar a janela do Qwickly e relançar o Qwickly a partir do LMS, momento em que a ferramenta deve atualizar e renovar o token de API
Quase todas as requisições da API REST do Qwickly para o LMS são requisições GET.
Se a avaliação estiver habilitada, o Qwickly Attendance pode fazer requisições POST/PUT/DELETE para o seu LMS
- Solicitações POST/PUT seriam feitas para criar ou atualizar notas de presença registradas pelo Qwickly Attendance no LMS
- Solicitações DELETE seriam feitas se uma integração de notas existente dentro do Qwickly Attendance fosse desativada
- Se as configurações de notas estiverem ativadas, o Qwickly Attendance faz essas solicitações de API para o seu LMS após a presença ser registrada. No caso de uma falha no token da API, as notas atualizadas do Qwickly Attendance podem não aparecer corretamente. Este artigo explica o que fazer nesse caso.
Última edição: Alterado de 1.1 para 1.3, e incluídos todos os produtos Qwickly.
Comentários
0 comentários
iniciar sessão para comentar.