Como funciona uma API? Entenda de uma vez por todas

Você já pediu um carro por aplicativo, consultou a previsão do tempo ou fez uma compra pela internet?

Então, provavelmente, você já usou uma API sem perceber.

Mas o que é uma API? E como ela consegue fazer diferentes sistemas conversarem?

Calma! Você não precisa ser programador para entender esse conceito. Na verdade, podemos explicar uma API de uma maneira bem simples.

Para começar, imagine que você está em um restaurante.

Você olha o cardápio e escolhe um prato. Em seguida, chama o garçom e faz o pedido. O garçom leva sua solicitação até a cozinha. Depois, ele retorna com o prato.

Você não precisa entrar na cozinha. Além disso, não precisa saber como o cozinheiro preparou a comida.

Uma API funciona de maneira parecida.

Ela faz a ponte entre dois sistemas que precisam trocar informações. Por isso, podemos imaginar a API como um garçom digital.

O que significa API?

API significa Application Programming Interface. Em português, podemos traduzir como Interface de Programação de Aplicações.

O nome parece complicado. Entretanto, a ideia é simples.

Uma API é uma espécie de intermediária que permite que sistemas diferentes troquem informações.

Por exemplo, imagine um aplicativo de previsão do tempo.

O aplicativo precisa descobrir a temperatura de Brasília. Porém, ele pode não possuir essa informação dentro dele.

Nesse caso, o aplicativo pergunta para outro sistema:

“Qual é a temperatura atual em Brasília?”

Essa pergunta passa pela API.

Em seguida, o serviço de previsão do tempo processa a solicitação. Depois, devolve a resposta para a aplicação.

O aplicativo recebe o resultado e mostra a informação na tela.

Assim, algo que parece simples para o usuário pode envolver vários sistemas trabalhando juntos.

Como uma API funciona?

Agora podemos olhar para o funcionamento técnico.

Primeiramente, uma aplicação envia uma requisição, também chamada de request.

Essa requisição informa para a API o que a aplicação deseja fazer.

Em seguida, a API recebe a solicitação e verifica o pedido.

Depois disso, o servidor executa a operação necessária.

Por fim, a API devolve uma resposta, conhecida como response.

O processo pode ser representado assim:

Aplicativo
     ↓
Requisição
     ↓
API
     ↓
Servidor
     ↓
Processamento
     ↓
Resposta
     ↓
API
     ↓
Aplicativo

Ou seja, a API funciona como uma intermediária durante essa conversa entre sistemas.

O que é uma requisição de API?

A requisição, ou request, é o pedido enviado para a API.

Por exemplo, imagine que você tenha um aplicativo de loja.

Você quer descobrir o preço de determinado produto. Então, o aplicativo pode enviar uma solicitação como:

GET /produtos/123

Traduzindo para uma linguagem mais humana:

“API, quero as informações do produto 123.”

A API recebe o pedido. Em seguida, procura as informações necessárias.

Depois, ela devolve uma resposta para o aplicativo.

Portanto, uma requisição representa aquilo que a aplicação está pedindo.

O que é uma resposta?

A resposta, ou response, é o resultado enviado pela API.

Por exemplo, a API poderia retornar:

{
  "id": 123,
  "produto": "Notebook",
  "preco": 3500
}

Não se assuste com esse formato.

Na prática, isso é apenas uma maneira organizada de transportar informações.

Nesse exemplo, a API está dizendo:

O produto 123 é um notebook e custa R$ 3.500.

Assim, o aplicativo consegue interpretar os dados e apresentar as informações de uma maneira mais amigável.

O que é JSON?

Você provavelmente encontrará a palavra JSON quando começar a estudar APIs.

JSON significa JavaScript Object Notation.

Apesar do nome, ele não pertence exclusivamente ao JavaScript. Atualmente, diversas linguagens conseguem trabalhar com esse formato.

O objetivo é simples: organizar informações para facilitar a comunicação entre sistemas.

Por exemplo:

{
  "nome": "Maria",
  "idade": 30,
  "cidade": "Brasília"
}

Para uma pessoa, esse formato já é relativamente fácil de entender.

Da mesma forma, um computador consegue interpretar essa estrutura com facilidade.

Por isso, JSON se tornou muito comum nas APIs modernas.

O que são GET, POST, PUT e DELETE?

Agora chegamos a uma parte um pouco mais técnica.

Contudo, não precisa complicar.

Os métodos HTTP indicam qual operação a aplicação deseja realizar.

GET: quero consultar

O método GET normalmente serve para buscar informações.

Por exemplo:

GET /produtos

Isso poderia significar:

“Quero consultar os produtos.”

Assim, o servidor pode devolver uma lista com os produtos disponíveis.

POST: quero criar

O método POST normalmente serve para enviar informações e criar um novo recurso.

Por exemplo:

POST /usuarios

Nesse caso, a aplicação poderia enviar os dados necessários para criar um novo usuário.

PUT: quero atualizar

O método PUT normalmente é utilizado para atualizar um recurso existente.

Por exemplo, imagine que um usuário mudou de cidade.

Nesse caso, a aplicação pode enviar uma solicitação para atualizar o cadastro.

DELETE: quero excluir

O método DELETE normalmente serve para excluir um recurso.

Por exemplo:

DELETE /usuarios/123

Nesse caso, a aplicação está solicitando a exclusão do usuário 123.

Portanto, podemos resumir:

Método	Função
GET	Consultar
POST	Criar
PUT	Atualizar
DELETE	Excluir

O que é um endpoint?

Outro termo muito comum quando falamos de APIs é endpoint.

De forma simples, podemos imaginar um endpoint como uma porta de entrada para determinado recurso da API.

Imagine um prédio.

Uma porta pode levar para a recepção. Outra, para o estacionamento. Enquanto isso, uma terceira pode levar para os apartamentos.

Uma API pode funcionar de maneira semelhante.

Por exemplo, ela poderia disponibilizar:

/usuarios
/produtos
/pedidos
/clientes

Cada caminho representa um recurso ou uma operação.

Assim, a aplicação sabe onde deve fazer cada solicitação.

Uma API acessa um banco de dados?

Sim. Entretanto, API e banco de dados são coisas diferentes.

O banco de dados armazena e organiza informações.

Já a API cria uma interface para que aplicações possam acessar determinados recursos.

Imagine novamente um restaurante.

O banco de dados seria como o estoque e os registros internos da cozinha.

A API seria o garçom.

Dessa forma, o aplicativo faz um pedido para a API. Em seguida, o servidor pode consultar o banco de dados.

O fluxo pode ser:

Aplicativo
    ↓
   API
    ↓
Servidor
    ↓
Banco de dados

Depois, o caminho acontece no sentido contrário.

O banco retorna os dados. Então, o servidor processa as informações. Por fim, a API devolve a resposta ao aplicativo.

Por que não acessar o banco diretamente?

Imagine que você criou um aplicativo para uma loja.

O banco de dados possui informações sobre clientes, pedidos, endereços, pagamentos, produtos e estoque.

Você provavelmente não quer entregar a chave do banco para qualquer aplicativo.

Seria como entregar a chave do estoque para todos os clientes.

A API ajuda justamente nesse controle.

Por meio dela, o sistema pode determinar quais informações podem ser consultadas ou alteradas.

Além disso, a API pode verificar quem está fazendo cada solicitação.

Consequentemente, fica mais fácil controlar o acesso aos dados.

Uma API precisa de senha?

Nem sempre.

Porém, muitas APIs precisam identificar quem está fazendo uma requisição.

Para isso, elas podem utilizar diferentes mecanismos de autenticação.

Um exemplo conhecido é a API Key.

Imagine que uma empresa forneça uma API para seus clientes.

Cada cliente recebe uma chave. Quando fizer uma solicitação, a aplicação apresenta essa chave.

A API consegue então identificar o cliente.

Existem também mecanismos mais sofisticados, como tokens e OAuth.

Em resumo, a autenticação ajuda a API a saber quem está fazendo o pedido.

Uma API é segura?

Uma API pode ser bastante segura.

Contudo, isso depende de como os desenvolvedores construíram e configuraram o sistema.

Uma API bem protegida pode utilizar:

• HTTPS;
• autenticação;
• autorização;
• controle de acesso;
• validação de dados;
• limite de requisições;
• monitoramento.

Além disso, os desenvolvedores precisam proteger informações sensíveis.

Uma API mal configurada pode acabar expondo dados que deveriam permanecer protegidos.

Por isso, segurança deve fazer parte do desenvolvimento desde o início.

APIs também são usadas em inteligência artificial

As APIs ganharam ainda mais importância com o crescimento da inteligência artificial.

Por exemplo, imagine que uma empresa possui um aplicativo próprio.

Ela quer adicionar um recurso de inteligência artificial. Em vez de desenvolver todo o sistema internamente, a empresa pode utilizar uma API disponibilizada por um serviço especializado.

O aplicativo envia uma pergunta.

Em seguida, a API recebe a solicitação e encaminha o pedido para o modelo de inteligência artificial.

Depois, o resultado retorna para o aplicativo.

O processo pode ser representado assim:

Usuário
   ↓
Aplicativo
   ↓
API
   ↓
Modelo de IA
   ↓
Resposta
   ↓
Aplicativo

Assim, uma aplicação consegue incorporar recursos de inteligência artificial sem necessariamente desenvolver todo o modelo por conta própria.

Vamos colocar tudo em um exemplo?

Agora imagine um aplicativo de delivery.

Você abre o aplicativo e procura por uma pizza.

O aplicativo precisa mostrar os restaurantes disponíveis.

Para isso, ele pode fazer uma solicitação:

GET /restaurantes?categoria=pizza

A API recebe a solicitação.

Em seguida, o servidor consulta os dados necessários.

A API pode retornar:

{
  "restaurantes": [
    {
      "nome": "Pizza Express",
      "tempo_entrega": 35
    },
    {
      "nome": "Pizzaria Central",
      "tempo_entrega": 45
    }
  ]
}

O aplicativo interpreta esses dados.

Por fim, você vê os restaurantes e o tempo estimado de entrega na tela.

Você provavelmente nem percebeu toda essa comunicação.

E esse é justamente o ponto.

A API trabalha nos bastidores para fazer diferentes sistemas funcionarem juntos.

API é como uma linguagem comum

Imagine que dois países possuem idiomas diferentes.

Uma pessoa fala português.

A outra fala japonês.

Nesse caso, elas precisam de algum mecanismo que permita a comunicação.

Uma API exerce um papel parecido entre sistemas.

Um aplicativo pode ter sido desenvolvido em Python.

Outro sistema pode utilizar Java.

Um terceiro pode utilizar JavaScript.

Mesmo assim, todos podem se comunicar por meio de uma API.

Isso acontece porque eles seguem regras e formatos definidos para essa comunicação.

Ou seja, a API funciona como uma espécie de linguagem comum entre diferentes aplicações.

Por que as APIs são tão importantes?

Hoje, poucos sistemas modernos funcionam completamente isolados.

Aplicativos precisam conversar com outros serviços.

Sites precisam consultar bancos de dados.

Empresas precisam integrar sistemas.

Aplicativos precisam processar pagamentos.

Serviços precisam trocar informações.

Além disso, a inteligência artificial trouxe ainda mais possibilidades de integração.

Nesse cenário, as APIs funcionam como pontes entre diferentes tecnologias.

Elas ajudam os desenvolvedores a reutilizar serviços e criar aplicações mais completas.

Por isso, entender APIs é importante para quem deseja conhecer melhor desenvolvimento de sistemas, aplicativos, automações, dados e inteligência artificial.

Afinal, o que você precisa guardar?

Se você chegou até aqui, não precisa decorar todos os termos técnicos.

O mais importante é entender este conceito:

Uma API permite que um sistema peça informações ou serviços para outro sistema.

Imagine novamente o restaurante.

Você faz o pedido.

Em seguida, o garçom leva o pedido até a cozinha.

A cozinha prepara.

Depois, o garçom traz o resultado.

Na tecnologia, a API exerce esse papel de intermediária.

O aplicativo faz uma requisição. Então, a API encaminha o pedido.

O servidor processa.

Por fim, a API devolve a resposta.

Tudo isso acontece em uma velocidade que muitas vezes parece instantânea.

Conclusão

API pode parecer um termo complicado no começo.

Entretanto, seu conceito é relativamente simples.

Ela funciona como uma ponte que permite a comunicação entre diferentes sistemas.

Além disso, APIs ajudam a controlar o acesso aos dados e serviços.

Elas estão presentes em aplicativos, sites, bancos, plataformas de pagamento, redes sociais e ferramentas de inteligência artificial.

Portanto, quando você ouvir alguém falando sobre API, pense em uma coisa:

API é uma forma organizada de fazer sistemas conversarem.

E agora você já sabe um pouco do que acontece nos bastidores quando seu aplicativo pede alguma coisa para outro sistema.