Em 31 de janeiro de 2015 18:09, Leonardo Ruoso <leona...@ruoso.com> escreveu:
> Em 31 de janeiro de 2015 17:48, Renato Santos <renato.c...@gmail.com> > escreveu: > >> Mais links para ler: >> >> REST APIs must be hypertext-driven >> - http://roy.gbiv.com/untangled/2008/rest-apis-must-be-hypertext-driven >> (too strict) >> > De fato, é o mais strictu senso que você vai encontrar sobre Rest: um texto do Roy Fielding :p Creating an efficient REST API with HTTP >> - http://mark-kirby.co.uk/2013/creating-a-true-rest-api/ (cool) >> > O cara vai bem até: Version your API, and never change released features Depois desse ponto o texto desanda em incorreções e só mostra como as pesoas tem uma preguiça violenta de estudar. 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). 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. 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…
=begin disclaimer Sao Paulo Perl Mongers: http://sao-paulo.pm.org/ SaoPaulo-pm mailing list: SaoPaulo-pm@pm.org L<http://mail.pm.org/mailman/listinfo/saopaulo-pm> =end disclaimer