openapi: 3.0.0

info:
  title: Generic Database API Service
  version: "0.0.2"

paths:
  /pdb/v2/test1:
    get:
      tags: [ "Regular" ]
      operationId: Regular.test1all
      summary: Returns all entries from table test1
      responses:
        200:
          description: Here are your test1 items
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: "#/components/schemas/test1"
        404:
          description: No test1 items available
#    post:
#      tags: [ "Regular" ]
#      operationId: Regular.test1insert
#      summary: Inserts an item into table test1
#      requestBody:
#        description: test1
#        content:
#          application/json:
#            schema:
#              $ref: "#/components/schemas/test1"
#      responses:
#        201:
#          description: Your items has been inserted
  /pdb/v2/test1/specificSelectName/{txt}:
    get:
      tags: [ "Regular" ]
      operationId: Regular.test1specificSelectName
      summary: Returns entries from table test1 using a dedicated select statement
      description:
        STATEMENTBEGIN
          select nr, txt
            from test1
            where txt = @txt 
        STATEMENTEND
      parameters:
        - name: txt
          in: path
          required: true
          schema:
            type: string
      responses:
        200:
          description: Here are your test1 items
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: "#/components/schemas/specificResultType"
        404:
          description: No such test1 item available

components:
  schemas:
    test1:
      description: A test1 item
      type: object
      required:
        - id
      properties:
        id:
          type: integer
        txt:
          type: string
        nr:
          type: integer
    specificResultType:
      description: Specific result type to defintion select clause
      type: object
      properties:
        txt:
          type: string
        nr:
          type: integer