resolve missing responses in openapi.json

Author: emathew5

api-docs/openapi.json

@@ -2001,8 +2001,7 @@
             "required": true,
             "schema": {
               "type": "string"
-            },
-            "description": "The shortname of the organization"
+            }
           },
           {
             "name": "username",
@@ -2011,14 +2010,77 @@
             "schema": {
               "type": "string"
             }
+          },
+          {
+            "$ref": "#/components/parameters/apiEntityHeader"
+          },
+          {
+            "$ref": "#/components/parameters/apiUserHeader"
+          },
+          {
+            "$ref": "#/components/parameters/apiSecretHeader"
           }
         ],
         "responses": {
+          "200": {
+            "description": "Returns information about the specified registry user",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "../schemas/registry-user/get-registry-user-response.json"
+                }
+              }
+            }
+          },
           "400": {
-            "description": "Bad Request"
+            "description": "Bad Request",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "../schemas/errors/bad-request.json"
+                }
+              }
+            }
           },
           "401": {
-            "description": "Unauthorized"
+            "description": "Not Authenticated",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "../schemas/errors/generic.json"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Forbidden",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "../schemas/errors/generic.json"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Not Found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "../schemas/errors/generic.json"
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "Internal Server Error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "../schemas/errors/generic.json"
+                }
+              }
+            }
           }
         }
       },

src/controller/org.controller/index.js

@@ -58,21 +58,21 @@ router.get('/registry/org/:shortname/user/:username',
         <h2>Expected Behavior</h2>
         <p><b>Regular, CNA & Admin Users:</b> Retrieves information about a registry user in the same organization</p>
         <p><b>Secretariat:</b> Retrieves any registry user's information</p>"
+  #swagger.parameters['$ref'] = [
+    '#/components/parameters/apiEntityHeader',
+    '#/components/parameters/apiUserHeader',
+    '#/components/parameters/apiSecretHeader'
+  ]
   #swagger.parameters['shortname'] = {
     description: 'The shortname of the organization'
   }
   #swagger.parameters['username'] = {
     description: 'The username of the registry user',
     schema: {
       type: 'string',
-      pattern: '^[a-zA-Z0-9._@-]+$'  // Based on isValidUsername custom validator
+      pattern: '^[a-zA-Z0-9._@-]+$'
     }
   }
-  #swagger.parameters['$ref'] = [
-    '#/components/parameters/apiEntityHeader',
-    '#/components/parameters/apiUserHeader',
-    '#/components/parameters/apiSecretHeader'
-  ]
   #swagger.responses[200] = {
     description: 'Returns information about the specified registry user',
     content: {