Acesse nossa Plataforma

Você já sabe o que é uma API, não é mesmo? Uma Application Programming Interface é uma interface computacional que coleta, envia e troca informações entre diferentes programas, sistemas, aplicações e equipamentos. Com elas, é possível requisitar acesso aos dados de um sistema.

Hoje vamos falar um pouco sobre os tipos de APIs. A partir deste artigo, elencamos os principais tipos de APIs e também alguns pontos sobre como elas podem mudar a estrutura de negócio da sua empresa.

Os Tipos de APIs

Podemos dizer que existem quatro tipos de APIs:

  • APIs públicas ou abertas
  • APIs privadas ou internas
  • APIs de parceiros
  • APIs compostas

APIs públicas

As APIs abertas, também conhecidas como APIs públicas, estão disponíveis para desenvolvedores e outros usuários de forma pública para o consumo e com restrições mínimas. Elas podem exigir registro, uso de uma chave de API ou OAuth, ou mesmo podem ser completamente abertos. Elas se concentram em usuários externos, para acessar dados ou serviços. As empresas podem utilizar um Developer Portal, com toda a documentação de suas APIs, ou mesmo uma chave para expô-las de forma pública.

Um grande exemplo de API pública é a do Google Maps, que expõe os dados de seu sistema para consumo externo de parceiros.

API Pública - Google Maps

APIs privadas

As APIs internas, também conhecidas como APIs privadas, são ocultadas de usuários externos e expostas apenas para sistemas internos de uma empresa. Elas não são usadas para o consumo fora da empresa, mas sim ao uso em diferentes equipes de desenvolvimento interno para melhor produtividade e reutilização de serviços.

Um bom processo de governança consiste em expô-las a um Developer Portal interno de APIs que se conecta aos sistemas internos para autenticar e permitir que os usuários acessem um conjunto correto de APIs.

APIs de parceiros

As APIs de parceiros são APIs expostas por ou para os parceiros de negócios estratégicos. Eles não estão disponíveis publicamente e precisam de direitos específicos para acessá-los. Assim como as APIs abertas, as APIs de parceiros são a ponta do iceberg porque são as mais visíveis e usadas para se comunicar além dos limites da empresa. Eles geralmente são expostos a um portal de desenvolvedor de API público que os desenvolvedores podem acessar no modo de autoatendimento. Embora as APIs abertas sejam completamente abertas, há um processo de integração com um fluxo de trabalho de validação específico para obter acesso às APIs de parceiros.

APIs compostas

As APIs compostas combinam vários dados ou APIs de serviço. Eles são desenvolvidos usando os recursos de orquestração de API de uma ferramenta de criação de API. Eles permitem que os desenvolvedores acessem vários terminais em uma chamada.

As APIs compostas são úteis, por exemplo, em um padrão de arquitetura de microsserviços em que você precisa de informações de vários serviços para executar uma única tarefa.

Os tipos de APIs

Tipos de APIs de dados e serviços

Além da diferença entre APIs privadas, públicas, de parceiros e compostas, temos outra abordagem para categorizar as APIs: APIs de Dados, APIs de Serviços, APIs de Serviços Externos e APIs de Experiência do Usuário. Vamos ver cada uma delas a seguir:

APIs de Dados

As APIs de dados fornecem acesso CRUD a conjuntos de dados subjacentes para vários bancos de dados ou provedores de nuvem SaaS. Essas APIs são necessárias para servir alguns dados fundamentais provenientes de aplicativos SaaS, com a ajuda de conectores SaaS ou armazenamentos de dados internos.

APIs de Serviços Internos

As APIs de serviço interno consistem em expor serviços internos, refletindo partes de processos internos ou algumas ações complexas.

APIs de Serviços Externos

As APIs de serviço externo são serviços de terceiros que podem ser incorporados aos serviços existentes da empresa para agregar valor adicional.

APIs de Experiência do Usuário

As APIs de experiência do usuário utilizam APIs compostas para ajudar os desenvolvedores de aplicativos a fornecer a experiência certa para cada dispositivo específico (desktop, celular, tablet, VPA, IoT).

Tipos de protocolos de API

Para aproveitar esses diferentes tipos de APIs, devemos seguir certos protocolos. Um protocolo fornece regras definidas para chamadas de API. Ele especifica os tipos de dados e comandos aceitos. Vejamos os principais tipos de protocolos para APIs:

REST

REST significa  Representational State Transfe  e é uma API de serviços da web. APIs REST são uma parte importante dos aplicativos web modernos, incluindo Netflix, Uber, Amazon e muitos outros. Para que uma API seja RESTful, ela deve seguir as seguintes regras:

  • Stateless - A API REST é stateless por natureza, Arquitetura Cliente-Servidor
  • Interface uniforme - um cliente e um servidor devem se comunicar um com o outro via HTTP (protocolo de transferência de hipertexto) usando URIs (identificadores de recursos exclusivos), CRUD (criar, ler, atualizar, excluir) e convenções JSON (JavaScript Object Notation).
  • Cliente-servidor - o cliente e o servidor devem ser independentes um do outro. As alterações feitas no servidor não devem afetar o cliente e vice-versa.
  • Cache - o cliente deve armazenar em cache as respostas, pois isso melhora a experiência do usuário, tornando-as mais rápidas e eficientes.
  • Em camadas - a API deve oferecer suporte a uma arquitetura em camadas, com cada camada contribuindo para uma hierarquia clara. Cada camada deve ser fracamente acoplada e permitir o encapsulamento.

SOAP

SOAP significa protocolo de acesso a objeto simples, e é um protocolo bem estabelecido semelhante ao REST no sentido de que é um tipo de API da Web.

O SOAP foi aproveitado desde o final dos anos 1990 e foi o primeiro a padronizar a maneira como os aplicativos devem usar conexões de rede para gerenciar serviços.

Porém, o SOAP possui regras rígidas, padrões rígidos eram muito pesados e, em algumas situações, consumiam muitos recursos. Exceto para cenários locais existentes, a maioria dos desenvolvedores desenvolve em REST em vez de SOAP hoje em dia.

RPC

Um RPC é um protocolo de chamada procedural remota. Eles são os tipos mais antigos e simples de APIs. O objetivo de um RPC era que o cliente executasse o código em um servidor. XML-RPC usava XML para codificar suas chamadas, enquanto JSON-RPC usava JSON para a codificação.

Ambos são protocolos simples. Embora semelhante ao REST, existem algumas diferenças importantes. APIs RPC são fortemente acopladas, então isso torna difícil mantê-las ou atualizá-las.

Para fazer qualquer mudança, um novo desenvolvedor teria que passar por várias documentações de RPCs para entender como uma mudança afeta a outra.

A importância das APIs REST

APIs desempenham um papel fundamental no desenvolvimento de qualquer aplicativo. E o protocolo REST se tornou o padrão preferido e mais usado para a construção de aplicativos que se comunicam pela web.

O REST aproveita totalmente todos os padrões que impulsionam a World Wide Web e é mais simples do que os serviços da Web baseados em SOAP tradicionais. Ao contrário do RPC, ele permite uma arquitetura em camadas fracamente acoplada para mantê-los ou atualizá-los facilmente.

Conte sempre com uma plataforma de Gestão de APIs

Com a plataforma LinkApi é possível criar e gerenciar APIs REST para qualquer tipo de aplicação de maneira segura, escalável e totalmente dev-friendly. Somos uma plataforma completa que une gestão de APIs, plataforma de integrações e Dev-tools. Crie suas APIs com o nosso API Management e acelere a transformação digital em sua empresa.

Agende uma conversa e saiba como podemos te ajudar