API

O garçom você já conhece: pede na mesa, ele leva pra cozinha, volta com o prato. O que quase ninguém te conta é o resto do restaurante.

Só que o cardápio que o garçom carrega também é a segurança do restaurante. Ele só leva pedido que está escrito ali. Se você pedir "apaga todos os clientes do sistema", isso não está no cardápio, então nem adianta pedir: o garçom simplesmente não aceita, porque a cozinha nunca anunciou esse prato. É por isso que uma API bem feita não vaza o que não deveria: ela só serve o que decidiu publicar.

E todo pedido nesse restaurante exige uma coisa a mais: a chave de API. Ela funciona como um cartão de crédito. Quem está com o seu cartão na mão compra em seu nome, sem precisar da sua senha do banco nem da sua digital. É por isso que uma chave de API vazada é tão grave quanto um cartão perdido: alguém pode fazer pedidos, e a conta chega pra você.

Você já usou uma API sem saber, todo santo dia. Quando o Instagram mostra a previsão do tempo dentro de um story, ou quando um site de viagem junta preço de várias companhias aéreas numa lista só, tem uma API conversando ali atrás. O Google Maps dentro do aplicativo do Uber, o login com Google no Notion, tudo isso é um programa pedindo emprestado o trabalho de outro programa.

No meu caso, a ferramenta Raio-X Viral do meu site chama a API do Gemini toda vez que alguém manda analisar um vídeo, e essa chamada custa uns centavos pra mim a cada análise. Não é o vídeo em si que custa, é o pedido: cada prato servido pela IA tem um preço, mesmo que pequeno. É por isso que a ferramenta tem uma cota grátis por mês em vez de ser ilimitada pra sempre.

A ressalva é que nem toda API é gratuita, e nem toda API é pública. Muita empresa cobra por chamada, outras exigem cadastro e aprovação antes de liberar a chave, e algumas simplesmente não abrem a cozinha pra ninguém de fora. Ter API não é sinônimo de ter acesso livre.

Mas o que ela muda é definitivo: sem API, a IA te explica como se faz. Com API, ela faz.

O próximo termo é rate limit: o que acontece quando você chama o mesmo garçom rápido demais.