book

Dominar a arquitetura de API

by James Gough, Daniel Bryant, Matthew Auburn

April 2025

Intermediate to advanced

288 pages

8h 28m

Portuguese (Portugal, Brazil)

O'Reilly Media, Inc.

Book available

Read now

Unlock full access

Por que escrevemos este livro?Porque deves ler este livro?A quem se destina este livroProgramadorArquiteto acidentalArquiteto de soluções/empresaO que vais aprenderO que este livro não éConvenções utilizadas neste livroUtilizar exemplos de códigoAprendizagem em linha da O'ReillyComo contactar-nosAgradecimentosJames GoughDaniel BryantMatthew Auburn
A viagem da arquiteturaUma breve introdução às APIsExemplo de execução: Estudo de caso do sistema de conferênciaTipos de APIs no estudo de caso da conferênciaRazões para alterar o sistema de conferênciasDa arquitetura em camadas à modelação de APIsEstudo de caso: Um passo evolutivoInfraestrutura API e padrões de tráfegoEstudo de caso do roteiro para a conferênciaUtilização de diagramas C4Diagrama de contexto C4Diagrama do contentor C4Diagrama de componentes C4Utilizar registos de decisões de arquiteturaEvolução dos participantes ADRDominar a API: Diretrizes ADRResumo
Estudo de caso: Projetando a API do participanteIntrodução ao RESTIntrodução ao REST e HTTP por exemploO Modelo de Maturidade de RichardsonIntrodução às APIs de chamada de procedimento remoto (RPC)Uma breve menção ao GraphQLEstrutura e padrões da API RESTColecções e paginaçãoFiltrar colecçõesTratamento de errosDiretrizes ADR: Escolher uma norma APIEspecificando APIs REST usando OpenAPIAplicação prática das especificações OpenAPIGeração de códigoValidação da OpenAPIExemplos e zombariaDetetar alteraçõesControle de versão da APIVersionamento semânticoEspecificação e versão da OpenAPIImplementação de RPC com gRPCModelagem de intercâmbios e escolha de um formato de APIServiços de elevado tráfegoGrandes cargas úteis de intercâmbioBenefícios de desempenho do HTTP/2Formatos vintageOrientações: Modelação de intercâmbiosEspecificações múltiplasExiste a Especificação Dourada?Desafios das especificações combinadasResumo
Cenário do sistema de conferência para este capítuloEstratégias de testeQuadrante de testeTeste a pirâmideDiretrizes ADR para estratégias de ensaioTestes de contratoPorque é que os testes por contrato são muitas vezes preferíveisComo um contrato é implementadoDiretriz ADR: Testes de contratoTeste de componentes APITeste de contrato versus teste de componenteEstudo de caso: Teste de componentes para verificar o comportamentoTeste de integração de APIUsando servidores Stub: Porquê e comoDiretriz ADR: Teste de integraçãoContentorização de componentes de teste: Contentores de testeEstudo de caso: Aplicando Testcontainers para verificar integraçõesTeste de ponta a pontaAutomatizando a validação de ponta a pontaTipos de testes de ponta a pontaDiretrizes ADR: Teste de ponta a pontaResumo
Um API Gateway é a única solução?Orientações: Proxy, balanceador de carga ou gateway de APIEstudo de caso: Expondo o Serviço ao Participante aos ConsumidoresO que é um API Gateway?Que funcionalidades oferece um API Gateway?Onde é implementado um API Gateway?Como é que um API Gateway se integra com outras tecnologias no Edge?Porquê utilizar um API Gateway?Reduzir o acoplamento: Adaptador/Facada entre Frontends e BackendsSimplifica o consumo: Agregação/tradução de serviços de back-endProtege as APIs contra o uso excessivo e abusivo: Deteção e atenuação de ameaçasCompreende como as APIs estão a ser consumidas: ObservabilidadeGere APIs como produtos: Gerenciamento do ciclo de vida da APIMonetiza as APIs: Gestão de contas, faturação e pagamentoUma história moderna dos API GatewaysAnos 90 em diante: balanceadores de carga de hardwareInício dos anos 2000 em diante: Balanceadores de carga de softwareMeados dos anos 2000: Controladores de entrega de aplicações (ADCs)Início da década de 2010: Gateways de API de primeira geração2015 em diante: Gateways de API de segunda geraçãoTaxonomia atual do API GatewayGateways empresariais tradicionaisMicrosserviços/Micro GatewaysGateways de malha de serviçoComparação dos tipos de API GatewayEstudo de caso: Evolução do sistema de conferências utilizando um gateway de APIInstalando o Ambassador Edge Stack no KubernetesConfiguração de mapeamentos de caminhos de URL para serviços de back-endConfiguração de mapeamentos usando roteamento baseado em hostImplantação de gateways de API: Entendendo e gerenciando falhasAPI Gateway como um ponto único de falhaDetetar e assumir os problemasResolução de incidentes e problemasMitigar os riscosArmadilhas comuns na implementação do API GatewayLoopback do gateway da APIAPI Gateway como um ESBTartarugas (API Gateways) até ao fundoSeleção de um API GatewayIdentificação de requisitosConstruir versus comprarDiretrizes ADR: Seleção de um API GatewayResumo
O Service Mesh é a única solução?Orientações: Deves adotar o Service Mesh?Estudo de caso: Extrair a funcionalidade das sessões para um serviçoO que é o Service Mesh?Qual é a funcionalidade de um Service Mesh?Onde é implantado um Service Mesh?Como é que um Service Mesh se integra com outras tecnologias de Network+?Porquê utilizar uma rede de serviços?Controlo detalhado do encaminhamento, fiabilidade e gestão do tráfegoProporciona uma observabilidade transparenteAplica a segurança: Segurança de transporte, autenticação e autorizaçãoApoiar a comunicação interfuncional em várias línguasSeparação da gestão do tráfego de entrada e de serviço para serviçoEvolução do Service MeshHistória e motivações iniciaisPadrões de implementaçãoTaxonomia da malha de serviçosEstudo de caso: Usando um Service Mesh para roteamento, observabilidade e segurançaRoteamento com o IstioObservar o tráfego com o LinkerdSegmentação de rede com o ConsulImplantação de uma malha de serviço: Entendendo e gerenciando falhasService Mesh como um ponto único de falhaDesafios comuns da implementação do Service MeshService Mesh como ESBService Mesh como GatewayDemasiadas camadas de Network+Seleção de uma malha de serviçoIdentificação de requisitosConstruir versus comprarLista de verificação: Seleção de uma rede de serviçosResumo

Separação entre implantação e liberaçãoEstudo de caso: Marcação de caraterísticasGestão do tráfegoEstudo de caso: Modelagem de liberações no sistema de conferênciasCiclo de vida da APIMapeamento das estratégias de lançamento para o ciclo de vidaDiretriz ADR: Separa o lançamento da implantação com gestão de tráfego e sinalizadores de recursosEstratégias de libertaçãoLançamentos CanáriosEspelhamento de tráfegoAzul-verdeEstudo de caso: Realização de rollouts com o Argo RolloutsMonitorização do sucesso e identificação de falhasTrês pilares da observabilidadeMétricas importantes para APIsLê os sinaisDecisões de aplicação para lançamentos de software eficazesCache de respostasPropagação de cabeçalho ao nível da aplicaçãoRegisto para auxiliar a depuraçãoConsidera uma plataforma de opiniãoDiretriz ADR: Plataformas de opiniãoResumo
Estudo de caso: Aplicando o OWASP à API do participanteO risco de não proteger APIs externasModelação de ameaças 101Pensa como um atacanteComo usar o modelo de ameaçaEtapa 1: Identificar os teus objectivosPasso 2: Recolhe a informação corretaPasso 3: Decompõe o sistemaEtapa 4: Identificar as ameaças - Fazendo isto no teu STRIDEPasso 5: Avalia os riscos das ameaçasEtapa 6: ValidaçãoResumo
AutenticaçãoAutenticação do utilizador final com TokensAutenticação de sistema para sistemaPorque não deves misturar chaves e utilizadoresOAuth2Função de servidor de autorização com interações de APITokens Web JSON (JWT)Terminologia e mecanismos das concessões OAuth2Diretriz ADR: Devo considerar a utilização do OAuth2?Código de autorização SubvençãoAtualizar fichasConcessão de credenciais de clienteConcessões OAuth2 adicionaisDiretrizes do ADR: Escolher quais as subvenções OAuth2 a apoiarÂmbitos do OAuth2Aplicação da autorizaçãoApresenta a OIDCSAML 2.0Resumo
Porquê utilizar APIs para desenvolver um sistema?Criar abstrações úteis: Aumenta a coesãoClarificar os limites do domínio: Promovendo o Acoplamento SoltoEstudo de caso: Estabelecimento de limites de domínio dos participantesOpções de arquitetura do estado finalMonólitoArquitetura orientada para os serviços (SOA)MicrosserviçosFunçõesGerir o processo evolutivoDetermina os teus objetivosUtilizar funções de aptidãoDecomposição de um sistema em módulosCriar APIs como "costuras" para extensãoIdentificação de pontos de alavancagem de mudança dentro de um sistemaEntrega e verificação contínuasPadrões de arquitetura para sistemas em evolução com APIsFigo EstranguladorFachada e adaptadorBolo de camadas APIIdentificar pontos problemáticos e oportunidadesProblemas de atualização e manutençãoProblemas de desempenhoQuebra de dependências: APIs altamente acopladasResumo
Estudo de caso: Mudança do Serviço de Atendimento ao Cliente para a CloudEscolher uma estratégia de migração para a CloudManter ou revisitarRehostReplataformaRecompraRefactor/Re-arquitetarRetira-teEstudo de caso: Replataforma do Serviço de Atendimento ao Cliente para a CloudPapel da Gestão de APINorte-Sul versus Leste-Oeste: A indefinição das linhas de gestão do tráfegoComeça na borda e trabalha para dentroAtravessar fronteiras: Roteamento entre redesDa Arquitetura Zonal à Confiança ZeroEntra na zonaNão confies em ninguém e verificaPapel do Service Mesh em arquitecturas de confiança zeroResumo
Estudo de caso: Um olhar para trás na tua viagemAPIs, a Lei de Conway e a tua organizaçãoCompreender os tipos de decisãoPrepara-te para o futuroComunicação assíncronaHTTP/3Malha baseada na plataformaO que vem a seguir: Como continuar a aprender sobre a arquitetura da APIAperfeiçoa continuamente os fundamentosManter-se atualizado com as notícias do sectorRadares, quadrantes e relatórios de tendênciasAprende sobre as melhores práticas e casos de utilizaçãoAprende fazendoAprende ensinando

Content preview from Dominar a arquitetura de API

Parte I. Projetando, criando e testando APIs

Esta secção fornece os blocos de construção fundamentais para arquitecturas orientadas por API.

No Capítulo 1, aprenderás sobre as APIs baseadas em REST e Remote Procedure Call (RPC). Exploraremos especificações e esquemas, padrões recomendados, estratégias de controle de versão e como escolher a API certa para o teu sistema.

No Capítulo 2, aprenderás sobre como testar APIs e como diferentes estilos de teste são melhor aplicados a arquiteturas orientadas por API.

Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.

Start your free trial

Aprendendo estilos de API

Lukasz Dynowski, Marcin Dulak

Algoritmos de grafos

Mark Needham, Amy E. Hodler

Livro de receitas de padrões e práticas de API da Web RESTful

Mike Amundsen

Padrões de arquitetura de aplicativos em Cloud

Kyle Brown, Bobby Woolf, Joseph Yoder

Publisher Resources

ISBN: 9798341641617Supplemental Content