Swagger - API call with multiple paths - node.js

Question

I'm trying make a swagger file for an api GET request that has several paths to it. There's the GET /listings, GET /listings that passes in req.query.bidderId and another one that passes req.query.watcherId and one for req.query.winnerId. Currently swagger is saying
Additional properties not allowed: /listings/{winnerId},/listings/{watcherId}
I'm not really sure how to handle all the different scenarios for one API call in swagger file?
Do I only need to have one with /{id}: and just let the express code do the rest? Is it that simple?
app.js
//GETS AUCTION LISTINGS
app.get("/api/listings", (req, res, next) => {
query = {};
if (req.query.bidderId && req.query.winner === "false") {
query = { bidderId: req.query.bidderId };
biddingGroupQuery = { biddingGroup: req.query.biddingGroup }
Post.find({
$and: [
{ biddingGroup: { $in: [req.query.bidderId] } },
{ auctionEndDateTime: { $gte: Date.now() } }
]
})
.populate("creator", "username")
.then(documents => {
req.params.Id = mongoose.Types.ObjectId(req.params.Id);
res.status(200).json({
message: "Active Bids Listings retrieved successfully!",
posts: documents
});
});
} else if (req.query.bidderId && req.query.winner) {
query = { bidderId: req.query.bidderId };
biddingGroupQuery = { biddingGroup: req.query.biddingGroup };
Post.find({
$and: [
{ bidderId: req.query.bidderId },
{ auctionEndDateTime: { $lte: Date.now() } }
]
})
.populate("creator", "username")
.then(documents => {
req.params.Id = mongoose.Types.ObjectId(req.params.Id);
res.status(200).json({
message: "Auction listings retrieved successfully!",
posts: documents
});
});
} else if (req.query.watcherId) {
Post.find({
$and: [
{ watchingGroup: { $in: [req.query.watcherId] } },
{ auctionEndDateTime: { $gte: Date.now() } }
]
})
.populate("creator", "username")
.then(documents => {
res.status(200).json({
message: "User's watchlist items retrieved!",
posts: documents
});
});
} else if (!req.query.bidderId) {
Post.find({ auctionEndDateTime: { $gte: Date.now() } })
.populate("creator", "username")
//.populate('watchlist', 'watchItemUniqueKey')
.then(documents => {
req.params.Id = mongoose.Types.ObjectId(req.params.Id);
res.status(200).json({
message: "Auction listings retrieved successfully!",
posts: documents
});
});
}
});
swagger file
swagger: "2.0"
info:
version: "1.0.0"
title: Hello World App during dev, should point to your local machine
basePath: /v1
schemes:
# tip: remove http to make production-grade
- http
- https
paths:
/listings:
x-swagger-router-controller: listings
get:
description: Return all the auction listings
operationId: getAuctions
responses:
"200":
description: Success got all the listings
schema:
$ref: "/definitions/Listing"
"500":
description: Unexpected Error
schema:
type: object
properties:
message:
type: string
/listings/{id}:
x-swagger-router-controller: listings
get:
description: My Bids, My Wins, and My Watchlist GET request
operationId: getId
parameters:
- in: path
name: id
required: true
type: string
minimum: 5
description: BidderId, WatcherId, or WinnerId
responses:
"200":
description: Success got all the listings
schema:
$ref: "/definitions/Listing"
"500":
description: Unexpected Error
schema:
type: object
properties:
message:
type: string
definitions:
Listing:
properties:
id:
type: integer
glassTitle:
type: boolean
startingBid:
type: string
increments:
type: string
shippingCost:
type: string
auctionType:
type: string
buyItNow:
type: string
snipingRules:
type: string
creator:
type: string
username:
type: string
biddingGroup:
type: array
items:
type: string
watchingGroup:
type: array
items:
type: string
lastBidderName:
type: string
currentBid:
type: string