openapi: "3.0.0"
info:
  version: 1.0.0
  title: Swagger Petstore
  description: A sample API that uses a petstore as an example to demonstrate features in the OpenAPI 3.0 specification
  termsOfService: http://swagger.io/terms/
  contact:
    name: Swagger API Team
    email: [email protected]
    url: http://swagger.io
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: http://petstore.swagger.io/api
paths:
  /stuff/{stuffType}:
    post:
      tags:
        - 'stuff'
      description: "Do some stuff"
      operationId: "doStuff"
      parameters:
        - name: "stuffType"
          in: "path"
          required: true
          schema:
            $ref: '#/components/schemas/StuffType'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StuffType'
      responses:
        '200':
          description: 'A response'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StuffType'
components:
  schemas:
    StuffType:
      type: string
      enum:
        - A_1
        - B_1
        - D_2

@POST
@Path("/{stuffType}")
@ApiOperation(value = "", notes = "Do some stuff", response = StuffType.class, tags={ "stuff" })
@ApiResponses(value = { 
    @ApiResponse(code = 200, message = "A response", response = StuffType.class)
})
public Response doStuff(@PathParam("stuffType") StuffType stuffType,@Valid String body) {
    return Response.ok().entity("magic!").build();
}