Examiin on toteutettu REST-rajapintaan resurssi, jolla aktiivisten tenttien tiedot voidaan hakea ulkopuolisiin toteutuksiin. Haku palauttaa kaikki tentit, jotka ovat aktiivisia tiettynä ajanhetkenä. Aktiivisella tarkoitetaan, että tentti on yleinen, julkaistu ja sen tenttiperiodi on voimassa tai astuu voimaan tulevaisuudessa.
Muutokset rajapintaan/dokumentaatioon
päiväys | EXAM versio | muutos |
---|---|---|
25.2.2021 |
| |
5.11.2020 | 5.3.0 | Rajapinnan vastausten examActiveStartDate ja examActiveEndDate aikatiedot ISO 8601 standardin mukaisina UTC aikoina (aiemmin millisekunteina/Unix-aikaleimoina) |
21.12.2017 | 3.3.4 | Alkuperäinen rajapinta |
REQUEST
URL: /integration/exams/active
Metodi: GET
Query parameters:
- date: näytä tentit, jotka ovat aktiivisia ajanhetkellä t. Oletuksena nykyhetki.
- vapaaehtoinen
- muoto: ISO-8601
Esim: GET /integration/exams/active?date=2016-05-01
RESPONSE
content-type: application/json
status: 200 - OK
esimerkkivastaus EXAM versiot 5.3.0 alkaen:
- examActiveStartDate ja examActiveEndDate aikatiedot ovat ISO 8601 standardin mukaisina UTC aikoina
[ { "id":2044, "name": "Algoritmit, ITK-testistä", "course": { "code": "811386A", "name": "Algoritmit", "credits": 5.0, "gradeScale": null, "organisation": { "code": "123", "name": "Demo-Yliopisto", "nameAbbreviation": "DY" } }, "examType": { "type": "PARTIAL" }, "examOwners": [ { "email": "suvi.opettaja@funet.fi", "lastName": "Opettaja", "firstName": "Suvi" } ], "enrollInstruction": "Lue tenttiin hyvin", "examActiveStartDate": "2015-04-06T00:00:00.000Z", "examActiveEndDate": "2020-08-31T20:59:59.999Z", "duration": 110, "gradeScale": { "description": "APPROVED_REJECTED", "externalRef": null, "displayName": null }, "examLanguages": [ { "code": "en", "name": "Englanti" }, { "code": "fi", "name": "Suomi" } ] }, { "id":2024, "name": "20.1.17 Pasin 1. tentti", "course": { "code": "2124806", "name": "Kvalitatiivisten tutkimusten lukeminen ja tulkinta", "credits": 2.0, "gradeScale": { "description": "OTHER", "externalRef": 11, "displayName": "HYL-HYV" }, "organisation": { "code": null, "name": "Itä-Suomen yliopisto", "nameAbbreviation": null } }, "examType": { "type": "FINAL" }, "examOwners": [ { "email": "opettaja2@funet.fi", "lastName": "Opettaja2", "firstName": "Ope" }, { "email": "opettaja3@funet.fi", "lastName": "Opettaja3", "firstName": "Ope3" } ], "enrollInstruction": "dsgdg", "examActiveStartDate": "2017-01-20T00:00:00.000Z", "examActiveEndDate": "2019-01-21T21:59:59.999Z", "duration": 45, "gradeScale": { "description": "ZERO_TO_FIVE", "externalRef": null, "displayName": null }, "examLanguages": [ { "code": "fi", "name": "Suomi" }, { "code": "en", "name": "Englanti" } ] } ]
esimerkkivastaus EXAM versio 5.2.1 ja aikaisemmat
- examActiveStartDate ja examActiveEndDate aikatiedot ovat UNIX timestamp muodossa
[ { "id":2044, "name": "Algoritmit, ITK-testistä", "course": { "code": "811386A", "name": "Algoritmit", "credits": 5.0, "gradeScale": null, "organisation": { "code": "123", "name": "Demo-Yliopisto", "nameAbbreviation": "DY" } }, "examType": { "type": "PARTIAL" }, "examOwners": [ { "email": "suvi.opettaja@funet.fi", "lastName": "Opettaja", "firstName": "Suvi" } ], "enrollInstruction": "Lue tenttiin hyvin", "examActiveStartDate": 1428267600000, "examActiveEndDate": 1598907599999, "duration": 110, "gradeScale": { "description": "APPROVED_REJECTED", "externalRef": null, "displayName": null }, "examLanguages": [ { "code": "en", "name": "Englanti" }, { "code": "fi", "name": "Suomi" } ] }, { "id":2024, "name": "20.1.17 Pasin 1. tentti", "course": { "code": "2124806", "name": "Kvalitatiivisten tutkimusten lukeminen ja tulkinta", "credits": 2.0, "gradeScale": { "description": "OTHER", "externalRef": 11, "displayName": "HYL-HYV" }, "organisation": { "code": null, "name": "Itä-Suomen yliopisto", "nameAbbreviation": null } }, "examType": { "type": "FINAL" }, "examOwners": [ { "email": "opettaja2@funet.fi", "lastName": "Opettaja2", "firstName": "Ope" }, { "email": "opettaja3@funet.fi", "lastName": "Opettaja3", "firstName": "Ope3" } ], "enrollInstruction": "dsgdg", "examActiveStartDate": 1484870400000, "examActiveEndDate": 1548107999999, "duration": 45, "gradeScale": { "description": "ZERO_TO_FIVE", "externalRef": null, "displayName": null }, "examLanguages": [ { "code": "fi", "name": "Suomi" }, { "code": "en", "name": "Englanti" } ] } ]