Request a Student object for a specified Student at a School.
/students
Veldspecificaties
61 items| Path | Naam | Type | Verplicht | Beperkingen | |
|---|---|---|---|---|---|
request.body |
body
|
Object | Nee | - | Bewerken |
request.body.school |
school
A reference to a School organisation. |
Object | Ja | - | Bewerken |
request.body.school.organisationIds |
organisationIds
A secondary identifier for the School. This value is used whenever the primary identifier is not available. (either organisationMasterIdentifier or organisationIds is required) |
Lijst[] | Nee | - | Bewerken |
request.body.school.organisationIds[*] |
organisationIds
A secondary identifier for the School. This value is used whenever the primary identifier is not available. (either organisationMasterIdentifier or organisationIds is required) |
Object | Nee | - | Bewerken |
request.body.school.organisationIds[*].organisationId |
organisationId
|
Tekenreeks | Ja | - | Bewerken |
request.body.school.organisationIds[*].organisationIdType |
organisationIdType
|
Keuzelijst | Ja | toegestaan ["OIE_CODE","BP_ID","DD_ID","AS_ID","V_ID"] | Bewerken |
request.body.school.organisationMasterIdentifier |
organisationMasterIdentifier
The primary identifier for a School. For Schools the |
Tekenreeks | Nee | - | Bewerken |
request.body.student |
student
|
Object | Ja | - | Bewerken |
request.body.student.userIds |
userIds
A secondary identifier for a User. This value is used whenever the primary identifier is not available. (either userMasterIdentifier or userIds is required) |
Lijst[] | Nee | - | Bewerken |
request.body.student.userIds[*] |
userIds
A secondary identifier for a User. This value is used whenever the primary identifier is not available. (either userMasterIdentifier or userIds is required) |
Object | Nee | - | Bewerken |
request.body.student.userIds[*].userId |
userId
|
Tekenreeks | Ja | - | Bewerken |
request.body.student.userIds[*].userIdType |
userIdType
|
Keuzelijst | Ja | toegestaan ["NEPPI","BPI","eduID","NEPRI","ASI","eckId"] | Bewerken |
request.body.student.userMasterIdentifier |
userMasterIdentifier
The primary identifier for a User. For Students the ECK iD is used. (either userMasterIdentifier or userIds is required) |
Tekenreeks | Nee | - | Bewerken |
response.200 |
response 200
OK |
Lijst[] | Nee | - | Bewerken |
response.200[*] |
response 200
The Student object with its identifiers and name information. Based on the scopes additional attributes can be included in this object. student.demographicsDemographic data of a Student:
student.communicationCommunication data of the Student. For Students this is only the student.accessibility
student.deliveryaddressDelivery address data of a Student:
|
Object | Nee | - | Bewerken |
response.200[*].accessibility |
accessibility
Accessibility preferences for this student. Based on IMS Global Access for All (AfA) Personal Needs and Preferences (PNP) Information model |
Lijst[] | Nee | - | Bewerken |
response.200[*].accessibility[*] |
accessibility
The AdditionalTestingTime preference for a Student. Either |
Object | Nee | - | Bewerken |
response.200[*].accessibility[*].additionalTestingTime |
additionalTestingTime
|
Object | Nee | - | Bewerken |
response.200[*].accessibility[*].additionalTestingTime.fixed-minutes |
fixed-minutes
Providing the additional testing time as an additional number of minutes. |
Geheel getal | Nee | - | Bewerken |
response.200[*].accessibility[*].additionalTestingTime.time-multiplier |
time-multiplier
Providing the additional testing time as a multiplier of the set time. |
Decimaal | Nee | - | Bewerken |
response.200[*].accessibility[*].additionalTestingTime.unlimited |
unlimited
Providing the additional testing time as an unlimited time. |
Tekenreeks | Nee | - | Bewerken |
response.200[*].address |
address
The home address of the Student. |
Object | Nee | - | Bewerken |
response.200[*].address.city |
city
|
Tekenreeks | Ja | - | Bewerken |
response.200[*].address.country |
country
|
Tekenreeks | Ja | - | Bewerken |
response.200[*].address.countryCode |
countryCode
According to Alpha-2 code from ISO 3166, e.g. NL |
Tekenreeks | Nee | - | Bewerken |
response.200[*].address.houseNumber |
houseNumber
the house number |
Geheel getal | Ja | - | Bewerken |
response.200[*].address.houseNumberSuffix |
houseNumberSuffix
additions to the house number, e.g. A or -104 |
Tekenreeks | Nee | - | Bewerken |
response.200[*].address.street |
street
|
Tekenreeks | Ja | - | Bewerken |
response.200[*].address.zipCode |
zipCode
|
Tekenreeks | Ja | - | Bewerken |
response.200[*].alias |
alias
An additional field to distinct students on screen who carry the same name. |
Tekenreeks | Nee | - | 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[*].dateOfBirth |
dateOfBirth
format: YYYY-MM-DD (according to RFC3339) |
Datum | Nee | - | Bewerken |
response.200[*].email |
email
E-mail address hosted by school (e.g. L123456@school.nl). |
Tekenreeks | Nee | - | Bewerken |
response.200[*].emailPrivate |
emailPrivate
Private e-mail address of the student. |
Tekenreeks | Nee | - | Bewerken |
response.200[*].emailsParents |
emailsParents
|
Lijst[] | Nee | - | Bewerken |
response.200[*].emailsParents[*] |
emailsParents
E-mail address of a parent or the legal representative (e.g. guardian) of the Student. |
Tekenreeks | Nee | - | Bewerken |
response.200[*].familyName |
familyName
|
Tekenreeks | Ja | - | Bewerken |
response.200[*].familyNamePrefix |
familyNamePrefix
|
Tekenreeks | Nee | - | Bewerken |
response.200[*].gender |
gender
The gender of the Student. The following values are used:
|
Keuzelijst | Nee | toegestaan ["female","male","other","unspecified"] | Bewerken |
response.200[*].givenName |
givenName
|
Tekenreeks | Ja | - | Bewerken |
response.200[*].language |
language
The language preference of the Student. Format according to ISO639 Set 3 values for Language tags. On Wikipedia an example list can be found. |
Tekenreeks | Nee | - | Bewerken |
response.200[*].preferredFirstName |
preferredFirstName
|
Tekenreeks | Nee | - | 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 The status attribute is based on the Base Class from OneRoster. |
Keuzelijst | Ja | toegestaan ["active","tobedeleted"] | Bewerken |
response.200[*].userIds |
userIds
A secondary identifier for a User. This value is used whenever the primary identifier is not available. (either userMasterIdentifier or userIds is required) |
Lijst[] | Nee | - | Bewerken |
response.200[*].userIds[*] |
userIds
A secondary identifier for a User. This value is used whenever the primary identifier is not available. (either userMasterIdentifier or userIds is required) |
Object | Nee | - | Bewerken |
response.200[*].userIds[*].userId |
userId
|
Tekenreeks | Ja | - | Bewerken |
response.200[*].userIds[*].userIdType |
userIdType
|
Keuzelijst | Ja | toegestaan ["NEPPI","BPI","eduID","NEPRI","ASI"] | Bewerken |
response.200[*].userMasterIdentifier |
userMasterIdentifier
The primary identifier for the Student. For Students the ECK iD is used. |
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 |