4

Neste Artigo do Infoq, o autor destaca os cinco princípios fundamentais do REST:

  1. Dê a todas as coisas um Identificador
  2. Vincule as coisas (recursos/identificador)
  3. Utilize métodos padronizados
  4. Recursos com múltiplas representações
  5. Comunique sem estado

Porém, um deles gostaria que me ajudassem a entender melhor, trata-se do princípio Utilize métodos padronizados. Em resumo o autor diz que:

Em uma abordagem HTTP RESTful, você teria que começar por uma inteface genérica que compusesse o protocolo HTTP do aplicativo. Você poderia fazer algo assim:

inserir a descrição da imagem aqui

Minha dúvida:

  • Como ficaria esta interface (com base na imagem)?
  • Como ficaria a implementação de um recurso (ID - Identificador) caso queira passar um objeto json por exemplo

1 Resposta 1

3

Como ficaria esta interface (com base na imagem)?

Depende do seu sistema, mas normalmente um sistema que implementa a REST API (Web API 2 é um dos frameworks que implementa o padrão) tem como interface o suporte a esses quatro métodos (GET, POST, PUT e DELETE). Aqui tem uma lista com todos os métodos suportados pelo protocolo HTTP. A maioria deles não são imprescindíveis. Você implementa se quiser.

A interface normalmente é definida pela rota padrão + método. No seu exemplo, você sabe que se chamar /orders por GET, você obterá a lista completa de entidades do tipo order do serviço, e se passar um objeto serializado por PUT (como um JSON, que é o mais comum, até um XML), você está inserindo uma nova entidade do tipo order no armazenamento desse serviço.

No caso do Web API 2, a documentação sobre as interfaces é gerada automaticamente pelo framework. Tal recurso é conhecido como ApiExplorer.

Como ficaria o recurso (ID) caso queira passar um objeto json, por exemplo?

Depende de cada serviço. Se implemento um serviço aceitando que o id será definido por uma requisição PUT ou ainda POST (o que não é recomendado, mas é possível). A maioria dos serviços definem sozinho o id do novo registro. Quando isso acontece, os dados do novo registro são devolvidos no cabeçalho da resposta da requisição. Você pode ler mais sobre isso aqui (seção "Creating a Resource").

Você deve fazer log-in para responder a esta pergunta.

Esta não é a resposta que você está procurando? Pesquise outras perguntas com a tag .