openapi: 3.0.3
info:
  title: OAI-PMH API
  version: 1.0.0
  description: API for handling OAI-PMH requests.
servers:
  - url: https://api.tmw.at/oai?
    description: open data oai-pmh api.
  - url: https://api.tmw.at/kulturpool/oai?
    description: open data oai-pmh api specifically for kulturpool.
paths:
  /:
    get:
      summary: Handle OAI-PMH request
      operationId: handleOaiRequest
      tags:
        - OAI-PMH
      parameters:
        - name: verb
          in: query
          required: false
          schema:
            type: string
            enum: [listsets, identify, listmetadataformats, getrecord, listidentifiers, listrecords]
        - name: identifier
          in: query
          required: false
          schema:
            type: integer
            format: int64
        - name: from
          in: query
          required: false
          schema:
            type: string
            format: date-time
        - name: until
          in: query
          required: false
          schema:
            type: string
            format: date-time
        - name: set
          in: query
          required: false
          schema:
            type: string
        - name: metadataPrefix
          in: query
          required: false
          schema:
            type: string
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            default: 100
        - name: resumptionToken
          in: query
          required: false
          schema:
            type: integer
            default: 0
      responses:
        '200':
          description: Successful OAI-PMH response
          content:
            application/xml:
              schema:
                type: string
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '403':
          description: Forbidden