REST e os Códigos de Resposta HTTP

Em uma reunião, se pergunta como avisar o usuário do resultado de uma chamada de um serviço, em se usando uma abordagem baseada em REST.

Minha resposta foi algo simples tipo, ah, 200 vai indicar que funcionou show de bola, 201 quando um objeto foi inserido, 400 quando a requisição for mal feita, 501 quando o usuário chamar um recurso que não temos. Note o uso correto da palavra recurso.

Fiquei falando um minuto mais ou menos, sobre alguns códigos de retorno HTTP. Eis que hoje olhando o Twitter do Daniel Barden encontro este tweet da @DanaDanger, que resume tudo isto:

Então você quer aprender REST?

Mando alguns resources. 🙂

Conceitos de REST?
Importante ler sobre o material de Roy Fielding. E olhar o material sobre REST da Wikipedia.

Outro artigo é o que saiu na InfoQ. Tem tradução na InfoQ Brasil.

Livro?

Indico o Rest in Practice, do Jim Webber.

Exemplos de API para trabalhar com o REST? As APIs listadas abaixo são em alguns casos baseadas nos conceitos de REST, mas já vão ajudar em muito.

Ferramentas para trabalhar?

Vou indicar apenas duas:

  • Restfulie – projeto liderado pela galera da Caelum, que vale apena ser observado, seguido e apoiado.
  • Jersey – API Java muito consistente para fazer trabalhos com REST.