Ignore:
Timestamp:
Aug 14, 2023, 9:16:51 PM (15 months ago)
Author:
alloc
Message:

More OpenAPI specs added

File:
1 edited

Legend:

Unmodified
Added
Removed

  • TFP-WebServer/WebServer/src/WebAPI/APIs/Permissions/Blacklist.openapi.yaml

    r460 r462  
    4242            type: object
    4343            properties:
    44               x:
    45                 type: integer
     44              bannedUntil:
     45                type: string
     46                format: date-time
     47              banReason:
     48                type: string
    4649                examples:
    47                   - -43
    48               y:
    49                 type: integer
     50                  - Cheating not allowed!
     51              name:
     52                type: string
    5053                examples:
    51                   - 842
    52               icon:
    53                 type: string
    54                 format: uuid
    55                 examples:
    56                   - https://upload.wikimedia.org/wikipedia/commons/thumb/1/11/Blue_question_mark_icon.svg/1200px-Blue_question_mark_icon.svg.png
     54                  - TheFunPimp
    5755            required:
    58               - x
    59               - y
     56              - bannedUntil
    6057      required: true
    61 
    62 
    63   parameters:
    64     UserIdPathParameter:
    65       name: id
    66       in: path
    67       required: true
    68       schema:
    69         $ref: '#/components/schemas/TypeUserIdString'
    7058
    7159
    … …  
    8068      responses:
    8169        200:
    82           description: List of found markers
     70          description: List of blacklist entries
    8371          content:
    8472            application/json:
    … …  
    9381                  - data
    9482                  - meta
     83        403:
     84          $ref: './openapi.yaml#/components/responses/Unauthorized'
     85      security:
     86        - apiTokenName: [ ]
     87          apiTokenSecret: [ ]
     88        - sessionCookie: [ ]
    9589
    9690
    … …  
    119113      operationId: blacklist.post.id
    120114      parameters:
    121         - $ref: '#/components/parameters/UserIdPathParameter'
     115        - $ref: './openapi.yaml#/components/parameters/UserIdPathParameter'
    122116      requestBody:
    123117        $ref: '#/components/requestBodies/BlacklistBodyIn'
    124118      responses:
    125119        201:
    126           description: Marker with updated values
     120          description: Blacklist entry created or updated
    127121          $ref: './openapi.yaml#/components/responses/HttpEmptyEnvelopedResponse'
    128122        400:
    129           description: >-
    130             Invalid request body, errorCode will be one of 'NO_OR_INVALID_X',
    131             'NO_OR_INVALID_Y'
     123          description: Invalid request body, errorCode will be 'NO_OR_INVALID_BANNED_UNTIL'
    132124          $ref: './openapi.yaml#/components/responses/HttpEmptyEnvelopedResponse'
    133125        403:
    … …  
    145137      operationId: blacklist.delete.id
    146138      parameters:
    147         - $ref: '#/components/parameters/UserIdPathParameter'
     139        - $ref: './openapi.yaml#/components/parameters/UserIdPathParameter'
    148140      responses:
    149141        204:
    150           description: Deleted marker
     142          description: Deleted blacklist entry
    151143          $ref: './openapi.yaml#/components/responses/HttpEmptyEnvelopedResponse'
    152144        404:
    153           description: Marker ID not found
     145          description: User ID not found
    154146          $ref: './openapi.yaml#/components/responses/HttpEmptyEnvelopedResponse'
    155147        403:
Note: See TracChangeset for help on using the changeset viewer.