Edu-V portaal (beheer)
Gerrit Bergsma
Beheer
Gebruikers
Deelnemers
Onderhoud
Privacy
Testcases
KVTPOSTSTUDENTS
Bewerken
Testcase bewerken
Werk testcasevelden, endpointkoppeling en JSON-definities bij.
Terug naar lijst
Stabiele testcase-id
Code
Name
Categorie
Sector
Doelrol
Alle rollen
Verzender
Ontvanger
Afnemer
Bron
Doelversie
Groep
Tags
TestType
KVT
IOT
Severity
Info
Laag
Middel
Hoog
Kritiek
Endpoint
Geen endpoint gekoppeld
Association API (PullSynchronous) · GET /assignments/school
Association API (PullSynchronous) · GET /assignments/school/{id}
Association API (PullSynchronous) · GET /enrollments/school
Association API (PullSynchronous) · GET /enrollments/school/{id}
Association API (PullSynchronous) · GET /groups/school
Association API (PullSynchronous) · GET /groups/school/{id}
Association API (PullSynchronous) · GET /schoolperiods/school
Association API (PullSynchronous) · GET /schoolperiods/school/{id}
Association API (PushSynchronous) · POST /assignments/school/employee
Association API (PushSynchronous) · POST /enrollments/school/student
Education API · GET /organisations
Education API · GET /studyofferings/school
Education API · GET /studyofferings/school/{id}
Education API · GET /subjectofferings/school
Education API · GET /subjectofferings/school/{id}
Employees API (PullSynchronous) · GET /employees/school
Employees API (PushSynchronous) · POST /employees
Students API (PullSynchronous) · GET /students/school
Students API (PushSynchronous) · POST /students
Description
Request a Student object for a specified Student at a School.
Regressietest
Handmatige testcase
Action JSON
{"method":"POST","path":"/students","url":"{{supplier.baseUrl}}/students","headers":{"Accept":"application/json","Content-Type":"application/json"},"requestFieldSpecifications":[{"fieldPath":"request.body","name":"body","dataType":"Object","isRequired":false,"isArray":false,"description":null},{"fieldPath":"request.body.school","name":"school","dataType":"Object","isRequired":true,"isArray":false,"description":"A reference to a School organisation."},{"fieldPath":"request.body.school.organisationMasterIdentifier","name":"organisationMasterIdentifier","dataType":"String","isRequired":false,"isArray":false,"description":"The primary identifier for a School. For Schools the \u0060OnderwijsaanbiederId\u0060 is used.\n(either organisationMasterIdentifier or organisationIds is required)\n"},{"fieldPath":"request.body.school.organisationIds","name":"organisationIds","dataType":"Array","isRequired":false,"isArray":true,"description":"A secondary identifier for the School. This value is used whenever the primary identifier is not available.\n(either organisationMasterIdentifier or organisationIds is required)\n"},{"fieldPath":"request.body.school.organisationIds[*]","name":"organisationIds","dataType":"Object","isRequired":false,"isArray":false,"description":"A secondary identifier for the School. This value is used whenever the primary identifier is not available.\n(either organisationMasterIdentifier or organisationIds is required)\n"},{"fieldPath":"request.body.school.organisationIds[*].organisationId","name":"organisationId","dataType":"String","isRequired":true,"isArray":false,"description":null},{"fieldPath":"request.body.school.organisationIds[*].organisationIdType","name":"organisationIdType","dataType":"Enum","isRequired":true,"isArray":false,"description":null,"allowedValues":["OIE_CODE","BP_ID","DD_ID","AS_ID","V_ID"]},{"fieldPath":"request.body.student","name":"student","dataType":"Object","isRequired":true,"isArray":false,"description":null},{"fieldPath":"request.body.student.userMasterIdentifier","name":"userMasterIdentifier","dataType":"String","isRequired":false,"isArray":false,"description":"The primary identifier for a User.\nFor Students the ECK iD is used.\n(either userMasterIdentifier or userIds is required)\n"},{"fieldPath":"request.body.student.userIds","name":"userIds","dataType":"Array","isRequired":false,"isArray":true,"description":"A secondary identifier for a User. This value is used whenever the primary identifier is not available.\n(either userMasterIdentifier or userIds is required)\n"},{"fieldPath":"request.body.student.userIds[*]","name":"userIds","dataType":"Object","isRequired":false,"isArray":false,"description":"A secondary identifier for a User. This value is used whenever the primary identifier is not available.\n(either userMasterIdentifier or userIds is required)\n"},{"fieldPath":"request.body.student.userIds[*].userId","name":"userId","dataType":"String","isRequired":true,"isArray":false,"description":null},{"fieldPath":"request.body.student.userIds[*].userIdType","name":"userIdType","dataType":"Enum","isRequired":true,"isArray":false,"description":null,"allowedValues":["NEPPI","BPI","eduID","NEPRI","ASI","eckId"]}],"oauth":{"tokenEndpoint":"{{oauth.KVTPOSTSTUDENTS.tokenEndpoint}}","defaultTokenEndpoint":"https://api.example.com/oauth2/token","scopes":"eduv.student.basic eduv.student.demographics eduv.student.communication eduv.student.accessibility eduv.student.deliveryaddress","scheme":"OAuth2"},"body":{"school":{"organisationMasterIdentifier":"104A158","organisationIds":[{"organisationId":"SAMPLE-ID-001","organisationIdType":"OIE_CODE"}]},"student":{"userMasterIdentifier":"SAMPLE-ID-001","userIds":[{"userId":"SAMPLE-ID-001","userIdType":"NEPPI"}]}}}
Expected result JSON
{"statusCode":200,"responseMustBeJson":true,"headers":{"Content-Type":"application/json"},"responseBody":[{"givenName":"Voorbeeldnaam","familyName":"Voorbeeldnaam","status":"active","dateCreated":"2017-07-21T17:32:28Z","dateLastModified":"2022-08-11T15:31:12Z"}],"responseFieldSpecifications":[{"fieldPath":"response.200","name":"response 200","dataType":"Array","isRequired":false,"isArray":true,"description":"OK"},{"fieldPath":"response.200[*]","name":"response 200","dataType":"Object","isRequired":false,"isArray":false,"description":"The Student object with its identifiers and name information.\n\nBased on the scopes additional attributes can be included in this object.\n\n### student.demographics\nDemographic data of a Student:\n- \u0060dateOfBirth\u0060\n- \u0060gender\u0060\n\n### student.communication\nCommunication data of the Student. For Students this is only the \u0060e-mail\u0060 address as provided by the School.\n\n### student.accessibility\n\u0060accessibility\u0060 and \u0060language\u0060 preferences for the Student. StudentAccessibility is an optional object for the Students API.\n- As an illustration the accessibility of AdditionalTestingTime is specified within this version.\n- Based on actual requirements from schools and suppliers, this list of preferences can be extended.\n- A possible next candidate might be the [Braille class](https://www.imsglobal.org/sites/default/files/spec/afa/3p0/information_model/imsafa3p0pnp_v1p0_InfoModel.html#Data_Braille).\n\n### student.deliveryaddress\nDelivery address data of a Student:\n- \u0060address\u0060\n- \u0060emailPrivate\u0060\n- \u0060emailsParents\u0060\n"},{"fieldPath":"response.200[*].userMasterIdentifier","name":"userMasterIdentifier","dataType":"String","isRequired":false,"isArray":false,"description":"The primary identifier for the Student.\nFor Students the ECK iD is used.\n"},{"fieldPath":"response.200[*].userIds","name":"userIds","dataType":"Array","isRequired":false,"isArray":true,"description":"A secondary identifier for a User. This value is used whenever the primary identifier is not available.\n(either userMasterIdentifier or userIds is required)\n"},{"fieldPath":"response.200[*].userIds[*]","name":"userIds","dataType":"Object","isRequired":false,"isArray":false,"description":"A secondary identifier for a User. This value is used whenever the primary identifier is not available.\n(either userMasterIdentifier or userIds is required)\n"},{"fieldPath":"response.200[*].userIds[*].userId","name":"userId","dataType":"String","isRequired":true,"isArray":false,"description":null},{"fieldPath":"response.200[*].userIds[*].userIdType","name":"userIdType","dataType":"Enum","isRequired":true,"isArray":false,"description":null,"allowedValues":["NEPPI","BPI","eduID","NEPRI","ASI"]},{"fieldPath":"response.200[*].givenName","name":"givenName","dataType":"String","isRequired":true,"isArray":false,"description":null},{"fieldPath":"response.200[*].preferredFirstName","name":"preferredFirstName","dataType":"String","isRequired":false,"isArray":false,"description":null},{"fieldPath":"response.200[*].familyName","name":"familyName","dataType":"String","isRequired":true,"isArray":false,"description":null},{"fieldPath":"response.200[*].familyNamePrefix","name":"familyNamePrefix","dataType":"String","isRequired":false,"isArray":false,"description":null},{"fieldPath":"response.200[*].dateOfBirth","name":"dateOfBirth","dataType":"Date","isRequired":false,"isArray":false,"description":"format: YYYY-MM-DD (according to RFC3339)"},{"fieldPath":"response.200[*].gender","name":"gender","dataType":"Enum","isRequired":false,"isArray":false,"description":"The gender of the Student. The following values are used:\n- \u0060female\u0060: gender is Female\n- \u0060male\u0060: gender is Male\n- \u0060other\u0060: gender that is known but which is not either Male or Female.\n- \u0060unspecified\u0060: unspecified as no data entry for this field has been made.\n","allowedValues":["female","male","other","unspecified"]},{"fieldPath":"response.200[*].email","name":"email","dataType":"String","isRequired":false,"isArray":false,"description":"E-mail address hosted by school (e.g. L123456@school.nl)."},{"fieldPath":"response.200[*].language","name":"language","dataType":"String","isRequired":false,"isArray":false,"description":"The language preference of the Student. Format according to [ISO639 Set 3 values](https://www.iso.org/standard/74575.html) for Language tags.\nOn [Wikipedia](https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes) an example list can be found.\n"},{"fieldPath":"response.200[*].accessibility","name":"accessibility","dataType":"Array","isRequired":false,"isArray":true,"description":"Accessibility preferences for this student. Based on [IMS Global Access for All (AfA) Personal Needs and Preferences (PNP) Information model](https://www.imsglobal.org/sites/default/files/spec/afa/3p0/information_model/imsafa3p0pnp_v1p0_InfoModel.html)"},{"fieldPath":"response.200[*].accessibility[*]","name":"accessibility","dataType":"Object","isRequired":false,"isArray":false,"description":"The AdditionalTestingTime preference for a Student. Either \u0060time-multiplier\u0060, \u0060fixed-minutes\u0060 or \u0060unlimited\u0060 is used."},{"fieldPath":"response.200[*].accessibility[*].additionalTestingTime","name":"additionalTestingTime","dataType":"Object","isRequired":false,"isArray":false,"description":null},{"fieldPath":"response.200[*].accessibility[*].additionalTestingTime.time-multiplier","name":"time-multiplier","dataType":"Decimal","isRequired":false,"isArray":false,"description":"Providing the additional testing time as a multiplier of the set time."},{"fieldPath":"response.200[*].accessibility[*].additionalTestingTime.fixed-minutes","name":"fixed-minutes","dataType":"Integer","isRequired":false,"isArray":false,"description":"Providing the additional testing time as an additional number of minutes."},{"fieldPath":"response.200[*].accessibility[*].additionalTestingTime.unlimited","name":"unlimited","dataType":"String","isRequired":false,"isArray":false,"description":"Providing the additional testing time as an unlimited time."},{"fieldPath":"response.200[*].address","name":"address","dataType":"Object","isRequired":false,"isArray":false,"description":"The home address of the Student."},{"fieldPath":"response.200[*].address.street","name":"street","dataType":"String","isRequired":true,"isArray":false,"description":null},{"fieldPath":"response.200[*].address.houseNumber","name":"houseNumber","dataType":"Integer","isRequired":true,"isArray":false,"description":"the house number"},{"fieldPath":"response.200[*].address.houseNumberSuffix","name":"houseNumberSuffix","dataType":"String","isRequired":false,"isArray":false,"description":"additions to the house number, e.g. A or -104"},{"fieldPath":"response.200[*].address.zipCode","name":"zipCode","dataType":"String","isRequired":true,"isArray":false,"description":null},{"fieldPath":"response.200[*].address.city","name":"city","dataType":"String","isRequired":true,"isArray":false,"description":null},{"fieldPath":"response.200[*].address.countryCode","name":"countryCode","dataType":"String","isRequired":false,"isArray":false,"description":"According to Alpha-2 code from ISO 3166, e.g. NL"},{"fieldPath":"response.200[*].address.country","name":"country","dataType":"String","isRequired":true,"isArray":false,"description":null},{"fieldPath":"response.200[*].emailPrivate","name":"emailPrivate","dataType":"String","isRequired":false,"isArray":false,"description":"Private e-mail address of the student."},{"fieldPath":"response.200[*].emailsParents","name":"emailsParents","dataType":"Array","isRequired":false,"isArray":true,"description":null},{"fieldPath":"response.200[*].emailsParents[*]","name":"emailsParents","dataType":"String","isRequired":false,"isArray":false,"description":"E-mail address of a parent or the legal representative (e.g. guardian) of the Student."},{"fieldPath":"response.200[*].alias","name":"alias","dataType":"String","isRequired":false,"isArray":false,"description":"An additional field to distinct students on screen who carry the same name.\n"},{"fieldPath":"response.200[*].status","name":"status","dataType":"Enum","isRequired":true,"isArray":false,"description":"The status field gives an indication to Consumers about the status of an object.\nConsumers can delete objects that are flagged \u0060tobedeleted\u0060 as such if they wish.\n\nThe status attribute is based on the [Base Class from OneRoster](https://www.imsglobal.org/sites/default/files/spec/oneroster/v1p2/rostering-informationmodel/OneRosterv1p2RosteringService_InfoModelv1p0.html#Data_Base).\n","allowedValues":["active","tobedeleted"]},{"fieldPath":"response.200[*].dateCreated","name":"dateCreated","dataType":"DateTime","isRequired":true,"isArray":false,"description":"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."},{"fieldPath":"response.200[*].dateLastModified","name":"dateLastModified","dataType":"DateTime","isRequired":true,"isArray":false,"description":"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."}]}
Wizardvragen JSON
?
Meer informatie
[ { "PlaceholderKey": "supplier.baseUrl", "AnswerKey": "supplier.baseUrl", "QuestionText": "What is the supplier base URL for this API?", "HelpText": "Enter the full base URL including the scheme, for example https://supplier.example.nl/api.", "GroupName": null, "TargetTransactionRole": null, "TargetVersion": null, "FieldType": "Url", "IsRequired": true, "AllowReuse": true, "SortOrder": 1, "Options": null, "Validation": null }, { "PlaceholderKey": "oauth.KVTPOSTSTUDENTS.tokenEndpoint", "AnswerKey": "oauth.KVTPOSTSTUDENTS.tokenEndpoint", "QuestionText": "OAuth token endpoint", "HelpText": "Supplier token endpoint used to request the bearer token for this API call.", "GroupName": null, "TargetTransactionRole": null, "TargetVersion": null, "FieldType": "Url", "IsRequired": true, "AllowReuse": true, "SortOrder": 10, "Options": null, "Validation": null } ]
Opslaan
Annuleren