O que é uma API? Pense nela como um pub a encomendar cerveja.

Não tem a certeza do que uma API realmente faz?

Este YouTube Short de 45 segundos explica-o com uma analogia de pub

APIs são como os acordos entre pubs e os seus fornecedores.

O seu pub precisa de cerveja. A cervejaria faz cerveja. Ambos concordam sobre como os pedidos são feitos, as entregas são realizadas e os pagamentos são processados.

Uma boa API é como…

Ter um fornecedor que se lembra exatamente do que pediu da última vez, sabe o que precisa de lhe trazer desta vez, a tempo, sempre, e lhe envia uma fatura simples.

Tudo funciona suavemente, com o mínimo esforço requerido da sua parte.

APIs ruins? Elas são como fornecedores não confiáveis. Talvez lhe tragam vinho em vez de cerveja, mesmo que não tenha pedido. Ou aparecem às 3 da manhã, quando está a dormir. Ou mudam subitamente os seus termos de pagamento sem o informar.

Criam mais problemas do que resolvem.

Quer uma API que se comporte como um ótimo fornecedor? Comece com a Firma, sem necessidade de cartão de crédito