@dntlab/swagger-dean/project/manage_comments.yaml

swagger api for DeArchNet project

post:
  summary: Add comment to the project
  parameters:
    - in: path
      name: projectId
      required: true
      schema:
        type: string
      description: Project ID
  operationId: rest.project.comments.post
  security:
    - jwt: []
  requestBody:
    required: true
    content:
      application/json:
        schema:
          $ref: '../components/components.yaml#/components/schemas/comment_request'
  responses:
    201:
      description: Successfully added new comment to the project
      content:
        application/json:
          schema:
            $ref: '../components/components.yaml#/components/schemas/comment_response'
    400:
      description: Bad Request.
    404:
      $ref: '../components/components.yaml#/components/responses/404NotFound'
    default:
      $ref: '../components/components.yaml#/components/responses/UnexpectedError'

get:
  summary: View the project comments list
  parameters:
    - in: path
      name: projectId
      required: true
      schema:
        type: string
      description: Project ID
  operationId: rest.project.comments.index
  security:
    - jwt: []
  responses:
    200:
      description: Successfully fetch a list of the project comments
      content:
        application/json:
          schema:
            $ref: '../components/components.yaml#/components/schemas/list_of_comments'
    404:
      $ref: '../components/components.yaml#/components/responses/404NotFound'
    default:
      $ref: '../components/components.yaml#/components/responses/UnexpectedError'