<div dir="ltr">In general, it's unusual to include parameters on POST request URLs.  That's not to say that it can't be done, but I think it might be a bit confusing; even if the parameters are sent on the URL, they ALSO have to be sent as part of the reqeust body, as a normal POST request.<div>
<br></div><div>That said, I'd be all for identifying "query" parameters in the tables...<br><div><br></div><div>----  Nick</div></div></div><div class="gmail_extra"><br><br><div class="gmail_quote">On Wed, Jul 10, 2013 at 11:16 AM, Diane Fleming <span dir="ltr"><<a href="mailto:diane.fleming@rackspace.com" target="_blank">diane.fleming@rackspace.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">



<div 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><div class="h5">
<div><br>
On Jul 10, 2013, at 7:57 AM, "Nick Chase" <<a href="mailto:nchase@mirantis.com" target="_blank">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>That URL actually refers to many calls, though; Are you suggesting that each call should have its own anchor, such as:</div>
<div><br>
</div>
<div><a href="http://api.openstack.org/api-ref.html#compute_servers_list" target="_blank">http://api.openstack.org/api-ref.html#compute_servers_list</a></div>
<div><a href="http://api.openstack.org/api-ref.html#compute_servers_create" target="_blank">http://api.openstack.org/api-ref.html#compute_servers_create</a></div>
<div><a href="http://api.openstack.org/api-ref.html#compute_servers_detail" target="_blank">http://api.openstack.org/api-ref.html#compute_servers_detail</a></div>
<div><a href="http://api.openstack.org/api-ref.html#compute_servers_delete" target="_blank">http://api.openstack.org/api-ref.html#compute_servers_delete</a></div>
<div><br>
</div>
<div>I'd be for that.</div>
<div><br>
</div>
<div>----  Nick</div>
<div><br>
</div>
<div> </div>
</div>
<br>
</div>
</div>
</div>
</div>
</blockquote>
</div></div></div>

</blockquote></div><br></div>