Capítulo 2. Seleção da arquitetura da API
Este trabalho foi traduzido com recurso a IA. Agradecemos o teu feedback e comentários: translation-feedback@oreilly.com
As cidades felizes são aquelas que têm uma arquitetura.
Le Corbusier, Towards a New Architecture (Dover Publications, 1965)
No Capítulo 1, começaste o teu projeto de portfólio compreendendo as necessidades do utilizador e selecionando casos de uso para satisfazer. Esse trabalho inicial é fundamental para garantir que você construa os produtos certos para atender às necessidades reais dos clientes. Neste capítulo, começarás a desenvolver a arquitetura que será usada para criar suas primeiras APIs.
Estilos arquitectónicos API
Uma das decisões mais importantes que tem de tomar é a seleção do estilo de arquitetura da API que irá utilizar. Uma vez que está a utilizar um processo de design centrado no consumidor, um dos seus primeiros objetivos seria utilizar um estilo que é amplamente suportado e compreendido pelos potenciais consumidores. O relatório Postman 2023 State of the API Report revelou que estes são os seis principais estilos de arquitetura de API:
-
RESTAURAÇÃO: 86%
-
Webhooks: 36%
-
GraphQL: 29%
-
Protocolo simples de acesso a objectos (SOAP): 26%
-
WebSockets: 25%
-
gRPC: 11%
A popularidade esmagadora do REST encontrada no inquérito é consistente com o que se verifica se explorar a maioria das APIs públicas. REST é atualmente o estilo típico utilizado para APIs. Para um exemplo relevante para o teu projeto, ...