Swagger doesn't allow equivalent rest paths but with different type of parameters

Guys, I am using node with express for build my api. It gives pretty feature for create the same path with different parameter types:

app.get('/:id(\\d+)/', function (req, res) {
  // req.params.id is now defined here for you
});

app.get('/:ordinal(previous | last)/', function (req, res){
  // req.params.ordinal should be 'previous' or 'last'
});

Unfortunately, swagger doesn’t allow use this pretty feature and crashes with error: API path (or equivalent) already defined

[darrelmiller]

There are plenty of these scenarios that don’t even have an ugly option in OpenAPI. e.g.

/restaurantsNear?postalCode={postalCode} /restaurantsNear?lat={lat}&long={long}

The only way to do this with OpenAPI is

/restaurantsNear{?lat,long,postalCode}

The is problematic because there is no way of expressing that the query parameters must be either PostalCode or Lat and Long. All parameters have to be described as optional which is not accurate.

[fehguy]

See merged support for allOf, oneOf, etc. This should address your concerns.