Analogia para entender o conceito de API

Mas o que são APIs, afinal?

API é o acrônimo de Application Programming Interface, basicamente, trata-se de um conjunto de rotinas que processa respostas seguindo padrões estabelecidos por um software ou web service.

Um bom exemplo do nosso cotidiano sobre API seria compará-la com um garçom!

Vamos usar como exemplo um Web Service.

Quando você entrar no Restaurante (Host), na verdade você está acessando um local para ser atendido com um determinado serviço. No caso, a sua expectativa de serviço é acabar com a sua fome em um restaurante. Mas no mundo das APIs, poderia estar querendo comprar um ingresso em um e-commerce online de ingressos, por exemplo.

Ao entrar no restaurante, o consumidor (site ou mobile), após conferir o cardápio e decidir o que vai querer comer, vai efetuar seu pedido para o Garçom (API). Em seguida, o Garçom vai até a cozinha (servidor) solicitar o pedido do Consumidor. Dependendo do gerenciamento da comunicação do pedido, estrutura da Cozinha, agilidade dos Cozinheiros, o tempo para obter a Entrega do Pedido, no caso o Prato (Resposta) será rápido.

Também podemos adotar o cliente Delivery (Embarcado), no qual também poderá consumir os dados da nossa Cozinha através da mesma API.