O assunto API passou batido, nao consigo perceber sua presença. O aluno que tenta ter uma visao global do projeto, se perde, porque a didatica tá muito micro centrada em modulos especificos e que nao se conectam
Você está vendo a versão anterior da nova experiência da Alura que estamos preparando para você. Em breve, ela ganha uma identidade visual novinha totalmente pensada em potencializar seus estudos!
O assunto API passou batido, nao consigo perceber sua presença. O aluno que tenta ter uma visao global do projeto, se perde, porque a didatica tá muito micro centrada em modulos especificos e que nao se conectam
Olá, Daniel. Tudo bem?
Obrigado pelo seu desabafo. Quero validar o seu sentimento: você está coberto de razão ao se sentir assim. Tentar construir um projeto em blocos isolados sem enxergar o desenho final é extremamente frustrante, e essa sensação de que "a API passou batido" acontece justamente porque ela foi tratada apenas como uma linha de código no meio de um turbilhão de conceitos de Orientação a Objetos.
Você não está errado ou "perdido" por conta própria; a didática focou tanto nos micro-detalhes das classes e métodos que acabou escondendo a visão macro do ecossistema. Vamos resolver isso agora?
Para você recuperar a visão global e entender exatamente onde a API está, o que ela está fazendo e como tudo se conecta, vamos dar um passo para trás e olhar o projeto de cima:
Imagine que você está criando um aplicativo estilo iFood ou Uber Eats para o terminal. O objetivo do projeto é:
A API (Application Programming Interface) é a ponte invisível que conecta o seu código ao servidor onde os dados reais estão guardados.
No seu projeto, a presença da API acontece especificamente quando você utiliza a biblioteca requests para fazer um "pedido" (requisição) à internet. O fluxo real de conexão do seu projeto funciona exatamente assim:
[ O Servidor da Alura ] (Nuvem com a lista de restaurantes e pratos em formato JSON)
▲
│ (A API entrega os dados brutos através da URL)
▼
[ Seu Código Python ] ──► [ Camada de O.O. ] ──► [ Arquivos Locais ]
(requests.get) (Classes e Filtros) (.txt ou .json no seu PC)
No código, a API é consumida nesta linha crucial:
url = 'https://guilhermeonrails.github.io/api-restaurantes/restaurantes.json'
resposta = requests.get(url)
Quando o código roda essa linha, ele vai até o endereço da API na web e traz um bloco gigante de texto puro chamado JSON.
A confusão de que os módulos "não se conectam" acontece porque a Orientação a Objetos entra para arrumar a bagunça que a API entregou.
Restaurante. Pegamos os dados da API e os transformamos em Objetos reais dentro do Python.Tudo o que foi ensinado de forma fragmentada serve para isso: A API te dá a matéria-prima bruta, e a Orientação a Objetos é a fábrica que molda essa matéria-prima até virar o produto final.
Vou reportar o seu feedback para a nossa equipe de design instrucional para que nos próximos cursos a gente adicione um vídeo ou esquema visual logo no início, deixando clara essa arquitetura antes de mergulhar no código.
Ficou mais claro como as peças se encaixam olhando por esse ângulo? Se você quiser, poste aqui o trecho do código que está te gerando mais nó na cabeça para destrincharmos o fluxo dele juntos!