API e REST: descomplicando conceitos que muita gente confunde

# api# rest
API e REST: descomplicando conceitos que muita gente confundeAdelino Pereira

Após até eu confundir as vezes o conceito, e na busca de fixar em algum endereço lógico do meu disco...

Após até eu confundir as vezes o conceito, e na busca de fixar em algum endereço lógico do meu disco mental, vi em muitos fóruns e aqui na rede os devs também confundirem sobre termos fundamentais como API e REST, resolvi escrever um compilado simples e direto ao ponto sobre o assunto.

-> O que é uma API?
Abreviação muito utilizada no dia a dia do desenvolvedor, principalmente dev backend, mas nem sempre bem compreendidas. vamos explorar de forma simples, direto ao ponto para consolidar a base sobre o assunto e deixar como fonte para quem está começando.
API ou Application Programming Interface, é um conjunto de definições e protocolos que permite a integração entre diferentes sistemas, facilitando a comunicação entre eles, ela é o contrato que define como sistemas conversam entre si.
O backend expõe uma API utilizando protocolos como “RESTfull, Socket, GraphQL, gRPC, SOAP” e o frontend consome essa API utilizando as libs “Axios, cURL, etc“.

-> E o que é REST?
REST ou Representational State Transfer, não é uma tecnologia nem uma ferramenta, é um estilo arquitetural, em termos simples significa transferir o estado de um recurso em um formato representacional, como JSON ou XML.
Exemplo:
Um recurso “usuário” existe no banco de dados, a API retorna o estado atual desse recurso em JSON, e esse estado pode ser criado, lido, atualizado ou removido.
Daí vem o nome REpresentational State Transfer -> Transferência de Estado Representacional
De forma resumida:
API → é a interface que permite a comunicação entre sistemas
REST → é uma forma organizada e padronizada de estruturar essa comunicação

Entender bem esses conceitos evita confusão, melhora decisões arquiteturais e mostra maturidade técnica,mesmo em projetos simples.