O Que É Uma API?
Hoje li um artigo e achei interessante falar sobre este assunto aqui e basicamente a ideia é desmistificar um pouco sobre O Que É Uma API?
No geral, as APIs trazem a característica de abstrair o acesso a um sistema ou uma funcionalidade.
Existem conceitos que serão importantes entender para compreender o que é uma API, continue lendo o artigo para entender melhor estes pontos e não deixe de interagir comentando o que você sabe sobre este excelente assunto.
API Especificada
De acordo com o Trailhead da Salesforce em Definir Uma Especificação de API para Um Serviço Externo:
Sua especificação da API contém uma definição de esquema que descreve os tipos de entradas e saídas que você pode incluir nas chamadas, ou solicitações, que sua organização faz ao serviço Web externo. Por exemplo, suas chamadas podem incluir uma ID como entrada numérica ou um nome como saída de texto.
De acordo com a RedHat em O Que São Application Programming Interfaces:
As APIs funcionam como se fossem contratos, com documentações que representam um acordo entre as partes interessadas. Se uma dessas partes enviar uma solicitação remota estruturada de uma forma específica, isso determinará como a aplicação da outra parte responderá.
Em resumo, é possível dizer que é a documentação do projeto.
API Implementada
De acordo com o artigo [Sydle O que é API? Exemplos, benefícios, e tipos] podemos dizer que API implementada é:
Um conjunto de funções e procedimentos que permitem a integração de sistemas, permitindo a reutilização das suas funcionalidades por outras aplicações ou software. Uma API é utilizada para trocar dados entre diferentes tipos de software a fim de automatizar procedimentos e desenvolver novas funcionalidades. Uma API é uma espécie de ponte que liga diferentes tipos de software ou aplicações e pode ser criada em várias linguagens de programação.
Em resumo, é possível dizer que é a implementação do projeto.
Definições Públicas Sobre API
De acordo com Sabrina Hocket da Mulesoft (autora do artigo que li What Is An API no Medium):
"An API is often compared to a building block or bridge that enables companies to create seamless customer experiences. What an API actually is, is a mechanism that makes a request using data inputs and operations you define, and then gets a response and sends data back to you. All in all, an API connects systems and data and enables users to have more seamless applications."
De acordo com o Dicionário Oxford, uma API é:
É a sigla de "Application Programming Interface" e é um conjunto de funções e procedimentos que permitem a criação de aplicações que acessam os recursos ou dados de um sistema operacional, aplicação, ou outro serviço.
Minha Definição de API
Eu defino a API especificada como tudo o que preciso para lidar com o garçom em um restaurante e a API implementada cumpre o que está na API especificada e que em sua funcionalidade interna, conecta a cozinha, o caixa e o cliente.
Também pesquisando sobre o significado da palavra API para escrever este artigo, vi uma coisa bem bacana... De acordo com o dicionário priberam, api vem do latim (latim apis, -is, abelha) que traz a noção de abelha (ex.: apicultura).
E praticamente APIs são realmente semelhantes a abelhas! Imagine uma abelha indo buscar pólem, polinizar uma flor, interagir com outra abelha e lidar com sua colmeia... além disso cada tipo de abelha tem seu comportamento e a maneira de lidar com elas catalogados, por exemplo neste catálogo de Abelhas no Brasil.
Recomendações
- Fundada em 2005, a Programmable Web vem como a principal fonte mundial de notícias e informações sobre APIs na Internet, o ProgrammableWeb.com é conhecido como o jornal de fato da economia de APIs da Web >> Programmable Web
- Uma lista coletiva de APIs gratuitas para uso em software e desenvolvimento web >> Github Public APIs
- Se você deseja entender um pouco melhor sobre APIs através de perguntas e respostas >> Web API Testing Interview Questions
Chamada Para Ação
E para você, o que é e o que define uma API?
Deixe nos comentários qualquer API, repositório ou situação que você criou ou precisou lidar com alguma API. 😁
Referências
- https://medium.com/another-integration-blog/what-is-an-api-acddecb5c39b
- https://www.sydle.com/br/blog/api-6214f68876950e47761c40e7/
- https://www.redhat.com/pt-br/topics/api/what-are-application-programming-interfaces
- https://github.com/public-apis/public-apis
- https://www.programmableweb.com/
- https://trailhead.salesforce.com/pt-BR/content/learn/modules/external-services/define-a-schema-for-an-external-service
- http://abelha.cria.org.br/list
- https://dicionario.priberam.org/api
- https://www.linkedin.com/posts/francescosuraci_apis-integration-activity-6967939763282542593-0g2A?utm_source=share&utm_medium=member_desktop
- https://www.freecodecamp.org/portuguese/news/tutorial-de-fetch-api-em-javascript-exemplos-de-post-e-cabecalho/