O que é uma API? [Leitura Rápida]

Se você não é um desenvolvedor, mas trabalha com tecnologia, o termo API provavelmente é algo que você entende no sentido de conversação. Você provavelmente sabe o que significa (interface de programação de aplicativos) e talvez suas equipes usem APIs para fazer seu trabalho – ou talvez seja até o próprio produto (Twilio SendGrid, por exemplo).

Mas o que exatamente é uma API e como elas funcionam?

Compreender os princípios mais profundos por trás das APIs ajudará você a comercializar, vender ou usar melhor essas tecnologias.

Esta postagem explica como as APIs funcionam, como os desenvolvedores as criam e como usá-las (com exemplos do mundo real).

Como funcionam as APIs?

Como os navegadores da Web interagem com os servidores é um princípio fundamental das APIs. A web é uma coleção de servidores remotos dispersos por todo o planeta. Quando você abre um navegador e digita um site, o navegador está fazendo uma chamada para o servidor do cliente (qualquer aplicativo ou servidor em que um site esteja hospedado) para buscar e exibir o que estiver nesse URL.

Embora uma API não seja o servidor em si, é a parte do servidor, conhecida como endpoint, que envia e recebe determinadas respostas. As APIs são uma maneira de diferentes softwares se comunicarem (também conhecido como envio e recebimento) entre si abrindo terminais.

Os desenvolvedores configuram chamadas de API para recuperar dados específicos necessários para várias finalidades ao criar aplicativos ou sites. Por exemplo:

• Você acabou de abrir seu aplicativo do Instagram? Isso foi possível por uma chamada de API.
• Você já adicionou um evento ao seu Google Agenda de outro site ou e-mail? Esse site estava aproveitando a API do Google Calendar para obter essas informações específicas do servidor do Google Calendar.

Conclusão: os desenvolvedores configuram chamadas de API para recuperar tipos de dados específicos para exibir o que eles precisam quando um usuário está em um site ou executando um aplicativo.

A ascensão do descanso

Outro termo que você provavelmente já ouviu é API REST. Não é diferente da definição tradicional de uma API. Ainda vale a pena entender por que as APIs REST se tornaram tão populares e o que distingue as APIs REST de outras.

No início, as APIs foram construídas para atender aos requisitos do SOAP (Simple Object Access Protocol). Mas esse método era um pouco tedioso e exigia muita largura de banda para transferir conjuntos de dados. Também exigiu muita energia do desenvolvedor (não do tipo divertido). SOAP usa a linguagem de marcação XML notoriamente pesada para exibir dados. Útil para garantir a compatibilidade universal, mas é só isso.

Os desenvolvedores estavam procurando maneiras mais leves e flexíveis de fazer chamadas de API. As APIs REST (transferência de estado representacional) fornecem uma solução alternativa à API SOAP. Eles não são limitados por um protocolo específico, embora devam atender a certos estilos arquitetônicos (se você estiver interessado em mergulhar nisso, vá até aqui).

Em vez de ser exibido com marcação XML, o servidor usa a linguagem JSON leve (apenas arquivos de texto). As APIs REST são muito mais leves em largura de banda do que SOAP—geralmente são apenas uma URL—e são naturalmente otimizadas para comunicação na web.

Dica: pense nas APIs REST como a Marie Kondo dos dados. Eles pegam e usam apenas *precisamente* o que precisam. APIs SOAP são como a garagem do seu vizinho que está cheia de papel higiênico.

Entendendo os diferentes tipos de APIs

Independentemente do protocolo ou estilo que uma API segue, existem vários tipos de APIs, incluindo:

• APIs abertas – também conhecidas como APIs públicas, esses endpoints são acessíveis por qualquer desenvolvedor e normalmente não impõem restrições ao usuário. Normalmente aceitam doações.
• APIs de parceiros – São APIs projetadas para serem usadas em conjunto e normalmente só podem ser acessadas por algum tipo de mercado.
• APIs internas – são ferramentas internas que as empresas usam para ajudar seus funcionários a serem mais eficientes ou fornecer uma maneira mais segura para os funcionários compartilharem dados/informações.
• APIs compostas – APIs compostas são uma maneira de consolidar chamadas de APIs relacionadas, mas que normalmente exigiriam chamadas de API individuais.

Exemplos reais de APIs

Existem muitas APIs disponíveis (algumas contam mais de 15.000) que ajudam os usuários a acessar diversos aplicativos. Abaixo estão alguns notáveis ​​que ajudarão você a entender o escopo do ecossistema da API.

O Coquetel DB

Digamos que você possui uma loja de bebidas local e deseja fornecer receitas de coquetéis em seu site. Você pode considerar usar a API Cocktail DB acima. Todos esses dados (as receitas de coquetéis) já existem no servidor de outra pessoa e podem ser avaliados por meio da API.

Quando um usuário clica nas receitas de margarita (indiscutivelmente o coquetel superior), seus servidores descobrem que a receita específica a envia em JSON, é captada no site e analisada em HTML e CSS para ser apresentável no navegador do site.

OpenWeatherMap

Adicionar uma seção de clima ao seu site é um caso de uso super comum. Pense em qualquer estação de esqui, lojas de bicicletas ou empresa de turismo. A API OpenWeatherMap armazena todas as previsões e informações meteorológicas e exibe apenas a parte que você está solicitando.

Essa API fornece versões gratuitas e premium, dependendo da quantidade de dados que você deseja exibir.

API de e-mail SendGrid

A API de email do SendGrid aproveita o SMTP (protocolo de transferência de correio simples) para permitir que os clientes enviem grandes quantidades de emails transacionais e acionados – pense em redefinições de senha, confirmação de conta e notificações de envio.

Twilio SMS

A API de SMS do Twilio é outra API REST que fornece uma maneira de adicionar recursos de mensagens aos aplicativos. As mensagens SMS tornaram-se cada vez mais populares como forma de as marcas se comunicarem com os clientes porque são pessoais, em tempo real, e essas mensagens são lidas a taxas muito mais altas.

Como usar uma API

Antes de você ou sua equipe começarem a usar APIs, é importante saber se elas são abertas, usadas em conjunto com um serviço de parceiro ou compostas.

Como começar com uma API

Leia a documentação. Qualquer API deve ter a documentação aplicável para você seguir. Ele lhe dirá quais dependências você tem, que tipo de API é e como usá-la. Uma documentação ruim deve ser uma bandeira vermelha para você e seu desenvolvedor. Estamos muito orgulhosos da excelente documentação do Twilio e do SendGrid.

Gere uma chave de API. Você precisará gerar uma chave de API para começar a usá-la. Aqui estão as instruções da API do Google Maps:

Observação : nunca compartilhe chaves de API e certifique-se de que elas não estejam visíveis em nenhum código público que você colocar no GitHub.

Comece a construir: envie e-mail gratuitamente com a API SendGrid Email

O resto é com você! As oportunidades são realmente infinitas quando você trabalha com APIs. Para ver todas as oportunidades de trabalhar com a API do Twilio, confira o Twilio Code Exchange.

Se você estiver interessado em usar a API de e-mail do SendGrid para enviar e-mails gratuitos, confira aqui.