API (Interface de Programação de Aplicações)

API (Application Programming Interface) é uma interface de programação de aplicações, ou seja, uma descrição dos métodos de interação entre programas, definindo como eles podem se comunicar e trocar dados entre si. A API simplifica a criação de código, pois fornece um conjunto de classes, funções ou estruturas prontas para serem utilizadas em conjunto com os dados existentes.

Esse conceito não se aplica apenas ao desenvolvimento web, mas também a diversos produtos de software em geral. Controles de videogame, geladeiras, TVs e alto-falantes – todos possuem sua própria API.

Do que é composta uma API?

A API é composta por duas partes principais:

• Interface de interação;
• Descrição.

A interface pode ser uma janela visual sustentada por um texto explicativo, enquanto a descrição responde à pergunta "como essa interface funciona?".

API da Serverspace

Vamos analisar o conceito de API sob outra perspectiva, utilizando a nossa empresa como exemplo:

A API da Serverspace é uma interface que permite obter informações do banco de dados do site "serverspace.ru" por meio de requisições HTTP a um servidor específico. Você não precisa conhecer em detalhes qual banco de dados é utilizado nem como ele é implementado – basta saber que a API lida com essas informações para você.

Exemplo de interação cliente-servidor

Suponha que a nossa empresa Serverspace tenha uma API que oferece determinadas funções às quais os clientes podem enviar requisições e obter respostas. Imagine que a API "serverspace.ru" tenha uma função chamada "retornar lista de serviços da empresa". Nesse caso, o navegador faria uma requisição à API da empresa para obter essa lista, receberia os dados e os renderizaria na página do navegador.

É importante notar que as interfaces de API são limitadas: você só terá acesso às funções que foram disponibilizadas pelos desenvolvedores. Para adicionar uma nova funcionalidade, um programador precisa desenvolvê-la previamente.

A interação não ocorre apenas entre cliente e servidor, mas também entre servidores.

Exemplo de interação servidor-servidor

Imagine que você deseja comprar uma passagem de trem. Você acessa um site de vendas, escolhe a cidade de destino e, além das opções de datas e horários dos trens, o site exibe a previsão do tempo para aquele local.

Isso não significa que a empresa de venda de passagens possui sensores meteorológicos ao redor do mundo. O site das passagens se comunica com um serviço de previsão do tempo utilizando a API desse serviço para obter os dados meteorológicos em tempo real.