Sua API é RESTfull?As boas práticas no desenvolvimento e aprendizados a partir do livro REST API Design Rulebook

É cada dia mais comum termos aplicações que funcionem única e exclusivamente pela Internet, sendo consumidas por navegadores em desktops, notebooks ou dispositivos móveis. 

Entretanto, esse tipo de aplicação pode gerar problemas a organização e consequentemente, não garantir uma boa experiência ao usuário. Para solucionar esse dilema, as APIs RESTfull possuem um sistema de organização padronizado que corrige esse erro. 

API RESTfull é uma interface de programação de aplicativos REST que segue os padrões REST na qual um cliente pode acessar seus recursos via endpoints. A sigla REST representa um conjunto de princípios de arquitetura para a WEB. 

Kamila cita algumas regras que garantem o sucesso e a garantia que sua aplicação é RESTfull: 

• Formato das URLs: elas seguem a RFC 3986 que define a sentaxe genérica das URLs; 

• Arquétipos de recursos: auxiliam na comunicação e funcionamento das estruturas existentes numa API REST; 

• Operação CRUD não deve ser informada como parte da URL; 

• GET deve ser utilizado somente para buscar a representação do estado atual de um recurso; 

• HEAD deve ser utilizada para retornar response headers; 

• 301 moved permanently deve ser utilizado para recursos que foram alocados em novos endereços; 

• 303 see other, deve ser utilizado nos casos em que um controller terminou seu trabalho, mas ao invés de retornar um response body, responde com outra URL 

Kamila conta que seguindo a maioria dessas regras, é possível que sua API consiga ser estruturada através de uma arquitetura para a WEB. 

Quer entender um pouco mais sobre a palestra? Vem conferir o vídeo! 

Este artigo foi escrito por Kamila Santos e publicado originalmente em Prensa.li.