<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">Em 31 de janeiro de 2015 18:09, Leonardo Ruoso <span dir="ltr"><<a href="mailto:leonardo@ruoso.com" target="_blank">leonardo@ruoso.com</a>></span> escreveu:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr">Em 31 de janeiro de 2015 17:48, Renato Santos <span dir="ltr"><<a href="mailto:renato.cron@gmail.com" target="_blank">renato.cron@gmail.com</a>></span> escreveu:<br><div class="gmail_extra"><div class="gmail_quote"><span class=""><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr">Mais links para ler:<div><br></div><div>REST APIs must be hypertext-driven<br><div> - <a href="http://roy.gbiv.com/untangled/2008/rest-apis-must-be-hypertext-driven" target="_blank">http://roy.gbiv.com/untangled/2008/rest-apis-must-be-hypertext-driven</a> (too strict)<br></div></div></div></blockquote></span></div></div></div></blockquote><div><br></div><div>De fato, é o mais strictu senso que você vai encontrar sobre Rest: um texto do Roy Fielding :p<br> <br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"><span class=""><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div><div></div><div>Creating an efficient REST API with HTTP<br></div><div> - <a href="http://mark-kirby.co.uk/2013/creating-a-true-rest-api/" target="_blank">http://mark-kirby.co.uk/2013/creating-a-true-rest-api/</a> (cool)<br></div></div></div></blockquote></span></div></div></div></blockquote><div><br><br></div><div>O cara vai bem até:<br><h2>Version your API, and never change released features</h2></div><div>Depois desse ponto o texto desanda em incorreções e só mostra como as pesoas tem uma preguiça violenta de estudar.<br><br></div><div>Versionar uma API (já é complicado falar em API quando se está falando em Rest) é bom, mas, não, por favor, não coloque a versão da API na URI do recurso, a versão da API é parte da negociação de mídia, deve ser feita da mesma forma que se negocia locale, por exemplo, ou formato de documento (HTML, XML, JSON). <br></div><div><br></div><div>Na sequencia, falando de Hateoas, o cara confirma, mais uma vez, a dificuldade que o cidadão comum tem em separar o exemplo do conceito, o concreto do abstrato. Nada impede você de implementar seu Rest em XML, JSON, YAML ou até mesmo usando outros formatos conhecidos. O tipo de documento é ortogonal à especificação do recurso. <br><br></div><div>De fato esse levantamento demonstra a necessidade de documentação mais acessível sobre Rest. Então isso mostraria a relevância de fazermos um Equinócio sobre Rest…<br></div></div></div></div>