api.coffee

module.exports =
  swagger: "2.0"
  info:
    title: "API"
    description: "This is my API"
    version: "1.0.0"
  produces: ["application/json"]
  consumes: ["application/json"]
  basePath: "/api/v1"
  paths:
    "/pets/{pid}":
      "x-alternate-paths": ["/pets/", "/mascotas/{pid}", "/mascotas/"] # mascotas is pets in spanish
      get:
        operationId: "getPet"
        summary: "Get a pet"
        description: "Returns a JSON object about a pet"
        parameters: [
          { name: 'pid', in: 'path', type: 'string' }
        ]
        responses:
          200:
             description: "Success"

ensureMetadata.coffee

module.exports = (req, res, next) ->
  return next() if req.swagger

  res.send 400,
    status: "validation failed"
    errors: [
      code: "INVALID"
      message: "Invalid path or path parameter"
    ]
  next(false)