O que é uma API · Programa com Martin

Descobre como os sites conversam entre si – e como o teu site pode perguntar sobre tempo, mapas ou IA.

Um empregado de mesa entre duas cozinhas

Imagina um restaurante. Tu (o teu site) queres encomendar comida, mas não podes entrar na cozinha (um serviço externo – tempo, mapas, IA). Para isso serve o empregado de mesa – leva a tua encomenda à cozinha e traz-te o prato pronto.

Esse empregado chama-se API (Application Programming Interface). É uma forma acordada de os programas pedirem dados uns aos outros:

O teu site envia um pedido («Como vai estar o tempo amanhã em Brno?»).
A API passa-o ao serviço que sabe a resposta.
O serviço devolve uma resposta num formato acordado.

Vou mostrar-te: JSON – uma linguagem partilhada

Os programas respondem uns aos outros em formato JSON. Parece quase um objeto JavaScript, que já conheces do Mago:

{
  "mesto": "Brno",
  "teplota": 21,
  "slunecno": true,
  "dny": ["Saturday", "Sunday"]
}

O texto vai entre aspas, os números não.
true/false já conheces das condições.
Parênteses retos = uma lista, chavetas = um objeto.

Experimenta agora – abre este endereço no browser (é uma API de tempo real, gratuita, sem registo):

https://api.open-meteo.com/v1/forecast?latitude=49.19&longitude=16.61&current_weather=true

Vês JSON com o tempo atual em Brno. Sem gráficos – só dados puros. Os gráficos constróis tu!

💡

As APIs estão em todo o lado. Quando uma app móvel te mostra previsão, horários de autocarro ou um mapa, quase nunca tem esses dados – pede-os através de uma API. Agora estás a aprender a fazer o mesmo.

Agora és tu 💪

Abre o endereço acima no browser e encontra a temperatura atual e a velocidade do vento na resposta.
Tenta mudar latitude e longitude no endereço para as coordenadas da tua cidade (encontra-as num serviço de mapas – clique direito → «What’s here?»).
Escreve 2–3 ideias para o teu projeto sobre que dados externos seriam úteis no teu site:

🏫 Site da escola – ideias

Tempo para uma viagem escolar, um mapa com a localização da escola, ementa da cantina da API da cantina (se tiver), feriados e férias escolares.

🙋 Site pessoal – ideias

Tempo na tua cidade, um mapa dos sítios onde estiveste, um chatbot de IA que responde a perguntas sobre ti para visitantes.

🌍 Diário de viagens – ideias

Um mapa com pinos das tuas viagens, tempo no próximo destino, conversão de moeda para o orçamento de viagem.

⚽ Site de clube – ideias

Tempo para o jogo do fim de semana, um mapa do campo para equipas visitantes, um assistente de IA que explica as regras do futebol.

✅

Verifica: Consegues explicar o que é uma API (um empregado entre programas) e reconhecer JSON. Viste uma resposta API real no browser.

O que ficas a saber desta lição

API = uma forma acordada de os programas pedirem dados uns aos outros.
As respostas vêm em JSON – objetos e listas como em JavaScript.
Na próxima lição vais puxar dados de uma API diretamente para o teu site com fetch.