RAML console, only root shows up for every endpoint

#1

Hi,

I just spec’d out my first RAML-based API. I generated the code in maven to Jax-RS and it looks good. However displaying the spec in the console will only show me the first part (root?) of every one of my endpoints. I.e, if I have 3 endpoints:
/shoes/{byName}
/shoes/{byColor}
/shoes/{bySize}

instead of showing me the above in the api-console, it will only display

/shoes
/shoes
/shoes

Clicking on the methods (GET/POST etc) will reveal the full endpoint URL.

What am I doing wrong?

Candide

#2

I suspect as those are sub resources, they show up below the main root endpoint path. That is probably how the doc is generated for api console. There may be other tools that render it differently. We use raml2html for now and it lists the different endpoint urls, so maybe take a look at that module.