API авторизацияның екі тәсілін қолдайды. Екі тәсіл де бір базалық мекенжайды және бірдей операция жолдарын пайдаланады; олар сұрау субъектісі мен қолжетімді мәліметтер көлемі бойынша ерекшеленеді.
| БЕЛГІ | API ТОКЕНІ | QAIRU АРҚЫЛЫ КІРУ |
|---|---|---|
| Сұрау субъектісі | Сыртқы ақпараттық жүйе | Келісім берген студент |
| Қолжетімділік беру | Университет әкімшілігі токен шығарады | Университет әкімшілігі қосымшаны тіркейді, студент келісім экранында қолжетімділікке рұқсат береді |
Authorization тақырыбының мәні | qos_… түріндегі токен | Keycloak қолжетімділік токені (JWT) |
| Мәліметтер көлемі | Токенде көрсетілген модульдердің мәліметтері | Берілген модульдер шегінде студенттің өзіне қолжетімді мәліметтер |
| Қолданылу мерзімі | Токенді шығару кезінде белгіленеді | Қолжетімділік токені — 1 сағат, сеанс — 30 күнге дейін |
| Қолжетімділікті кері қайтарып алу | Университет әкімшілігі | Студент кабинетте немесе университет әкімшілігі |
3.1. Тәсілді таңдау
- API токені ақпараттық жүйелерді біріктіру үшін: анықтамалық мәліметтерді, сабақ кестесін, пәндер каталогын алу үшін, сондай-ақ ұйым атынан Alem модельдеріне жүгіну үшін қолданылады.
- «QAIRU арқылы кіру» сыртқы платформа нақты студенттің мәліметтерімен — оның сабақ кестесімен, тапсырмаларымен, бағаларымен, жобаларымен жұмыс істеген кезде қолданылады.
Авторизация тәсілі Authorization: Bearer тақырыбының мәні бойынша айқындалады: qos_ таңбаларынан басталатын мән API токені ретінде, кез келген басқа мән Keycloak қолжетімділік токені ретінде қарастырылады. x-api-key тақырыбы тек API токенін қабылдайды.
Екі тәсіл де серверлік қосымшаларға арналған. API токені, клиент құпиясы және студент токендері браузерде немесе мобильді қосымшада орындалатын кодта, сондай-ақ жалпыға қолжетімді репозиторийлерде орналастырылмайды.