As APIs conectam aplicativos por meio de protocolos e arquiteturas claras. Uma arquitetura de API é uma estrutura de regras para criar interfaces de software. As regras determinam como fornecer a funcionalidade do servidor aos usuários. O tipo de arquitetura determina as regras e estruturas que regem a API.
Existem muitos tipos diferentes de arquitetura de API, de REST a RPC. Aprender sobre sua estrutura e composição ajudará você a selecionar um para sua aplicação.
1. DESCANSAR
API REST são modernos e são a arquitetura de API mais popular que os desenvolvedores usam. DESCANSAR (transferência de estado representacional) é uma arquitetura usada para projetar aplicativos cliente-servidor. Não é um protocolo ou padrão, então você pode implementá-lo de várias maneiras. Esse aspecto aumenta sua flexibilidade como desenvolvedor.
REST permite o acesso aos dados solicitados armazenados em um banco de dados. Você pode executar as principais funções CRUD com uma API REST. Quando os clientes solicitam conteúdo por meio de uma API RESTful, eles devem usar os cabeçalhos e parâmetros corretos. Os cabeçalhos contêm metadados úteis para identificar um recurso, como códigos de status e autorização.
As informações transferidas via HTTP podem estar em JSON, HTML, XML ou texto simples. JSON é o formato de arquivo mais comumente usado para APIs REST. JSON é independente de linguagem e legível por humanos.
2. SABÃO
Protocolo de acesso a objetos simples (SOAP) é um protocolo API oficial. O World Wide Web Consortium (W3C) mantém o protocolo SOAP, que é uma das primeiras arquiteturas de API. Seu design facilita a comunicação entre aplicações construídas com diferentes linguagens e plataformas.
O formato SOAP descreve uma API usando a linguagem de descrição de serviço da web (WSDL). Está escrito na extensa linguagem de marcação (XML). O formato impõe padrões de conformidade integrados que aumentam a segurança, a consistência, o isolamento e a durabilidade. Essas propriedades garantem transações de banco de dados confiáveis, tornando o SOAP melhor para o desenvolvimento corporativo.
Quando um usuário solicita conteúdo por meio de uma API SOAP, ele passa pelos protocolos de camada padrão. A resposta está no formato XML, que humanos e máquinas podem ler. Assim como as APIs REST, as APIs SOAP não armazenam em cache/armazenam informações. Se você precisar dos dados posteriormente, precisará fazer outra solicitação.
O SOAP oferece suporte a trocas de dados com e sem estado.
3. GraphQLGenericName
GraphQL é uma linguagem de consulta para uma API. É um tempo de execução do lado do servidor que executa consultas com base em um conjunto definido de dados. GraphQL tem casos de uso específicos. Sua arquitetura permite que você declare as informações específicas que você precisa.
Ao contrário da arquitetura REST, onde o HTTP lida com as solicitações e respostas do cliente, o GraphQL solicita dados com consultas. Um serviço GraphQL define os tipos e campos desses tipos e fornece funções para cada campo e tipo.
O serviço recebe consultas GraphQL para validar e executar. Primeiro, ele verifica uma consulta para garantir que ela se refira aos tipos e campos definidos. Em seguida, executa as funções associadas para produzir o resultado desejado.
O GraphQL é ótimo para certos casos de uso, como buscar dados de várias fontes. Você também pode controlar a busca de dados e regular a largura de banda para dispositivos menores.
4. Apache Kafka
Apache Kafka é uma plataforma distribuída que suporta streaming de eventos. O streaming de eventos é o processo de captura de dados em tempo real de fontes. As fontes podem ser bancos de dados, servidores ou aplicativos de software. O sistema Kafka consiste em servidores e clientes. A comunicação acontece através de um protocolo de rede TCP.
Você pode implantar o sistema em hardware, máquinas virtuais e contêineres. Você pode fazer isso no local e em ambientes de nuvem. O sistema Apache Kafka captura dados, processa e reage a eles em tempo real. Ele também pode rotear os dados para um destino preferido em tempo real. Kafka captura e armazena dados no sistema que você pode recuperar posteriormente para uso.
Kafka suporta um fluxo contínuo e integração de dados. Isso garante que a informação esteja no lugar certo, na hora certa. A transmissão de eventos pode ser aplicada a muitos casos de uso que precisam de transmissões de dados ao vivo. Isso inclui instituições financeiras, assistência médica, governo, indústria de transporte e empresas de software de computador.
5. AsyncAPI
AsyncAPI é uma iniciativa de software livre que ajuda a construir e manter arquiteturas orientadas a eventos. Suas especificações têm muitas coisas em comum com as especificações do OpenAPI. AsyncAPI é essencialmente uma adaptação e melhoria das especificações OpenAPI, com algumas diferenças.
A arquitetura AsyncAPI reúne uma mistura de APIs REST e APIs orientadas a eventos. Seus esquemas para lidar com solicitações e respostas são semelhante ao das APIs de evento. AsyncAPI fornece especificações para descrever e documentar aplicativos assíncronos em um formato legível por máquina formatar. Ele também fornece ferramentas como geradores de código para tornar mais fácil para os usuários implementá-los.
AsyncAPI melhora o estado atual da arquitetura orientada a eventos (EDA). O objetivo é facilitar o trabalho com EDAs como é com APIs REST. A iniciativa AsyncAPI fornece documentação e código que dão suporte ao gerenciamento de eventos. A maioria dos processos usados em APIs REST se aplica a APIs assíncronas/conduzidas por eventos.
Usar a especificação AsyncAPI para documentar sistemas orientados a eventos é vital. Ele governa e mantém a consistência e a eficiência entre as equipes que trabalham em projetos orientados a eventos.
6. Chamada de procedimento remoto (RPC)
RPC é um protocolo de comunicação de software que permite a comunicação entre diferentes programas em uma rede. Por exemplo, um programa pode solicitar informações de outro computador na rede. Ele não precisa aderir a protocolos de rede. Você pode usar o RPC para chamar processos em sistemas remotos da mesma forma que no sistema local.
O RPC opera no modelo cliente-servidor. O programa cliente solicita e o programa servidor responde com um serviço. RPCs operam em sincronia. Quando um programa envia uma solicitação, ele permanece suspenso até receber uma resposta do servidor.
RPCs são melhores para sistemas distribuídos. Eles são melhores para sistemas baseados em comandos e têm cargas úteis leves que aumentam o desempenho.
Como escolher a arquitetura de API certa
A arquitetura de API certa depende do seu caso de uso. A arquitetura determina a metodologia para desenvolver a API e como ela será executada. O design arquitetônico da API define seus componentes e interações.
Tome decisões arquitetônicas antes de projetar e desenvolver a API. Determine os requisitos técnicos da API, a camada, o gerenciamento do ciclo de vida e a segurança. Os projetos de arquitetura de API contêm camadas estruturais. As camadas orientam o desenvolvimento e garantem que a API criada atenda ao propósito pretendido.
