Básico
O que é uma API REST na prática?
Entenda como cliente e servidor trocam dados estruturados em JSON usando URLs e métodos HTTP.
Por que usamos APIs?
Uma API (Application Programming Interface) funciona como uma ponte de comunicação entre dois sistemas. Quando o seu front-end (ou outro back-end) precisa buscar ou enviar dados sem acessar diretamente o banco de dados de outro serviço, ele faz uma requisição para um endpoint da API.
Em APIs REST, seguimos três ideias simples:
- Cada recurso tem uma URL clara (ex.:
https://pokeapi.co/api/v2/pokemon/pikachuou/api/projetos/12). - O método HTTP indica a intenção (
GET,POST,PUT,PATCH,DELETE). - Os dados normalmente trafegam em formato JSON, leve e fácil de ler tanto em JavaScript quanto em PHP.
Dica para trainees
Antes de escrever código no front-end ou no Laravel, abra uma API pública no navegador ou teste o endpoint no Insomnia, Postman ou HTTPie para conferir o JSON retornado. Você pode testar agora mesmo fazendo um GET em https://pokeapi.co/api/v2/pokemon/pikachu.
Exemplo Prático
json
{
"id": 25,
"name": "pikachu",
"height": 4,
"weight": 60,
"types": [
{
"slot": 1,
"type": {
"name": "electric"
}
}
]
}