<div dir="ltr">This sounds similar to <a href="https://en.wikipedia.org/wiki/HATEOAS">https://en.wikipedia.org/wiki/HATEOAS</a></div><div class="gmail_extra"><br><div class="gmail_quote">On 9 November 2015 at 08:10, Heiko W.Rupp <span dir="ltr"><<a href="mailto:hrupp@redhat.com" target="_blank">hrupp@redhat.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Hey,<br>
<br>
one cool trait of RESTful apis, which we all use every day hundreds of times<br>
is the hyperlinking of data - we click on links in the web browser.<br>
<br>
I think that would be pretty good for our apis as well.<br>
To take alerts as an example (see my other mail)<br>
<br>
I can go like GET /triggers/{id} to get a trigger with some data.<br>
Now to learn about the conditions I need to browse to the docs<br>
to potentially find out that I can get them at /triggers/{id}/conditions<br>
<br>
It would be good if we would add for each resource a "Links" section<br>
like:<br>
<br>
links: [<br>
{<br>
rel='dampening'<br>
href=<a href="http://blabla/hawkular/alerts/triggers/{id}/dampening" rel="noreferrer" target="_blank">http://blabla/hawkular/alerts/triggers/{id}/dampening</a><br>
},<br>
{<br>
rel='conditions'<br>
href=<a href="http://blabla/hawkular/alerts/triggers/{id}/conditions" rel="noreferrer" target="_blank">http://blabla/hawkular/alerts/triggers/{id}/conditions</a><br>
}<br>
]<br>
<br>
This way it is relatively easy to follow those for humans, but also<br>
machines.<br>
_______________________________________________<br>
hawkular-dev mailing list<br>
<a href="mailto:hawkular-dev@lists.jboss.org">hawkular-dev@lists.jboss.org</a><br>
<a href="https://lists.jboss.org/mailman/listinfo/hawkular-dev" rel="noreferrer" target="_blank">https://lists.jboss.org/mailman/listinfo/hawkular-dev</a><br>
</blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature"><div dir="ltr"><div><div dir="ltr">Anton Hughes<div><br></div></div></div></div></div>
</div>