O que é uma API? A conexão que você usa sem perceber.

Uma API é um conjunto de regras e recursos que permite a um programa interagir com outro. A sigla vem de Application Programming Interface, ou interface de programação de aplicações.

Pense em um pedido no restaurante

Você escolhe um prato. O atendente leva o pedido à cozinha e traz uma resposta. Você não precisa entrar na cozinha para receber o resultado. Essa é uma analogia útil para entender uma API: uma forma organizada de solicitar algo e receber uma resposta.

Onde ela aparece no dia a dia?

Uma integração pode consultar um endereço, obter uma previsão do tempo ou compartilhar informações entre sistemas. O que pode ser consultado ou alterado depende das regras que cada serviço oferece.

Exemplo ilustrativo: uma loja consulta um serviço de mapas para calcular a distância até um endereço. O serviço recebe a solicitação e devolve o resultado. O exemplo explica a ideia; não representa uma integração específica dos nossos produtos.

API é a mesma coisa que um aplicativo?

Não. O aplicativo é a ferramenta com a qual você interage. A API é uma interface que o software pode usar para conversar com outros recursos.

O que perguntar antes de integrar?

• Que informação será compartilhada?
• A integração pode apenas consultar ou também modificar dados?
• Quem controla o acesso?
• O que acontece se o serviço ficar indisponível?

Você não precisa conhecer código para fazer essas perguntas. Entender o objetivo e as permissões já ajuda a participar de uma conversa técnica.

Para guardar: uma API organiza a interação entre softwares. Ela facilita conexões, mas cada conexão precisa ter um propósito claro.