Forum Discussion

Duter99's avatar
New Member
4 years ago

Route with same path but different URL



I want to make my APIs  documentations with Swagger. I have a micro services architectures but I want the documentation of every APIs to be on the same page. I sometimes have the same path for 2 APIs, like /book for a "library" MS and a "media" MS, one is to store the metadata of a book (like the author) whereas the other is to store the actual book. Those MS have different URLs ( and


I wrote the documentation directly on the .yml format


Is there a way to write the documentation of those 2 routes with the same page on the same swagger ?

1 Reply

  • Maryse's avatar
    Occasional Visitor

    That doesn’t make much sense since a parameter can be anything how would the router know the difference? The way router works out the paths is with paths, not parameters. Why don’t you include an additional element on your path like homes/detail/?