O que é uma API?

O cardápio do que o server consegue fazer

⏱ Estim. ~4 min

01 · Ler

API (Application Programming Interface, interface de programação de aplicações) é um conjunto de regras que define quais requisições um server aceita e que respostas ele devolve.

Quando alguém constrói um server, não deixa qualquer pessoa enviar qualquer requisição. Em vez disso, monta uma API — uma lista clara dos endpoints (URLs) que dá para chamar, dos dados que se deve enviar e do que vai voltar.

Todo app que você usa depende de APIs. Quando um app de tempo mostra a previsão, ele está chamando uma API de tempo. Quando você faz login em um site, ele está chamando uma API de autenticação. Quando você rola o feed da rede social, ele está chamando uma API para buscar o próximo lote de posts.

💡 Imagine assimUma API é como o cardápio de um restaurante. O cardápio diz o que dá para pedir, o que vem em cada item e quanto custa. Você não pode entrar na cozinha e improvisar o que quiser — você escolhe a partir do cardápio. APIs são iguais: dizem ao seu app o que ele pode pedir ao server.

Pontos-chave

API = Application Programming Interface
Ela define o "cardápio" das requisições que o server aceita
Cada item do cardápio se chama endpoint (uma URL + um method específico)
APIs deixam softwares diferentes se comunicarem sem precisar conhecer os detalhes internos um do outro

02 · Exemplo de código

Abaixo está a cara de uma API típica de um blog. Cada endpoint é uma combinação de HTTP method + caminho da URL.

Blog API Endpoints

GET    /api/posts          → Get all blog posts
GET    /api/posts/15       → Get post #15
POST   /api/posts          → Create a new post
PUT    /api/posts/15       → Update post #15
DELETE /api/posts/15       → Delete post #15

User API Endpoints

GET    /api/users          → Get all users
GET    /api/users/42       → Get user #42's profile
POST   /api/users          → Create a new user (sign up)
PUT    /api/users/42       → Update user #42's profile
DELETE /api/users/42       → Delete user #42's account

Repare no padrão: a URL diz o que você está manipulando (/posts ou /users), os números dizem qual item e o HTTP method diz o que você quer fazer. Esse padrão consistente faz com que as APIs sejam intuitivas e fáceis de usar.

03 · Quiz

Um app de previsão do tempo no celular mostra a previsão para hoje. Como ele obtém esses dados?

Os dados de previsão estão fixos dentro do app
O app lê os dados a partir dos sensores do celular
O app chama uma API de tempo para obter os dados mais recentes
O app faz scraping de um site de meteorologia

04 · Preencher

Uma API define quais _____ o server aceita.

Outras lições deste capítulo

⚠ A experiência interativa completa precisa de JavaScript. Ative-o e recarregue a página.

※ Este é um projeto educacional independente — não é um produto oficial da Anthropic. Claude™ é uma marca registrada da Anthropic, PBC.