Opetussuunnitelma sisältää opetussuunnitelman kuvaustiedot, tiedot ajoitussuunnitelmista ja opintopoluista sekä listan rakennenäkymiä.

Oliomalli

Opetussunnitelma sisältää kuvaustiedot ja listan rakennenäkymiä.

KenttäTyyppiKuvaus
idnumeroOpetussuunnitelman yksilöllinen tunniste
codetekstiTunnus
nametekstiNimi
descriptiontekstiKuvaus
contenttekstiSisältö
furtherInformationtekstiLisätiedot
currentStatustekstiOpetussuunnitelman tila, luonnos "DRAFT", valmis hyväksyttäväksi "READY", hyväksytty "APROVED", julkaistu "PUBLISHED"
durationnumeroOpetussuunnitelman kesto
languagetekstiOpetussuunnitelman kieli
planslistaLista ajoitussuunnitelmien kuvaustietoja, jotka on liitetty opetussuunnitelmaan
specialisationOptionslistaLista opintopolkujen kuvaustietoja, jotka on liitetty opetussuunnitelmaan
structureViewslistaLista rakennenäkymiä.

 

Opintojakson kuvaustiedot

KenttäTyyppiKuvaus
idnumeroOpintojakson yksilöllinen tunniste
codetekstiTunnus
nametekstiNimi
creditsnumeroOpintopistemäärä
currentStatustekstiOpintojakson tila
yearOfFoundationnumeroPerustamisvuosi
teachingLanguagetekstiOpetuskieli
contenttekstiOpintojakson sisältö
furtherInformationtekstiLisätiedot
qualificationstekstiEsitietovaatimukset
objectivetekstiOsaamistavoitteet
evaluationCriteria1tekstiArviointikriteeri, tyydyttävä (1-2)
evaluationCriteria2tekstiArviointikriteeri, hyvä (3-4)
evaluationCriteria3tekstiArviointikriteeri, kiitettävä (5)
evaluationCriteria4tekstiArviointikriteeri, hyväksytty/hylätty
teachingMethodstekstiOpetusmetodit
materialstekstiMateriaalit

Haku

Haku palauttaa sisällön kielen mukaan seuraavasti. Ensisijaisesti käytetään pyynnön header-tietoihin asetettua "Accept-Language" tietoa, muuten kielitieto luetaan erillisestä parametrista esim. "?l=fi". Oletuksena käytetään suomea.

Opetussuunnitelmien haku

 

KenttäTyyppiKuvaus
nametekstiOpetussuunnitelman nimi
codeslistaLista opetussuunnitelman tunnuksia
specialisationStructureViewslistaLista opintopolkuja, joille halutaan oma rakennenäkymä. Mikäli halutaan palauttaa rakennenäkymät jokaista opintopolkua varten, asetetaan listan ensimmäiseksi tunnisteeksi "all"
accomplishmentPlanStructureViewslistaLista ajoitussuunnitelmien tunnisteita, joille halutaan oma rakennenäkymä. Mikäli halutaan palauttaa rakennenäkymät jokaista ajoitussuunnitelmaa varten, asetetaan listan ensimmäiseksi tunnisteeksi "all"

Esimerkki:

{
"codes": ["GS05S_W0808"],
"specialisationStructureViews": ["all"],
"accomplishmentPlanStructureViews": ["all"]
}

Opetussuunnitelman hakeminen tunnuksen perusteella:

curl -u "oma_api_key:" -X POST https://opendata.metropolia.fi/r1/curriculum/search -d '{ "codes": ["GS05S_W0808"]}'

 

Vastaus

KenttäKuvaus
statusTieto onnistuiko pyyntö vai oliko mahdollisia virheitä. "success", "warn", "error"
messageMahdollinen tarkentava viesti esimerkiksi virhetilanteissa.
programmesOpetussuunnitelmien tiedot

Esimerkki:

{
   "status": "success",
   "programmes": [   {
      "id": "62868",
      "code": "GS05S_W0808",
      "currentStatus": "DRAFT",
      "duration": 4,
      "language": "fi",
      "plans": [      {
         "id": "3308",
         "startSemester": 0,
         "startYear": 2012,
         "name": "Oletussuunnitelma"
      }],
      "specialisationOptions": [      {
         "id": "370",
         "name": "Graafinen suunnittelu",
         "shortName": "Graafi",
         "description": "GRAAFINE"
      }],
      "structureViews":       [
                  {
            "id": "182222",
            "relations":             [
                              {
                  "id": "182222",
                  "level": "0",
                  "treeId": "182222",
                  "learningUnit":                   {
                     "id": "62868",
                     "code": "GS05S_W0808",
                     "credits": 182,
                     "type": "PROGRAMME",
                     "status": "DRAFT",
                     "name": "Viestinnän koulutusohjelma"
                  }
               },
                              {
                  "id": "182223",
                  "level": "1",
                  "treeId": "182222",
                  "learningUnit":                   {
                     "id": "62869",
                     "code": "GS05S_W0808-1000",
                     "credits": 50,
                     "type": "STUDY_MODULE",
                     "status": "DRAFT",
                     "luOptionality": "ALL_OF",
                     "name": "Perusopinnot"
                  }
               },
                              {
                  "id": "182225",
                  "level": "2",
                  "treeId": "182222",
                  "learningUnit":                   {
                     "id": "78459",
                     "code": "MUK1011",
                     "credits": 3,
                     "type": "COURSE_UNIT",
                     "status": "DRAFT",
                     "name": "Piirustus ja maalaus I"
                  }
               }
            ]
         },
                  {
            "id": "s370",
            "relations":             [
                              {
                  "id": "182222",
                  "level": "0",
                  "treeId": "182222",
                  "learningUnit":                   {
                     "id": "62868",
                     "code": "GS05S_W0808",
                     "credits": 6,
                     "type": "PROGRAMME",
                     "status": "DRAFT",
                     "name": "Viestinnän koulutusohjelma"
                  }
               }
            ]
         },
                  {
            "id": "a3308",
            "relations":             [
                              {
                  "id": "182222",
                  "level": "0",
                  "treeId": "182222",
                  "learningUnit":                   {
                     "id": "62868",
                     "code": "GS05S_W0808",
                     "credits": 182,
                     "type": "PROGRAMME",
                     "status": "DRAFT",
                     "name": "Viestinnän koulutusohjelma"
                  },
                  "periods":                   [
                                          {
                        "credits": 0,
                        "periodNumber": 0
                     },
                                          {
                        "credits": 0,
                        "periodNumber": 1
                     },
                                          {
                        "credits": 0,
                        "periodNumber": 2
                     },
                                          {
                        "credits": 0,
                        "periodNumber": 3
                     },
                                          {
                        "credits": 0,
                        "periodNumber": 4
                     },
                                          {
                        "credits": 0,
                        "periodNumber": 5
                     },
                                          {
                        "credits": 0,
                        "periodNumber": 6
                     },
                                          {
                        "credits": 0,
                        "periodNumber": 7
                     },
                                          {
                        "credits": 0,
                        "periodNumber": 8
                     },
                                          {
                        "credits": 0,
                        "periodNumber": 9
                     },
                                          {
                        "credits": 0,
                        "periodNumber": 10
                     },
                                          {
                        "credits": 0,
                        "periodNumber": 11
                     },
                                          {
                        "credits": 0,
                        "periodNumber": 12
                     },
                                          {
                        "credits": 0,
                        "periodNumber": 13
                     },
                                          {
                        "credits": 0,
                        "periodNumber": 14
                     },
                                          {
                        "credits": 0,
                        "periodNumber": 15
                     }
                  ]
               }
            ]
         }
      ],
      "name": "Viestinnän koulutusohjelma",
      "description": "",
      "content": "",
      "development": "",
      "furtherInformation": ""
   }]
}

 

Opintojaksojen haku

 

KenttäTyyppiKuvaus
nametekstiOpintojakson nimi
codeslistaLista opintojaksojen tunnuksia

Esimerkki:

{
"codes": ["TD00AB32"]
}

Opintojakson hakeminen tunnuksen perusteella:

curl -u "oma_api_key:" -X POST https://opendata.metropolia.fi/r1/courseunit/search -d '{ "codes": ["TD00AB32"]}'

 

Vastaus

KenttäKuvaus
statusTieto onnistuiko pyyntö vai oliko mahdollisia virheitä. "success", "warn", "error"
messageMahdollinen tarkentava viesti esimerkiksi virhetilanteissa.
courseUnitsOpintojaksot

Esimerkki:

{
   "status": "success",
   "courseUnits": [   {
      "id": "89460",
      "code": "TD00AB32",
      "credits": 3,
      "currentStatus": "DRAFT",
      "yearOfFoundation": 2011,
      "name": "Ohjelmointi 2",
      "content": "1. Muuttujat ja tietotyypit.\r\n2. Ohjelman perusrakenteet: peräkkäisyys, valinta ja toisto.\r\n3. Tietorakenteet, esim. taulukot ja tietueet.\r\n4. Omien funktioiden ja aliohjelmien määrittely.\r\n5. Tekstitiedostojen käyttö.\r\n6. Olio-ohjelmoinnin perusteet.",
      "furtherInformation": "",
      "qualifications": "Ohjelmointi 1",
      "objective": "- Opiskelija osaa ohjelmoida jollakin Olio-ohjelmointikielellä (C++, C#, Java).\r\n- Opiskelija osaa ohjelmointikielen perusrakenteet ja toiminnan. \r\n- Opiskelija tuntee Olio-ohjelmoinnin peruskäsitteet: luokka, olio, metodi ja attribuutti.",
      "evaluationCriteria1": "Kokeessa suoritettu vähintään 40 % oikein ja suurin osa kurssin viikkotehtävistä on suoritettu.",
      "evaluationCriteria2": "Kokeessa suoritettu vähintään 60 % oikein ja suurin osa kurssin viikkotehtävistä on suoritettu.",
      "evaluationCriteria3": "Kokeessa suoritettu vähintään 80 % oikein ja kaikki kurssin viikkotehtävät on suoritettu.",
      "evaluationCriteria4": "",
      "teachingMethods": "",
      "materials": ""
   }]
}