Resum
Qwickly s'integra amb els LMS mitjançant LTI 1.3 per al llançament de l'eina i utilitza APIs REST per a la comunicació contínua, autenticant els usuaris amb un flux OAuth de tres passos. Els tokens d'API generats duren aproximadament 60 minuts i s'utilitzen per obtenir i actualitzar dades com assistència i qualificacions dins del LMS, amb la possibilitat de renovar el token simplement reiniciant l'eina.
1. Ús de LTI per iniciar l'eina
Qwickly Attendance, Course Tools i Jot estan instal·lats al vostre LMS (Blackboard Learn/Canvas/Desire2Learn Brightspace) com una eina LTI 1.3. Aquesta connexió LTI 1.3 s'utilitza simplement com un punt d'inici per a Qwickly des del vostre LMS, i la major part de la comunicació posterior entre Qwickly i el vostre LMS es fa a través de les API REST del vostre LMS.
- Qwickly només pren els següents valors de la sol·licitud inicial de llançament LTI: el domini del LMS que fa la sol·licitud, l'ID del curs del LMS des d'on s'ha obert l'enllaç i l'ID d'usuari del LMS de l'usuari actual
2. Ús d'APIs REST per comunicar-se amb el LMS
Qwickly segueix un flux de treball OAuth de 3 passos amb el vostre LMS per generar un token API per a l'usuari que està utilitzant Qwickly. Aquest procés permet al LMS autenticar la identitat de l'usuari connectat i generar un token API en nom seu que serà utilitzat per Qwickly. Aquest token és utilitzat per Qwickly en nom de l'usuari connectat per carregar informació des del LMS (com ara informació d'usuari, informació del curs, informació d'inscripció, etc.)
- Si un usuari té un token/sessió prèvia existent amb Qwickly des del mateix navegador, Qwickly haurà emmagatzemat en memòria cau algunes dades de la sessió anterior i pot evitar fer certes sol·licituds (com recarregar les inscripcions d'un curs si aquesta informació ja estava emmagatzemada en memòria cau prèviament)
- Cada token API generat des d'un LMS dura aproximadament 60 minuts. Per tant, si un usuari ha estat utilitzant Qwickly de manera contínua durant més de 60 minuts, pot notar que certes accions com la integració amb el llibre de qualificacions poden no funcionar com s'espera (ja que el token API haurà caducat). En aquest cas, l'usuari només ha de tancar la finestra de Qwickly i tornar a iniciar Qwickly des del LMS, moment en què l'eina hauria d'actualitzar i renovar el token API
Gairebé totes les sol·licituds API REST de Qwickly al LMS són sol·licituds GET.
Si la qualificació està habilitada, Qwickly Attendance pot fer sol·licituds POST/PUT/DELETE al vostre LMS
- Les sol·licituds POST/PUT es farien per crear o actualitzar les qualificacions d’assistència registrades des de Qwickly Attendance al LMS
- Les sol·licituds DELETE es farien si s’apaga una integració de qualificació existent dins de Qwickly Attendance
- Si les configuracions de qualificació estan activades, Qwickly Attendance fa aquestes sol·licituds API al vostre LMS després que s’hagi pres l’assistència. En cas que un token API falli, les qualificacions actualitzades de Qwickly Attendance poden no mostrar-se correctament. Aquest article explica què fer en aquest cas.
Última edició: Canviat de 1.1 a 1.3, i s’han inclòs tots els productes Qwickly.
Comentaris
0 comentaris
Iniciï sessió per deixar un comentari.