There are many ways to structure your APIs. Give swagger a try!