REST API no protocolo HTTP
Geralmente, ao criar sites para obter, criar, alterar e excluir dados, são usados apenas os métodos GET e POST, pois eles são bem suportados por navegadores e servidores. O mesmo se aplica às APIs fornecidas por sites. Existem, no entanto, abordagens especiais que padronizam a API para a conveniência geral tanto dos desenvolvedores da API quanto de seus usuários.
Uma dessas abordagens é a REST API (muitas vezes diz-se RESTful, usando esta palavra como um adjetivo). A base dessa API é o uso amplo dos métodos do protocolo HTTP. Nessa abordagem, o método GET é usado para recuperar dados, o método POST para criar, o método PUT para alterar e o método DELETE para excluir.
Por exemplo, vamos considerar uma API que manipula usuários. Vamos ver como ficariam os URLs para várias ações.
Recuperar todos os usuários:
GET http://api.loc/users/
Recuperar um usuário pelo seu id:
GET http://api.loc/user/1/
Criar um usuário:
POST http://api.loc/user/
Alterar um usuário pelo seu id:
PUT http://api.loc/user/1/
Excluir um usuário pelo seu id:
DELETE http://api.loc/user/1/
Suponha que você tenha uma API de produtos de uma loja virtual. Escreva os URLs da loja de forma que a API se torne RESTful.
