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äysEXAM versiomuutos
25.2.2021
  • Lisätty esimerkkeihin versiot 5.3.0 → mukaisista UTC-aikoja näyttävistä rajapinnan vastauksista.
  • Lisätty tämä Muutokset rajapintaan -taulukko.
5.11.20205.3.0

Rajapinnan vastausten examActiveStartDate ja examActiveEndDate aikatiedot ISO 8601 standardin mukaisina UTC aikoina (aiemmin millisekunteina/Unix-aikaleimoina)

21.12.20173.3.4Alkuperä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"
      }
    ]
  }
]
  • No labels