/assignments/school - Association (P) - Edu-V Compliance Testlab

Veldspecificaties

41 items

Veld	Beschrijving	Type	Verplicht	Beperkingen
`request.query.orgMasterId`	orgMasterId	Tekenreeks	Nee	-
`request.query.orgId`	orgId	Tekenreeks	Nee	-
`request.query.orgIdType`	orgIdType	Keuzelijst	Nee	-
`request.query.filterByOrgId`	filterByOrgId	Boolean	Nee	-
`request.query.assignmentType`	assignmentType	Keuzelijst	Nee	-
`request.query.schoolPeriodId`	schoolPeriodId	Tekenreeks	Nee	-
`response.200`	response 200 The Assignment object for an employee to a Group or Student for a SchoolPeriod.	Object	Nee	-
`response.200.assignmentId`	assignmentId A unique identifier for this Assignment object. This is the identifier that Consumers will refer to when making API calls, or when needing to identify an object.	Tekenreeks	Ja	-
`response.200.employee`	employee The Employee to which this assignment object belongs.	Object	Ja	UserReference
`response.200.employee.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	-
`response.200.employee.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	-
`response.200.employee.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	-
`response.200.employee.userIds[*].userId`	userId	Tekenreeks	Ja	-
`response.200.employee.userIds[*].userIdType`	userIdType	Keuzelijst	Ja	toegestaan ["NEPPI","BPI","eduID","NEPRI","ASI","eckId"]
`response.200.assignmentType`	assignmentType The type of assignment, being one of: - class-teacher: an assignment to a class. - teacher: an assignment to a lesson group for a subject. - coach: an assignment to an individual student.	Keuzelijst	Ja	toegestaan ["class-teacher","teacher","coach"]
`response.200.group`	group A reference to the groupId of the Group in case this assignment is of the assignmentType `class-teacher` or `teacher` and the student is assigned to a Group for a single subject .	Tekenreeks	Nee	-
`response.200.subject`	subject A reference to the subjectOfferingId of the SubjectOffering in case this assignment is of the assignmentType `teacher`.	Tekenreeks	Nee	-
`response.200.student`	student A reference to a Student in case this assignment is of the assignmentType `coach`.	Object	Nee	UserReference
`response.200.student.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	-
`response.200.student.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	-
`response.200.student.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	-
`response.200.student.userIds[*].userId`	userId	Tekenreeks	Ja	-
`response.200.student.userIds[*].userIdType`	userIdType	Keuzelijst	Ja	toegestaan ["NEPPI","BPI","eduID","NEPRI","ASI","eckId"]
`response.200.schoolPeriod`	schoolPeriod A reference to the schoolPeriodId of the SchoolPeriod where this assignment is part of.	Tekenreeks	Ja	-
`response.200.beginDate`	beginDate The start date on which the assignment becomes active (inclusive). Format: YYYY-MM-DD (according to RFC3339).	Datum	Ja	-
`response.200.endDate`	endDate The end date on which the assignment becomes inactive (exclusive). Format: YYYY-MM-DD (according to RFC3339).	Datum	Nee	-
`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 ["class-teacher","teacher","coach"]
`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	-
`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	-
`response.400`	response 400 Functional status code and status message.	Object	Nee	-
`response.400.status`	status See functional status codes within the Documentation.	Geheel getal	Ja	-
`response.400.statusMessage`	statusMessage See functional status messages within the Documentation.	Tekenreeks	Nee	-
`response.401`	response 401 Functional status code and status message.	Object	Nee	-
`response.401.status`	status See functional status codes within the Documentation.	Geheel getal	Ja	-
`response.401.statusMessage`	statusMessage See functional status messages within the Documentation.	Tekenreeks	Nee	-
`response.403`	response 403 Functional status code and status message.	Object	Nee	-
`response.403.status`	status See functional status codes within the Documentation.	Geheel getal	Ja	-
`response.403.statusMessage`	statusMessage See functional status messages within the Documentation.	Tekenreeks	Nee	-
`response.404`	response 404 Functional status code and status message.	Object	Nee	-
`response.404.status`	status See functional status codes within the Documentation.	Geheel getal	Ja	-
`response.404.statusMessage`	statusMessage See functional status messages within the Documentation.	Tekenreeks	Nee	-

Verwachte statuscodes

5 items

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

Bronspecificatie (YAML)

Ruwe definitie uit het afsprakenstelsel.

  /assignments/school:
    parameters:
      - schema:
          type: string
        name: orgMasterId
        in: query
        required: false
        description: |
          The organisationMasterIdentifier of the school.
          This parameter is used when the primary identifier for a school (being the `OnderwijsaanbiederId`) is available.
      - schema:
          type: string
        name: orgId
        in: query
        required: false
        description: |
          The organisationIdentifier (secondary identifier) of the school.
          This parameter is used in combination with the orgIdType when the organisationMasterIdentifier is not available.
      - schema:
          type: string
          example: DD_ID
          enum:
            - OIE_CODE
            - BP_ID
            - DD_ID
            - AS_ID
            - V_ID
        name: orgIdType
        in: query
        required: false
        description: |
          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
      - schema:
          type: boolean
        name: filterByOrgId
        in: query
        required: false
        description: |
          Controls whether the response is filtered to only include Assignments belonging to the
          specific organisation identified by `orgId` and `orgIdType`, or whether all Assignments
          of the associated Onderwijsaanbieder are returned.
          - `true`: Only Assignments belonging to the specified secondary identifier are returned.
          - `false`: All Assignments of the associated Onderwijsaanbieder are returned (to the extent authorisations have been configured).
          When omitted, a sector-specific default applies:
          - **PO (primary education):** defaults to `true` – response is filtered to the specified identifier.
          - **VO (secondary education):** defaults to `false` – response covers the full Onderwijsaanbieder scope.
          This parameter is only relevant in combination with `orgId` and `orgIdType`.
          When `orgMasterId` is used, this parameter must be absent or `false`.
          It is the responsibility of the consuming party to verify whether the Source supports
          filtering via this parameter before using it.
      - schema:
          type: string
          enum:
            - class-teacher
            - teacher
            - coach
        name: assignmentType
        in: query
        required: false
        description: 'Optional filter to request all Assignment objects for a specified assignmentType.'
      - schema:
          type: string
        name: schoolPeriodId
        in: query
        required: false
        description: 'Optional filter to request all Assignment objects within a specified SchoolPeriod and its corresponding schoolPeriodId.'
    get:
      summary: Get Assignments for School
      x-tags:
        - Assignment
      tags:
        - Administratiesysteem onderwijsdeelnemer
      operationId: get-assignments-for-school
      description: 'Request Assignment objects for a specified School.'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Assignment'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StatusResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StatusResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StatusResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StatusResponse'
      security:
        - OAuth2:
            - eduv.association