<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=Windows-1252">
</head>
<body dir="auto">
<div>No, I'm not suggesting that, though that's a good idea. I'm suggesting that the calls that have query parameters show them, like this</div>
<div><br>
</div>
<div>GET /<URL>/servers?marker=marker&limit=limit<br>
<br>
Sent from my iPhone</div>
<div><br>
On Jul 10, 2013, at 7:57 AM, "Nick Chase" <<a href="mailto:nchase@mirantis.com">nchase@mirantis.com</a>> wrote:<br>
<br>
</div>
<blockquote type="cite">
<div>
<div dir="ltr">On Wed, Jul 10, 2013 at 8:32 AM, Diane Fleming <span dir="ltr"><<a href="mailto:diane.fleming@rackspace.com" target="_blank">diane.fleming@rackspace.com</a>></span> wrote:
<div><br>
<div class="gmail_extra">
<div class="gmail_quote">
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
<div style="font-size:14px;font-family:Calibri,sans-serif;word-wrap:break-word">
<div>
<div>
<div>For example, in the individual API references, they do appear in the URIs, like this:</div>
<div><br>
</div>
<div><a href="http://docs.openstack.org/api/openstack-compute/2/content/List_Servers-d1e2078.html" target="_blank">http://docs.openstack.org/api/openstack-compute/2/content/List_Servers-d1e2078.html</a></div>
<div><br>
</div>
<div>However, this same call on the API Reference page looks like this – (see the "List Ids, names, and links for all servers" call)</div>
<div><br>
</div>
<div><a href="http://api.openstack.org/api-ref.html#compute" target="_blank">http://api.openstack.org/api-ref.html#compute</a></div>
<div><br>
</div>
<div>The query parms are described in the table, but don't appear in the URI itself. I find this really confusing. I'd like to have the page changed so that these appear in the URI – what are your thoughts? At the very least, they should be identified as "query"
parameters in the table. Let me know your thoughts!</div>
</div>
</div>
</div>
</blockquote>
<div><br>
</div>
<div style="">That URL actually refers to many calls, though; Are you suggesting that each call should have its own anchor, such as:</div>
<div style=""><br>
</div>
<div style=""><a href="http://api.openstack.org/api-ref.html#compute_servers_list">http://api.openstack.org/api-ref.html#compute_servers_list</a></div>
<div style=""><a href="http://api.openstack.org/api-ref.html#compute_servers_create">http://api.openstack.org/api-ref.html#compute_servers_create</a></div>
<div style=""><a href="http://api.openstack.org/api-ref.html#compute_servers_detail">http://api.openstack.org/api-ref.html#compute_servers_detail</a></div>
<div style=""><a href="http://api.openstack.org/api-ref.html#compute_servers_delete">http://api.openstack.org/api-ref.html#compute_servers_delete</a></div>
<div style=""><br>
</div>
<div style="">I'd be for that.</div>
<div style=""><br>
</div>
<div style="">---- Nick</div>
<div><br>
</div>
<div> </div>
</div>
<br>
</div>
</div>
</div>
</div>
</blockquote>
</body>
</html>