Op deze pagina wordt uiteengezet hoe de beschrijving van het European Credit Transfer System (ECTS) Course Catalog zich verhoudt tot de Open Onderwijs API (OOAPI) specificatie v3. Van projecten die meedoen aan de SURF stimuleringsregeling Uitwisselen onderwijsaanbod-data wordt verwacht dat zij minimaal de volgende endpoints van de OOAPI v3 specificatie implementeren, met daarin in ieder geval de velden zoals die in onderstaande tabellen beschreven staan:

Optioneel is het implementeren van de volgende endpoints. Die zijn van belang om informatie over personen te kunnen leveren (bijvoorbeeld de gegevens van docenten van een cursus). Dit betreft:

Meer informatie over deze endpoints is te vinden in de OOAPI specificatie v3 en in de wikipagina over optionele endpoints.


Evaluatie datamodel n.a.v. regeling

Institution (GET /institution)

This table describes the mapping from ECTS CC to the OOAPv3 insitution object.

https://rawgit.com/open-education-api/specification/v3/docs.html#tag/institution/paths/~1institution/get

Attribute (ECTS CC)Description (ECTS CC)Attribute (OOAPI v3)Description (OOAPI v3)

Name and address

Name in the national language. If the institution has a name in a widely-spoken language, such as English, this name should also be given. List of campuses and addresses at which the institution is established.

  • name
  • address
  • Name of the institution
  • the full street address including house number and street name of main building

Description of the institution (including type and status)

Any general description of the institution should clearly mention the type of higher education institution, especially in the case of a binary system.

In Dutch: universiteit (university) or hogeschool (university of applied sciences).

  • description
  • Any general description of the institution should clearly mention the type of higher education institution, especially in the case of a binary system. In Dutch; universiteit (university) or hogeschool (university of applied sciences).

Academic calendar

Start and end of the academic year (specify per year, if these dates vary over the years) and main holidays.
  • academicCalendar
  • links to academic calenders per year

List of programmes offered

Provide a comprehensive survey of the faculties or schools and the degree programmes (Ad, B, M, PhD) that are offered. The names of the degree programmes should be available in a widely-spoken language and in the language of instruction.

In the Netherlands: Programmes that are taught in Dutch, should list the Dutch and English name of the programme. If the Dutch-taught programme has an English name (in CROHO), this does not need to be translated into Dutch.

  • _links to educational-programmes
  • Link to the list of educational programmes at this institution


  • InstitutionId
  • id of the institution


  • brin
  • Brincode of the institution


  • logo
  • uri to logo of the institution

Courses (GET /courses)

This table describes the mapping from ECTS CC Educational Components to the OOAPv3 course object.

https://rawgit.com/open-education-api/specification/v3/docs.html#tag/courses/paths/~1courses/get

Attribute (ECTS CC)Description (ECTS CC)Attribute (OOAPI v3)Description (OOAPI v3)

Code

Code that is assigned to the component in the institution’s student administration system.
  • courseId
  • Unique id of this course
TitleMake sure that the English translation of the name of the individual educational component tallies with the names listed on the Transcript of Records (which is part of the Diploma Supplement)
  • name
  • The name of this course (ECTS-Title)
Semester/trimester when the component is deliveredIndicate whether the component if (only) offered in the first or second semester of the academic year, or in both.
  • schedule
  • A description of the timeframes, when this course takes place (ECTS-Semester/trimester when the component is delivered)
Number of ECTS credits allocatedGive the number of ECTS credits that has been allocated to this component.
  • ects
  • The number of EC's that is earned when the course is completed successfully (ECTS-ects)
Learning outcomesProvide a list of the learning outcomes for this component.
  • learningOutcomes
  • Statements that describe the knowledge or skills students should acquire by the end of a particular course (ECTS-learningoutcome)
Name of lecturer(s)Provide information on the lecturer(s) that are responsible for teaching this component. It may be an institution’s policy not to provide names and contact details of individual members of staff on the institution’s website. In that case, general contact details should be provided.
  • _links to lecturers

  • Links to the lecturers (persons) of this course (ECTS-lecturers)

Mode of deliveryProvide information on the mode of delivery of the component, e.g. via e-learning, face-to-face, etc.
  • modeOfDelivery
  • information on the mode of delivery of the component, e.g. via e-learning, face-to-face, etc. (ECTS-Mode of delivery)
Prerequisites and co-requisites (if applicable)Provide information on whether a student must have successfully completed certain courses before s/he can take this course.
  • requirements
  • The requirements needed to enter this course (ECTS-prerequisites)
Course contentProvide a brief description of the content of the course. This information bears a close link to the learning outcomes of the component, but has a different function.
  • description
  • The description of this course (ECTS-description)
Recommended or required reading and other learning resources/toolsProvide a list of the (most important) literature that students are required or recommended to read, but also include other learning resources. The information is not only relevant for students, but also for (potential) partners, in that it indicates the main focus and the approach that is used.
  • resources
  • An overview of the literature and other resources that is used in this course (ECTS-recommended reading and other sources)
Planned learning activities and teaching methodsList the most important modes of delivery for this component, e.g. lectures, group work, seminars, tutorials, etc.
  • format
  • The format in which this course is given (ECTS-format) (mutlivalue)
Assessment methods and criteriaProvide information on how this component will be assessed, e.g. by means of a written or oral exam, a report, a presentation, a project, group work assessment.
  • exams
  • A description of the way exams for this course are taken (ECTS-assessment method and criteria)
Language of instructionIndicate in which language(s) the component is taught. If the component is taught in the domestic language (in The Netherlands, Dutch), but may include guest lectures given by international guest lecturers or group work with international groups of students, it is relevant to mention that the language of instruction can also be English.
  • mainLanguage
  • The main language in which this course is given, RFC3066 (ECTS-language of instriction)
Required fields in the OOAPI spec


  • _links to course offerings
  • Link to the list of courseOfferings for this course
Extra fields in the OOAPI spec


  • abbreviation
  • The abbreviation or internal code used to identify this course (ECTS-code)


  • level
  • The level of this course (see service metadata for possible values) (ECTS-year of study if applicable)


  • goals
  • The description of the main goal of this course


  • enrollment
  • The extra information that is provided for enrollment


  • link
  • The url containing the address of the website with more information about the course


Course offerings (GET /course-offerings)

This table describes the mapping from ECTS CC to the OOAPv3 course-offering object.

https://rawgit.com/open-education-api/specification/v3/docs.html#tag/course-offerings/paths/~1course-offerings/get

Attribute (ECTS CC)Description (ECTS CC)Attribute (OOAPI v3)Description (OOAPI v3)
Semester/trimester when the component is deliveredIndicate whether the component if (only) offered in the first or second semester of the academic year, or in both.
  • period
  • academicYear

  • The period in which this courseOffering is offered

  • The year in which this courseOffering takes place
Required fields in the OOAPI spec


  • courseOfferingId
  • Unique id of this course offering


  • course

  • The course object of which this courseOffering is an instance

Extra fields in the OOAPI spec


  • _links to lecturers

  • Links to the lecturers (persons) of this course (ECTS-lecturers)



  • maxNumberStudents
  • The maximum number of students allowd to enroll for this course offering


  • currentNumberStudents
  • The number of students that have already enrolled for this course offering


Programme (GET /educational-programmes)

This table describes the mapping from ECTS CC to the OOAPv3 educational-programme object.

https://rawgit.com/open-education-api/specification/v3/docs.html#tag/educational-programmes

Attribute (ECTS CC)Description (ECTS CC)Attribute (OOAPI v3)Description (OOAPI v3)

Qualification awarded, length of programme, number of credits

Be specific about the type of qualification, e.g. Bachelor of Arts, or Bachelor of Nursing. Give the length of the programme in years or in months. Give the total number of ECTS credits for the programme.
  • qualificationAwarded
  • lenghtOfProgramme
  • ects

  • Type of qualificaton that can be obtained on finishing the programme

  • The lenght of the programme specified in months

  • The number of EC's that can be archieved in this educational plan

Level of qualification according to the National Qualification Framework and the European Qualifications FrameworkE.g. Bachelor’s degree; EQF for LLL: level 6; NLQF: level 6
  • levelOfQualification
  • Level of qualification according to the National Qualification Framework and the European Qualifications Framework
Field(s) of study (e.g. ISCED-F)The International Standard Classification of Education (ISCED) was developed by UNESCO to facilitate comparisons of education statistics and indicators across countries on the basis of uniform and internationally agreed definitions.
  • fieldsOfStudy
Profile of the programmeIt could be argued that the collective information in this section is a programme profile. However, it is important that the ECTS Course Catalogue includes a brief description of the main focus of the programme.
  • profileOfProgramme

  • brief description of the main focus of the programme.

Programme learning outcomesList the learning outcomes at programme level. It is advisable to limit the number of learning outcomes to approximately 20. It is also advisable to make sure that the programme learning outcomes in the course catalogue correspond with those on the Diploma Supplement.
  • programmeLearningOutcomes
  • List the learning outcomes at programme level. It is advisable to limit the number of learning outcomes to approximately 20. It is also advisable to make sure that the programme learning outcomes in the course catalogue correspond with those on the Diploma Supplement.
Mode of studyIndicate whether the programme is e.g. full-time, part-time, dual, e-learning.
  • modeOfStudy
  • Indicate whether the programme is e.g. full-time, part-time, dual, e-learning.
Required fields in the OOAPI spec


  • educationalProgrammeId
  • Unique id for this educational programme


  • name
  • The name of this educational programme


  • termStartDate
  • The day on which this educational programme starts, RFC3339 (full-date)
Extra fields in the OOAPI spec


  • description
  • The description of this educational programme


  • termEndDate
  • The day on which this educational programme ends, RFC3339 (full-date)


  • mainLanguage
  • The main language in which the courses within this education plan are given, RFC3066


  • _links to courses
  • Link to the list of courses that are part of this programme
  • No labels