Endpoint

Se a API inteira é o garçom, o endpoint é o prato específico que você pede a ele: buscar um usuário, enviar uma mensagem, salvar uma imagem. Cada prato tem seu próprio nome no cardápio e seu próprio endereço, então quando você quer o prato certo, você pede pelo nome exato, não "me traz alguma coisa".

Esse cardápio é também um contrato publicado. O restaurante promete que o prato "salada Caesar" sempre vem com alface, croutons e parmesão, do jeito que está escrito ali. Um endpoint funciona igual: ele promete devolver a informação sempre no mesmo formato, pra quem programou em cima dele poder confiar sem precisar checar toda hora.

E é por isso que, quando o restaurante tira um prato do cardápio sem avisar, toda ferramenta construída em cima dele quebra de uma vez. Não é força maior, é que o contrato mudou e ninguém que dependia dele ficou sabendo. É a explicação real por trás daquele aplicativo que "parou de funcionar do nada" de uma hora pra outra.

Você vê isso quando um plugin de frete some do carrinho de uma loja Shopify porque a transportadora mudou o endereço do serviço sem avisar, ou quando um plugin do WordPress para de funcionar porque o serviço que ele consultava trocou de forma. Na maioria das vezes não foi você nem o programador que estragou nada: foi o endpoint do outro lado que sumiu ou mudou.

No meu site eu tenho um endereço próprio que só faz uma coisa: devolver os últimos vídeos do meu canal do YouTube. É um endpoint só meu, e a página do Lab chama ele toda vez que alguém abre a página, pra sempre mostrar o vídeo mais recente sem eu precisar atualizar nada na mão.

A ressalva é que nem todo endpoint é permanente. Empresas aposentam versões antigas, trocam de tecnologia, decidem cobrar por algo que era grátis. Se o seu negócio depende do endpoint de outra empresa, você está, até certo ponto, à mercê da decisão dela.

Mas fica a equivalência: API é o restaurante inteiro. Endpoint é o prato que você escolheu no cardápio.

O próximo termo é domínio: o endereço que leva as pessoas até a porta do seu restaurante.