Uma API é um acrônimo para Application Programming Interface. As APIs incluem várias ferramentas, protocolos e rotinas. As APIs são usadas como uma maneira de os aplicativos…

Uma API é um acrônimo para Application Programming Interface. As APIs incluem várias ferramentas, protocolos e rotinas. As APIs são usadas como uma forma de os aplicativos se comunicarem com vários sistemas.

Mas o que isso significa? Bem, deixe-me explicar o que são com alguns exemplos. Vou usar várias APIs para esses exemplos.

Vamos começar

Vamos começar olhando para um site meu favorito chamado The Yoda Speak Generator encontrado aqui .

Este site permite que os usuários insiram texto e obtenham um retorno desse mesmo texto formatado da maneira que Yoda pode dizer. Isso é feito com uma API.

Yoda Speak: Coisas divertidas, apis são! Sim, hum.

As APIs contêm o que é chamado de endpoint para acessar essa API. O endpoint fornece a conexão para se comunicar com a API e fornece algum texto para gerar no Yoda Speak. A API então retornaria o Yoda Speak gerado para o local da solicitação.

Outra maneira de pensar em uma API é pensar nela como uma caixa de ovos. Uma caixa de ovos contém os ovos, protege-os de danos e permite que alguém que queira fazer o café da manhã abra e feche a caixa para acessar os ovos dentro. Os ovos dentro seriam os dados, e a mão entrando na caixa seria muito parecida com a comunicação usando um terminal de um servidor.

Ok, vamos fazer o café da manhã… Brincadeirinha!

Para aqueles que são visuais Vejamos alguns exemplos do código. Esses trechos estão em PHP porque é minha linguagem favorita. Abaixo está um link para baixar um pequeno arquivo zip chamado apidemo.zip.

Link de Demonstração

Você pode hospedar esse diretório em seu host local ou em um site, se desejar.

Depois de extrair o zip e ter um diretório como localhost/apidemo, abra um navegador e digite http://localhost/apidemo/api.php?request=example&name=yourname onde localhost é seu domínio.

Para inserir esse endpoint em um aplicativo que faz chamadas de API, tente Postman. Aqui está um link para uma extensão do Chrome.

Tente usar um método GET e POST com parâmetros request=example para a função de exemplo em api.php e name=yourname para gerar um nome

Agora você deve ver a saída “Your name is yourname” no seu navegador

explore os arquivos api.php, API.class.php e MyAPI.php para explorar como essa API simples recebe os parâmetros e gera um nome

Espero ter explicado as APIs para que você tenha uma compreensão básica do que são. Existem muitos tipos de APIs, uma que você pode ver com frequência é a API RESTful, essas, ao contrário deste exemplo, devem obedecer às restrições definidas pela arquitetura REST.