Uma API permite que sistemas diferentes comuniquem e partilhem dados. Fica a saber o que é uma API, como os websites a usam e porque importa.
Preenches um formulário num website e, uns segundos depois, recebes um email de confirmação. Consultas o tempo num site e ele mostra-te dados em direto da tua cidade. Fazes um pagamento online e a transação conclui-se sem saíres da página. Tudo isto acontece porque há APIs a trabalhar em segundo plano.
O significado de API é simples: vem de Application Programming Interface (interface de programação de aplicações). Se tens aprendido sobre desenvolvimento frontend e backend, já sabes que os dois lados de um website precisam de comunicar. As APIs são a forma como essa comunicação acontece, e vão além do teu próprio website.
O que é uma API?
Uma API é um conjunto de regras que permite a um sistema enviar um pedido a outro sistema e receber uma resposta. Pensa num empregado de mesa num restaurante. Tu (o frontend) dizes ao empregado o que queres. O empregado leva o teu pedido à cozinha (o backend ou outro serviço), e a cozinha devolve exatamente o que pediste. O empregado é a API. Nunca entras tu próprio na cozinha.
Em termos de website, um pedido de API é o que se envia quando um sistema pede dados a outro ou lhe diz para fazer algo. O outro sistema processa o pedido e devolve uma resposta. Tudo isto acontece em segundo plano, normalmente em menos de um segundo.
Como funcionam as APIs nos websites?
De cada vez que o teu website precisa de falar com outro sistema, usa uma API. Aqui ficam alguns exemplos comuns de como as APIs funcionam na prática.
1. Carregar conteúdo de outra fonte
O teu website pode puxar dados em direto de um serviço externo, como previsões do tempo, taxas de câmbio ou custos de envio. O website envia um pedido de API a esse serviço e o serviço devolve os dados. O teu site mostra-os ao visitante, sem o visitante saber que os dados vieram de outro lado.
2. Processar pagamentos
Quando alguém paga algo no teu website, o pagamento não acontece mesmo no teu site. O teu website envia os dados do pagamento, através de uma API, para um processador de pagamentos. O processador trata da transação em segurança e devolve uma confirmação pela mesma API. É um exemplo claro de API de como dois sistemas trabalham juntos através de uma ligação partilhada.
3. Enviar emails e notificações
Os formulários de contacto, as confirmações de encomenda e os emails de registo costumam ser enviados através de uma API que liga o teu website a um serviço de envio de emails. O teu site diz ao serviço o que enviar e a quem, e o serviço trata da entrega.
4. Ligar a outras plataformas
A integração por API é o que permite ao teu website ligar-se a outras ferramentas e serviços. A tua análise, o teu sistema de marcações, a tua lista de emails e o teu processamento de pagamentos podem ligar-se ao teu website através de APIs. Cada integração usa um endpoint de API, que é um endereço específico para onde o teu website envia pedidos e de onde recebe respostas.
5. Dar força à pesquisa e à filtragem
Quando pesquisas algo num website, a barra de pesquisa envia a tua consulta, através de uma API, à base de dados. A base de dados encontra os resultados correspondentes e devolve-os pela API para a página os mostrar. É assim que os resultados de pesquisa aparecem de imediato, sem recarregar a página toda.
Porque importam as APIs para o teu website?
As APIs deixam o teu website fazer coisas que nunca conseguiria sozinho. Sem APIs, o teu website seria um sistema fechado. Poderia mostrar conteúdo e aceitar cliques, mas não poderia processar pagamentos, enviar emails, puxar dados em direto nem ligar-se a qualquer serviço externo. As APIs tornam os websites modernos funcionais, muito além de mostrar páginas.
Também mantêm o teu website mais leve. Em vez de construíres cada funcionalidade de raiz no teu próprio sistema, ligas-te a serviços que já a fazem bem. O teu website fica focado na experiência e o trabalho pesado acontece por ligações de API em segundo plano. Se usas um CMS ou um criador de websites, muitas destas ligações de API já estão configuradas por ti. Ficas com a funcionalidade sem teres de criar ou gerir as integrações.
Perguntas frequentes
Preciso de saber de APIs para criar um website?
Não, se usares um criador de websites. A plataforma trata das ligações de API nos bastidores. Ficas com funcionalidades como formulários, pagamentos, email e análise sem mexer em código de API. O criador de websites da WEMASY traz integrações incluídas, para te concentrares no teu conteúdo e na tua marca enquanto as ligações técnicas funcionam sozinhas.
O que é uma chave de API e para que serve?
Uma chave de API é um código único que identifica o teu website quando se liga a outro serviço. Funciona como uma palavra-passe que diz ao outro sistema quem está a fazer o pedido e se tem permissão. Sem uma chave de API válida, o serviço rejeita o pedido. A maioria das plataformas gera chaves de API automaticamente quando configuras uma integração.
As APIs podem ligar websites diferentes entre si?
Sim. As APIs são a forma padrão de sistemas diferentes partilharem dados. Um website pode puxar conteúdo de outro, enviar dados a um serviço de terceiros ou sincronizar informação entre várias plataformas. É assim que funcionam as integrações entre websites, aplicações e ferramentas. Lê mais sobre como o frontend e o backend usam APIs para comunicar.
As APIs são só para programadores?
A configuração técnica de uma API costuma ser feita por programadores, mas não precisas de ser um para beneficiar delas. De cada vez que usas um formulário, fazes um pagamento ou vês dados em direto num website, há uma API a fazer o trabalho. Se usas um sistema como a WEMASY, as APIs já estão ligadas por ti através dos modelos e das funcionalidades incluídas.
O que acontece quando uma API deixa de funcionar?
A funcionalidade que depende dela também deixa de funcionar. Se a API de pagamentos falhar, os visitantes não conseguem concluir compras. Se a API de email falhar, os emails de confirmação deixam de ser enviados. É por isso que fornecedores de API fiáveis e um bom tratamento de erros importam. Um website bem feito mostra uma mensagem útil quando algo falha, em vez de avariar por completo.
Como é que as APIs afetam a velocidade do website?
Cada chamada de API acrescenta um pouco de tempo ao carregamento da página, porque o website tem de esperar que o serviço externo responda. Se uma página faz demasiadas chamadas de API ou se o serviço externo é lento, a tua página parece pesada. A boa prática é manter as chamadas de API ao mínimo e usar cache para guardar as respostas da API, para os mesmos dados não serem pedidos de cada vez.