book

Aprendendo estilos de API

by Lukasz Dynowski, Marcin Dulak

July 2025

Intermediate to advanced

414 pages

10h 58m

Portuguese (Portugal, Brazil)

O'Reilly Media, Inc.

Book available

Read now

Unlock full access

Por que escrevemos este livroQuem deve ler este livroO que há neste livroO que não está neste livroServiço de Previsão do TempoConvenções usadas neste livroUsando exemplos de códigoAprendizagem online da O'ReillyComo nos contactarAgradecimentosAgradecimentos de Lukasz DynowskiAgradecimentos de Marcin Dulak
O que é uma API?APIs baseadas em Network+Conceitos de comunicação da APIMensagemModos de transmissãoTipos de comunicação síncrona e assíncronaHistória das APIsPor que as APIs?O que são estilos de API?API como um produtoCiclo de vida da APIPlaneamentoConceçãoImplementaçãoTestesImplementaçãoManutençãoReformaGovernança, gerenciamento e plataforma de APIFuturo das APIsResumo
Exemplos de padrões de design de APILinguagem da APINomeação de APIEvolução das APIsControle de versão da APICodificaçãoFiltragemContagem e ordenaçãoPaginaçãoTarefas de longa duraçãoDeduplicação de pedidosRepetição de pedidosLimitação de taxaArmazenamento em cacheEliminaçãoSegurança da APIOWASP Top 10 de segurança de APIExemplos de padrões de segurança da APICriptografia, autenticação e autorizaçãoSanitização e validaçãoMitigação de raspagemPráticas recomendadas de design de APIResumo
Protocolos de redeAPI de soqueteTCP/IP e o modelo OSIImplementação do serviço TCP ECHOConfiguração do laboratório de redeServiço TCP ECHOServidor TCP ECHOCliente TCP ECHO com NetcatCliente TCP ECHO com ScapySegurançaCliente TCP ECHO com OpenSSLExercíciosResumo
O que é hipertexto?Configuração de laboratório do HTTPHTTP/0.9HTTP e HTML em açãoHTTP/1.0Cabeçalhos e corpo da mensagem HTTPHTTP num navegadorComo o DNS afeta as conexões do navegadorConexões TCP paralelas em um navegadorLimitações do TCPBloqueio de cabeça de linha TCPInício lento do TCP e prevenção de congestionamentoHTTP/1.1Persistência de conexão HTTPHTTP/2Quadros e fluxos HTTP/2HTTP/3Estabelecimento de conexão QUIC 1-RTTExercíciosResumo
HTTP, recurso e URIComunicação cliente-servidorOrigens do RESTModelos de maturidade de APIRESTful, RESTless ou RESTSer RESTless é bom o suficiente?ImplementaçãoPontos de extremidade da APIControle de versão da APICRUDPaginaçãoLimitação de taxaArmazenamento em cacheSegurançaToken Web JSONSegurança da camada de transporteDocumentaçãoEspecificação da OpenAPITrês abordagens para a especificação da APISoluções de compromissoQuando usar RESTExercíciosResumo
Problemas com RESTPensando em gráficosOrigens do GraphQLGraphQL versus RESTConstruções do GraphQLComo o GraphQL funcionaImplementaçãoGraphiQLExecutando mutaçõesCRUDLêCria, Atualiza, ApagaSegurançaAtacando o GraphQLAutenticaçãoDocumentaçãoSoluções de compromissoQuando usar o GraphQLExercíciosResumo
O que é um Web Feed?Por que Web Feeds?Evolução dos feeds da WebO que é um Atom Feed?ImplementaçãoLendo FeedsSegurançaSoluções de compromissoExercíciosResumo
Chamada de procedimento remotoOrigens do gRPCSerialização de ProtobufGeração de códigoServidor e cliente gRPC ECHOOs quatro tipos de RPCFormato de fio ProtobufImplementaçãoServiço de enriquecimento de feed Atom gRPCSegurançaDocumentaçãoSoluções de compromissoQuando usar o gRPCExercíciosResumo

O que são Webhooks?Origens dos WebhooksWebhooks de entrada e saídaIntegração e fluxo de dadosImplementaçãoSegurançaDocumentaçãoSoluções de compromissoQuando usar webhooksExercíciosResumo
WebSocket e API do WebSocketHandshake de abertura do WebSocketImplementaçãoCliente e servidor WebSocket ECHOProtocolo WebSocketServidor de alerta meteorológico WebSocketCliente de alerta meteorológico WebSocketSegurançaValidação de origemSegurança de anfitrião fiávelToken Web JSONSegurança da camada de transporteDocumentaçãoSoluções de compromissoQuando usar o WebSocketExercíciosResumo
O que é mensageria?O que é uma fila de espera?Padrões de mensagensPadrão de fila de trabalhoPadrão Publish-SubscribePadrão de RoteamentoPadrão de tópicosPadrão de Pedido-RespostaImplementaçãoFila de trabalhoSegurançaMensagens não criptografadas em trânsitoMensagens encriptadas em trânsitoAutenticação e autorizaçãoDocumentaçãoEspecificação da AsyncAPIDocumentação da AsyncAPIControle de versão de mensagensSoluções de compromissoQuando utilizar o serviço de mensagensExercíciosResumo

Content preview from Aprendendo estilos de API

Capítulo 5. REST

Este trabalho foi traduzido com recurso a IA. Agradecemos o teu feedback e comentários: translation-feedback@oreilly.com

Representational State Transfer (REST) é a API baseada em rede mais popular.¹ O estilo de arquitetura REST² foi formulado em 2000 por Roy Fielding na sua tese de doutoramento "Architectural Styles and the Design of Network-Based Software Architectures", como uma abordagem para criar aplicações baseadas em rede à escala da Internet.

Este capítulo aborda as origens, a implementação, os testes, a segurança, a documentação e as soluções de compromisso das APIs REST. implementa uma API REST usando o Django REST Framework (DRF), para o Weather Forecast Service (WFS), apresentado em "Weather Forecast Service".

HTTP, Recurso e URI

Na prática do , os objetivos arquiteturais do REST se traduzem em três componentes principais: HTTP, um recurso e um URI.

O HTTP é o vaso sanguíneo da Internet, e a maioria dos estilos de API descritos neste livro usa HTTP para trocar mensagens. Ele é suportado por clientes como navegadores da Web, ferramentas de linha de comando como curlO HTTP é um protocolo da camada de aplicação que pode ser baseado em texto ou binário.³ Podes encontrar mais detalhes sobre HTTP no Capítulo 4.

No REST, qualquer informação que possa ser nomeada pode ser um recurso - por exemplo, um documento, uma imagem, um valor numérico de zero ou até mesmo uma pessoa (um ser humano, uma entidade nomeada não virtual não acessível pela Internet).⁴ Um recurso ...