<p dir="ltr">Works for me.</p>
<div class="gmail_quote">On Jul 10, 2013 3:55 PM, "Diane Fleming" <<a href="mailto:diane.fleming@rackspace.com">diane.fleming@rackspace.com</a>> wrote:<br type="attribution"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">




<div style="font-size:14px;font-family:Calibri,sans-serif;word-wrap:break-word">
<div>
<div>
<div>Yes, the query parameters I'm talking about are on GET requests – mostly list resources calls – where you use the query parameters to filter the results. </div>
<div><br>
</div>
<div>For example, list servers, list flavors, list images…..</div>
<div><br>
</div>
<div>There aren't a lot of them – is anyone opposed to me showing the query parameters in the URIs?</div>
<div><br>
</div>
<div><br>
</div>
<div><br>
</div>
<div>
<div>
<div style><font color="rgb(0, 0, 0)" face="Apple Chancery"><i>Diane</i></font></div>
<div style="font-size:14px;font-family:Calibri,sans-serif">
<font color="rgb(0, 0, 0)"><i>----------------------------------------------</i></font></div>
<div style="font-size:14px;font-family:Calibri,sans-serif">
<font color="rgb(0, 0, 0)">Diane Fleming</font></div>
<div style="font-family:Calibri,sans-serif;font-size:14px">
<div style>Software Developer II - US</div>
</div>
<a href="mailto:diane.fleming@rackspace.com" target="_blank">diane.fleming@rackspace.com</a></div>
<div>Cell  <a href="tel:512.323.6799" value="+15123236799" target="_blank">512.323.6799</a></div>
<div>Office <a href="tel:512.874.1260" value="+15128741260" target="_blank">512.874.1260</a><br>
<span style="font-family:Calibri,sans-serif">
<div style="font-family:Calibri,sans-serif;font-size:14px">
<div style>Skype drfleming0227</div>
<div style>Google-plus <a href="mailto:diane.fleming@gmail.com" target="_blank">diane.fleming@gmail.com</a></div>
</div>
</span></div>
</div>
</div>
</div>
<div><br>
</div>
<span>
<div style="border-right:medium none;padding-right:0in;padding-left:0in;padding-top:3pt;text-align:left;font-size:11pt;border-bottom:medium none;font-family:Calibri;border-top:#b5c4df 1pt solid;padding-bottom:0in;border-left:medium none">

<span style="font-weight:bold">From: </span>Nick Chase <<a href="mailto:nchase@mirantis.com" target="_blank">nchase@mirantis.com</a>><br>
<span style="font-weight:bold">Date: </span>Wednesday, July 10, 2013 12:24 PM<br>
<span style="font-weight:bold">To: </span>Diane Fleming <<a href="mailto:diane.fleming@rackspace.com" target="_blank">diane.fleming@rackspace.com</a>><br>
<span style="font-weight:bold">Cc: </span>"<a href="mailto:openstack-docs@lists.openstack.org" target="_blank">openstack-docs@lists.openstack.org</a>" <<a href="mailto:openstack-docs@lists.openstack.org" target="_blank">openstack-docs@lists.openstack.org</a>><br>

<span style="font-weight:bold">Subject: </span>Re: [Openstack-docs] Hi all - question<br>
</div>
<div><br>
</div>
<div>
<div>
<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>
<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>
</div>
</div>
</span>
</div>

</blockquote></div>