API

É um conjunto de definições e protocolos usado para desenvolver e integrar software. APIs permitem que diferentes aplicações se comuniquem entre si, facilitando a troca de dados e funcionalidades de forma estruturada e segura.

• APLICAÇÃO: Refere-se ao software que está sendo integrado.

• PROGRAMAÇÃO: conjunto de regras que as aplicações se comunicarem

• INTERFACE: A maneira como as diferentes partes de um software interagem.

.

CLASSIFICAÇÕES

1.      CLASSIFICAÇÃO POR ACESSO

2.      CLASSIFICAÇÃO POR USO

3.      CLASSIFICAÇÃO POR ARQUITETURA

4.      CLASSIFICAÇÃO POR FINALIDADE

5.      CLASSIFICAÇÃO POR ESTILO DE COMUNICAÇÃO

CLASSIFICAÇÕES POR ACESSO

a.      APIs Públicas (Open APIs):

APIs Públicas, também conhecidas como Open APIs, são acessíveis ao público e podem ser utilizadas por qualquer desenvolvedor. Elas estão amplamente documentadas e disponíveis sem restrições severas.

b.      APIs Privadas (Internal APIs):

APIs Privadas, também conhecidas como Internal APIs, são usadas exclusivamente dentro de uma organização. Elas não estão disponíveis para desenvolvedores externos e são usadas para conectar sistemas internos e serviços.

a.      APIs de Parceria (Partner APIs):

APIs de Parceria, ou Partner APIs, são disponibilizadas apenas para parceiros estratégicos ou comerciais. Elas exigem autenticação e são usadas para permitir integrações específicas e colaboração entre empresas.

CLASSIFICAÇÃO POR USO

a.      APIs de Serviço Web (Web APIs)

APIs de Serviço Web, ou Web APIs, são interfaces programáticas acessíveis através de protocolos da web como HTTP ou HTTPS. Elas permitem que diferentes sistemas de software se comuniquem entre si pela internet.

b. APIs de Sistema Operacional (OS APIs)

APIs de Sistema Operacional, ou OS APIs, são interfaces que permitem que os aplicativos interajam com o sistema operacional. Elas fornecem acesso a recursos e serviços do sistema operacional, como arquivos, dispositivos e processos.

c. APIs de Bibliotecas e Frameworks (Library APIs)

APIs de Bibliotecas e Frameworks são interfaces fornecidas por bibliotecas de software ou frameworks que permitem que os desenvolvedores utilizem funcionalidades prontas em seus aplicativos.

CLASSIFICAÇÃO POR ARQUITETURA

a. APIs RESTful

APIs RESTful seguem os princípios de REST (Representational State Transfer), um estilo de arquitetura para sistemas distribuídos. Elas são baseadas em recursos e utilizam métodos HTTP para realizar operações sobre esses recursos.

b. APIs SOAP

APIs SOAP (Simple Object Access Protocol) são baseadas em um protocolo padrão que utiliza XML para formatar mensagens e realiza operações através de chamadas de procedimento remoto (RPC).

c. APIs GraphQL

Descrição: GraphQL é uma linguagem de consulta para APIs e um tempo de execução para atender a essas consultas. Desenvolvido pelo Facebook, permite que os clientes solicitem exatamente os dados de que precisam e nada mais.

d. APIs gRPC

Descrição: gRPC (gRPC Remote Procedure Calls) é um framework de chamada de procedimento remoto de alto desempenho desenvolvido pelo Google que usa o protocolo HTTP/2 para transporte.

CLASSIFICAÇÃO POR FINALIDADE

a. APIs de Dados (Data APIs)

Descrição: APIs de Dados são projetadas para proporcionar acesso a dados armazenados em bases de dados ou outras fontes de dados. Elas permitem que os clientes recuperem, adicionem, atualizem ou excluam dados.

b. APIs Funcionais (Functional APIs)

Descrição: APIs Funcionais expõem funcionalidades específicas que podem ser usadas por outros aplicativos. Elas são projetadas para executar operações específicas, em vez de apenas fornecer acesso a dados.

c. APIs de Interface do Usuário (UI APIs)

Descrição: APIs de Interface do Usuário (UI APIs) permitem a integração e manipulação de componentes de interface do usuário. Elas facilitam a criação e controle de elementos visuais em aplicativos.

,CLASSIFICAÇÃO POR ESTILO DE COMUNICAÇÃO

a. APIs Síncronas

Descrição: APIs Síncronas requerem que o cliente faça uma solicitação e espere pela resposta antes de continuar com outras tarefas. A comunicação é bloqueante, o que significa que o cliente é bloqueado até que o servidor processe a solicitação e retorne a resposta.

b. APIs Assíncronas

Descrição: APIs Assíncronas permitem que o cliente faça uma solicitação e continue com outras tarefas enquanto espera pela resposta. A comunicação é não bloqueante, o que significa que o cliente não é bloqueado e pode continuar a executar outras operações.

WEB SERVICE

É um tipo específico de API que opera exclusivamente sobre a web, utilizando protocolos da internet para permitir a comunicação entre aplicações que residem em diferentes sistemas ou locais.

CICLOS DE VIDA DE UMA API

PREPARAÇÃO DA SOLICITAÇÃO:

Um endpoint de API é uma URL que representa um recurso ou uma funcionalidade específica em um serviço web. Ele serve como um ponto de acesso para interagir com a API (Interface de Programação de Aplicações).

Cada endpoint corresponde a uma operação ou ação que pode ser realizada, como obter dados, enviar informações, atualizar um registro, ou excluir um recurso.

EXEMPLO DE ENDPOINTS

Considere uma API de uma loja online com recursos para produtos e pedidos:

• GET https://api.loja.com/produtos - Retorna uma lista de produtos.

• GET https://api.loja.com/produtos/{id} - Retorna detalhes de um produto específico.

• POST https://api.loja.com/pedidos - Cria um novo pedido.

• PUT https://api.loja.com/pedidos/{id} - Atualiza um pedido existente.

• DELETE https://api.loja.com/pedidos/{id} - Exclui um pedido.

1. Envio da Solicitação:

O cliente envia a solicitação para o servidor utilizando o método HTTP e endpoint definidos. A solicitação viaja pela rede até o servidor.

Métodos HTTP: Os endpoints de API geralmente suportam diferentes métodos HTTP, como:

• GET: Para obter informações de um recurso.

• POST: Para criar um novo recurso.

• PUT: Para atualizar um recurso existente.

• DELETE: Para excluir um recurso.

2. Recepção e Processamento no Servidor:

O servidor recebe a solicitação, valida os parâmetros e autenticação.

O servidor processa a solicitação, realizando operações como consultas a bancos de dados, processamento de lógica de negócio e comunicação com outros serviços.

3. Geração da Resposta:

O servidor cria a resposta baseada no resultado do processamento.

A resposta inclui um código de status HTTP, o corpo da resposta e quaisquer cabeçalhos necessários.

4. Envio da Resposta:

O servidor envia a resposta de volta ao cliente pela rede.

5. Recepção da Resposta pelo Cliente:

O cliente recebe a resposta e processa os dados ou mensagens retornadas.

_______________________________________

Nesky Engenharia