Adding Implementation Notes and Description to Swagger UI

Question

I am attempting to add Implementation Notes and Description to my Swagger UI. However, neither show up on the UI when implemented as below:

{
"swagger" : "2.0",
"info" : {
    "description" : "The definition of the Rest API to service plugin over https on port 9443.",
    "version" : "1.0",
    "title" : "Plugin Rest API",
    "contact" : {
       "name" : "John Doe",
      "email" : "john.doe@gmail.com"
    }
},
"basePath" : "/service",
"tags" : [ {
    "name" : "service"
  } ],
"schemes" : [ "https" ],
"paths" : {
"/entry" : {
   "get" : {
       "notes" : "This is a note",
       "method" : "get",
       "tags" : [ "service" ],
       "summary" : "Get an entry by first name and last name",
       "description" : "This is a description",
       "operationId" : "getEntry",
       "produces" : [ "application/xml", "application/json" ],
       "parameters" : [ {
           "name" : "first",
           "in" : "query",
           "description" : "The first name",
           "required" : true,
           "type" : "string"
        }, {
      "name" : "last",
      "in" : "query",
      "description" : "The last name",
      "required" : true,
      "type" : "string"
    } ],
    "responses" : {
      "200" : {
        "description" : "Matching entry, or entries, if any, were returned",
        "schema" : {
          "$ref" : "#/definitions/Service"
        }
      }
    }   
  },

I am not sure what I am doing wrong in my code. I've tested it on various sample swagger.json files and I cannot seem to get it to work.

Which fields are not appearing? The summary, description, etc? — fehguy, Oct 28 '16 at 03:39

score 1 · Answer 1 · answered Jul 27 '17 at 15:40

1

notes is not a swagger field. See the documentation

Your description field is written twice, so the first one has been overridden.

answered Jul 27 '17 at 15:40

M07

1,060
1
14
23

score 0 · Answer 2 · answered Jul 14 '18 at 14:23

you can add implementation notes using notes tag in @ApiOperation annotation as shown below,

@ApiOperation(notes = "Your Implementation Notes will show here[![enter image description here][1]][1]", value = "Add Customer Payment Details and Generate Payment Link through Batch.", nickname = "insertPaymentBatch",  tags = 
            "Insert Payment" )

Adding Implementation Notes and Description to Swagger UI

2 Answers2