API REST é um dos termos que mais aparece cedo na jornada de quem está aprendendo a programar, geralmente explicado de um jeito mais complicado do que precisa ser. No fundo, é um conceito bem simples: um jeito padronizado de dois sistemas conversarem pela internet.
O que é uma API, de forma simples
API é só uma forma de um programa pedir informação ou ação a outro programa, sem precisar saber como esse outro programa funciona por dentro — só precisa saber o que pedir e o que esperar de volta.
E o que o 'REST' adiciona nisso
REST é um conjunto de convenções sobre como organizar esses pedidos — usando endereços (URLs) que representam recursos, e verbos que dizem o que fazer com eles.
Os verbos mais comuns numa API REST
- GET — buscar uma informação
- POST — criar algo novo
- PUT ou PATCH — atualizar algo que já existe
- DELETE — remover algo
Um exemplo prático pra fixar
Imagine um app de tarefas. Buscar a lista de tarefas seria um GET em '/tarefas'. Criar uma tarefa nova seria um POST no mesmo endereço. Apagar uma tarefa específica seria um DELETE em '/tarefas/123', onde 123 é o identificador daquela tarefa.
Erros comuns de quem está aprendendo isso
- Achar que precisa entender tudo de uma vez antes de usar na prática
- Confundir o verbo HTTP com a linguagem de programação usada
- Não testar a API com uma ferramenta simples antes de integrar no código