<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Mon, Oct 23, 2017 at 11:19 AM, Jeremy Audet <span dir="ltr"><<a href="mailto:jaudet@redhat.com" target="_blank">jaudet@redhat.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="ltr"><span class=""><div><span id="m_5480500028187008376gmail-:1ps" class="m_5480500028187008376gmail-ams m_5480500028187008376gmail-bkI m_5480500028187008376gmail-amt"></span>> Once the task has completed, the user should be free to forget the task ID and be able to use natural keys to find and inspect resources that got created/updated.<br><br></div></span>I sure hope we won't be asking the user to build URLs themselves. That promotes a much tighter coupling between clients and API versions, making client-side code more complex, and making server-side upgrades and changes harder. Making a discoverable API is hard, but there are pay-offs.</div></blockquote><div><br></div><div>I had the same initial reaction, but I think the key verb in Jeff's email is "find". I can use a natural key find a specific resource by querying a collection endpoint with filters.</div><div><br></div><div>GET /api/v3/repositories/?name=myfavoriterpms </div></div><div><br></div>-- <br><div class="gmail_signature" data-smartmail="gmail_signature"><div dir="ltr"><p style="color:rgb(0,0,0);font-family:overpass-mono,monospace;font-size:10px;margin:0px!important;padding:0px!important"><span style="margin:0px!important;padding:0px!important">Michael</span> <span style="margin:0px!important;padding:0px!important">Hrivnak</span></p><p style="color:rgb(0,0,0);font-family:overpass-mono,monospace;font-size:10px;margin:0px!important;padding:0px!important"></p><span style="color:rgb(0,0,0);font-family:overpass-mono,monospace;font-size:10px;margin:0px!important;padding:0px!important"><span style="margin:0px!important;padding:0px!important">Principal Software Engineer</span><span style="margin:0px!important;padding:0px!important">, <span style="margin:0px!important;padding:0px!important">RHCE</span></span> </span><span style="color:rgb(0,0,0);font-family:overpass-mono,monospace;font-size:10px"></span><br style="color:rgb(0,0,0);font-family:overpass-mono,monospace;font-size:10px;margin:0px!important;padding:0px!important"><p style="color:rgb(0,0,0);font-family:overpass-mono,monospace;font-size:10px;margin:0px!important;padding:0px!important">Red Hat</p></div></div>
</div></div>