Veldspecificaties

35 items
Path Naam Type Verplicht Beperkingen
request.path.id
id

Reference to the groupId of the Group object.

Tekenreeks Ja - Bewerken
request.query.orgId
orgId

The organisationIdentifier (secondary identifier) of the school. This parameter is used in combination with the orgIdType when the organisationMasterIdentifier is not available.

Tekenreeks Nee - Bewerken
request.query.orgIdType
orgIdType

The type of the organisationIdentifier. This parameter is used in combination with the orgId when the organisationMasterIdentifier is not available. The following values are supported:

  • OIE_CODE: OnderwijsInstellingserkenningcode
  • BP_ID: Basispoort-generated identifier for the school
  • DD_ID: DigiDeliveryId generated by the Central Registration of Edu-iX
  • AS_ID: LAS-generated identifier (LAS-Key) for the school
  • V_ID: VestigingsId – BRIN6-format identifier, including dummy locations
Keuzelijst Nee toegestaan ["OIE_CODE","BP_ID","DD_ID","AS_ID","V_ID"] Bewerken
request.query.orgMasterId
orgMasterId

The organisationMasterIdentifier of the school. This parameter is used when the primary identifier for a school (being the OnderwijsaanbiederId) is available.

Tekenreeks Nee - Bewerken
response.200
response 200

The Group object in which Students follow their education and Employees are assigned to within a SchoolPeriod.

Object Nee - Bewerken
response.200.assignments
assignments

The Assignments of Employees that are assigned to this group.

Lijst[] Ja - Bewerken
response.200.assignments[*]
assignments

A reference to the assignmentId of the Assignment for this group.

Tekenreeks Ja - Bewerken
response.200.beginDate
beginDate

The start date on which the group becomes active (inclusive). Format: YYYY-MM-DD (according to RFC3339).

Datum Ja - Bewerken
response.200.dateCreated
dateCreated

Indicates the date and time the object was first created. Format: According to openapi in ZULU time as specified in RFC 3339, section 5.6.

Datum/tijd Ja - Bewerken
response.200.dateLastModified
dateLastModified

Indicates the date and time the object was last modified. Format: According to openapi in ZULU time as specified in RFC 3339, section 5.6.

Datum/tijd Ja - Bewerken
response.200.endDate
endDate

The end date on which the group becomes inactive (exclusive). Format: YYYY-MM-DD (according to RFC3339).

Datum Nee - Bewerken
response.200.groupId
groupId

A unique identifier for this Group object. This is the GUID that Consumers will refer to when making API calls, or when needing to identify an object.

Tekenreeks Ja - Bewerken
response.200.groupName
groupName

The name of this Group.

Tekenreeks Ja - Bewerken
response.200.groupType
groupType

The type of group, being one of:

  • class: a stamgroep where students are rostered into for their StudyOffering(s)
  • lesson-group: a lesgroep where students are rostered into to follow a SubjectOffering.
Keuzelijst Ja toegestaan ["class","lesson-group"] Bewerken
response.200.schoolPeriod
schoolPeriod

A reference to the schoolPeriodId of the SchoolPeriod where this group is part of.

Tekenreeks Ja - Bewerken
response.200.status
status

The status field gives an indication to Consumers about the status of an object. Consumers can delete objects that are flagged tobedeleted as such if they wish.

The status attribute is based on the Base Class from OneRoster.

Keuzelijst Ja toegestaan ["active","tobedeleted"] Bewerken
response.200.students
students

The Students which are member of this group.

Lijst[] Ja - Bewerken
response.200.students[*]
students

The Students which are member of this group.

Object Ja - Bewerken
response.200.students[*].userIds
userIds

A secondary identifier for a User. This value is used whenever the primary identifier is not available. For Employees this value is mandatory. (either userMasterIdentifier or userIds is required)

Lijst[] Nee - Bewerken
response.200.students[*].userIds[*]
userIds

A secondary identifier for a User. This value is used whenever the primary identifier is not available. For Employees this value is mandatory. (either userMasterIdentifier or userIds is required)

Object Nee - Bewerken
response.200.students[*].userIds[*].userId
userId
Tekenreeks Ja - Bewerken
response.200.students[*].userIds[*].userIdType
userIdType
Keuzelijst Ja toegestaan ["NEPPI","BPI","eduID","NEPRI","ASI","eckId"] Bewerken
response.200.students[*].userMasterIdentifier
userMasterIdentifier

The primary identifier for a User. For Students the ECK iD is used. For Employees this value is empty. There is no primary identifier for Employees. (either userMasterIdentifier or userIds is required)

Tekenreeks Nee - Bewerken
response.400
response 400

Functional status code and status message.

Object Nee - Bewerken
response.400.status
status

See functional status codes within the Documentation.

Geheel getal Ja - Bewerken
response.400.statusMessage
statusMessage

See functional status messages within the Documentation.

Tekenreeks Nee - Bewerken
response.401
response 401

Functional status code and status message.

Object Nee - Bewerken
response.401.status
status

See functional status codes within the Documentation.

Geheel getal Ja - Bewerken
response.401.statusMessage
statusMessage

See functional status messages within the Documentation.

Tekenreeks Nee - Bewerken
response.403
response 403

Functional status code and status message.

Object Nee - Bewerken
response.403.status
status

See functional status codes within the Documentation.

Geheel getal Ja - Bewerken
response.403.statusMessage
statusMessage

See functional status messages within the Documentation.

Tekenreeks Nee - Bewerken
response.404
response 404

Functional status code and status message.

Object Nee - Bewerken
response.404.status
status

See functional status codes within the Documentation.

Geheel getal Ja - Bewerken
response.404.statusMessage
statusMessage

See functional status messages within the Documentation.

Tekenreeks Nee - Bewerken

Verwachte statuscodes

5 items
Code Betekenis Uitkomst
200 OK Succes Bewerken
400 Bad Request Fout Bewerken
401 Unauthorized Fout Bewerken
403 Forbidden Fout Bewerken
404 Not Found Fout Bewerken