O que uma API realmente é
A forma mais clara de pensar em uma é como um cardápio de pedidos que um programa oferece a outro.
Um restaurante não deixa você entrar na cozinha e cozinhar. Ele te entrega um cardápio: aqui estão as coisas que você pode pedir, aqui está como pedir, aqui está o que você vai receber de volta. Você não precisa saber como a cozinha funciona. Você só precisa do cardápio. Uma API é exatamente isso — uma empresa diz "aqui estão os pedidos que você pode fazer ao nosso serviço, e aqui está o que cada um retorna."
Quando a IA escreve código que "chama a API do tempo", ela está fazendo um pedido daquele cardápio: me dê a previsão para esta cidade. Os servidores da empresa de meteorologia fazem o trabalho e devolvem uma resposta. Seu app nunca vê o banco de dados ou o código deles. Ele só recebe o prato pronto.
┌────────────┐ request: GET /forecast?city=London ┌────────────┐
│ YOUR APP │ ─────────────────────────────────────▶ │ API │
│ (client) │ │ endpoint │
│ │ ◀───────────────────────────────────── │ (server) │
└────────────┘ response: { "temp": 14, ... } (JSON) └────────────┘
orders off does the work,
the menu sends the dish
A virada de mentalidade importante: uma API é um contrato. A outra empresa promete que, se você perguntar de um jeito específico, vai receber uma resposta em um formato específico. Seu trabalho — e o da IA — é perguntar corretamente e ler a resposta corretamente. A maioria dos bugs de API é um dos lados quebrando esse contrato.