Project: KICS (Provisioning / Security & Compliance)
File: 237402e2-c2f0-46c9-9cf5-286160cf7bfc.md

title: Path Is Ambiguous (v3) hide: toc: true navigation: true <style> .highlight .hll { background-color: #ff171742; } .md-content { max-width: 1100px; margin: 0 auto; } </style> Query id: 237402e2-c2f0-46c9-9cf5-286160cf7bfc Query name: Path Is Ambiguous (v3) Platform: OpenAPI Severity: <span style="color:#5bc0de">Info</span> Category: Structure and Semantics URL: All path should be unique, if has more than one operation, all operations should be part of same Path Object<br> ```yaml title="Positive test num. 1 - yaml file" hl_lines="19 6" openapi: 3.0.0 info: title: Simple API overview version: 1.0.0 paths: "/users/{id}": get: parameters: in: path name: id required: true description: The user ID schema: type: integer minimum: 1 responses: "200": description: 200 response "/users/{ids}": get: parameters: in: path name: id required: true description: The user ID schema: type: integer minimum: 1 responses: "200": description: 200 response ``` ```json title="Positive test num. 2 - json file" hl_lines="8 29" { "openapi": "3.0.0", "info": { "title": "Simple API overview", "version": "1.0.0" }, "paths": { "/users/{id}": { "get": { "parameters": [ { "in": "path", "name": "id", "required": true, "description": "The user ID", "schema": { "type": "integer", "minimum": 1 } } ], "responses": { "200": { "description": "200 response" } } } }, "/users/{ids}": { "get": { "parameters": [ { "in": "path", "name": "id", "required": true, "description": "The user ID", "schema": { "type": "integer", "minimum": 1 } } ], "responses": { "200": { "description": "200 response" } } } } } } ``` ```yaml title="Positive test num. 3 - yaml file" hl_lines="10 21" swagger: "2.0" info: title: Simple API Overview version: 1.0.0 contact: name: contact url: https://www.google.com/ email: user@gmail.com paths: "/users/{id}": get: parameters: in: path name: id required: true description: The user ID type: string responses: "200": description: 200 response "/users/{ids}": get: parameters: in: path name: id required: true description: The user ID type: string responses: "200": description: 200 response ``` <details><summary>Positive test num. 4 - json file</summary> ```json hl_lines="13 31" { "swagger": "2.0", "info": { "title": "Simple API Overview", "version": "1.0.0", "contact": { "name": "contact", "url": "https://www.google.com/", "email":

} }, "paths": { "/users/{id}": { "get": { "parameters": [ { "in": "path", "name": "id", "required": true, "description": "The user ID", "type": "string" } ], "responses": { "200": { "description": "200 response" } } } }, "/users/{ids}": { "get": { "parameters": [ { "in": "path", "name": "id", "required": true, "description": "The user ID", "type": "string" } ], "responses": { "200": { "description": "200 response" } } } } } } ``` </details> ```yaml title="Negative test num. 1 - yaml file" openapi: 3.0.0 info: title: Simple API overview version: 1.0.0 paths: "/users/{id}": get: parameters: in: path name: id required: true description: The user ID schema: type: integer minimum: 1 responses: "200": description: 200 response "/user/{id}": get: parameters: in: path name: id required: true description: The user ID schema: type: integer minimum: 1 responses: "200": description: 200 response ``` ```json title="Negative test num. 2 - json file" { "openapi": "3.0.0", "info": { "title": "Simple API overview", "version": "1.0.0" }, "paths": { "/users/{id}": { "get": { "parameters": [ { "in": "path", "name": "id", "required": true, "description": "The user ID", "schema": { "type": "integer", "minimum": 1 } } ], "responses": { "200": { "description": "200 response" } } } }, "/user/{id}": { "get": { "parameters": [ { "in": "path", "name": "id", "required": true, "description": "The user ID", "schema": { "type": "integer", "minimum": 1 } } ], "responses": { "200": { "description": "200 response" } } } } } } ``` ```yaml title="Negative test num. 3 - yaml file" swagger: "2.0" info: title: Simple API Overview version: 1.0.0 contact: name: contact url: https://www.google.com/ email: user@gmail.com paths: "/users/{id}": get: parameters: in: path name: id required: true description: The user ID type: string responses: "200": description: 200 response "/user/{id}": get: parameters: in: path name: id required: true description: The user ID type: string responses: "200": description: 200 response ``` <details><summary>Negative test num. 4 - json file</summary> ```json { "swagger": "2.0", "info": { "title": "Simple API Overview", "version": "1.0.0", "contact": { "name": "contact", "url": "https://www.google.com/", "email": "user@gmail.com" } }, "paths": { "/users/{id}": { "get": { "parameters": [ { "in": "path", "name": "id", "required": true, "description": "The user ID", "type": "string" } ], "responses": { "200": { "description": "200 response" } } } }, "/user/{id}": { "get": { "parameters": [ { "in": "path", "name": "id", "required": true, "description": "The user ID", "type": "string" } ], "responses": { "200": { "description": "200 response" } } } } } } ``` </details>