<div dir="ltr">Hi all, <br>I wanted to point attention to the latest release of 1.15.0 which went out too close to my newsletter time to make it into What's Up Doc? :)<br><br>Andreas has already gotten our repos updated to use this, since it fixed bug 1289568<br>

<br>In reviewing I noticed that API output changed slightly so I wanted to bring it to the list to make people aware. <br><br>In books that point to WADLs that output to HTML and PDF, such as the Identity API v2.0 Reference, the URI output displays a leading backslash. <br>

<br><a href="http://docs.openstack.org/api/openstack-identity-service/2.0/content/POST_admin-authenticate_v2.0_tokens_Token_Operations.html">http://docs.openstack.org/api/openstack-identity-service/2.0/content/POST_admin-authenticate_v2.0_tokens_Token_Operations.html</a><br>

<br>URI: /v2.0/tokens<br><br>We can turn this behavior off if needed. There's a parameter that lets you<br>specify how many items to trim off the front of the uri in wadls:<br><br>trimWadlUriCount<br><br>So if you set that to 1, it will trim trim first element off the uri, so:<br>

<br>v1/foo/bar<br><br>becomes<br><br>foo/bar<br><br>For the API Reference pages at <a href="http://api.openstack.org/api-ref.html">http://api.openstack.org/api-ref.html</a> the leading slash is not output.<div><br></div>
<div>
Here's some evidence that there's no standard, but I do see a pattern for adding the leading slash. However, it's often with the version number. Twitter is the only developer reference without leading-slash output. Look at these:<br>

<a href="http://developer.marvel.com/docs">http://developer.marvel.com/docs</a>: GET /v1/public/characters/{characterId}<br><a href="https://dev.twitter.com/docs/api/1.1">https://dev.twitter.com/docs/api/1.1</a>: GET statuses/mentions_timeline<br>

<a href="https://developer.linkedin.com/documents/profile-api">https://developer.linkedin.com/documents/profile-api</a>: GET <a href="http://api.linkedin.com/v1/people/url=">http://api.linkedin.com/v1/people/url=</a><public-profile-url><br>

<a href="http://developer.twilio.com/">http://developer.twilio.com/</a>  /2010-04-01/Accounts/{AccountSid}/Calls <br><a href="http://developer.github.com/v3/activity/notifications/">http://developer.github.com/v3/activity/notifications/</a>: GET /notifications<br>

<br>So it really depends on the shape of the service catalog. At this point in time, OpenStack service catalogs return the version number, but that may not always be the case.<br><br>So my preference would be to add a leading slash but also ensure the version number of the API is the first part.  I wanted to see if the list has a preference. </div>

<div><br></div><div>Thanks for reading this far! Sorry no tl;dr! </div><div><br></div><div>Anne<br><div><font color="#000000" face="Segoe UI, Helvetica, Arial, sans-serif"><br></font></div></div></div>