[SP-pm] Resumo do Evento Técnico

[Leonardo Ruoso]

Em 31 de janeiro de 2015 18:09, Leonardo Ruoso <leonardo em ruoso.com>
escreveu:

> Em 31 de janeiro de 2015 17:48, Renato Santos <renato.cron em 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…
-------------- Pr�xima Parte ----------
Um anexo em HTML foi limpo...
URL: <http://mail.pm.org/pipermail/saopaulo-pm/attachments/20150131/1cec02ee/attachment.html>