Descrição de Application Programming Interfaces (APIs)

Você pode enfrentar alguns desafios ao transformar seus negócios em uma empresa inteligente e sustentável. Por exemplo, você precisa integrar aplicativos e processos empresariais em uma estrutura diversificada de sistemas baseados em nuvem ou híbridos. Você também tem soluções de fornecedores não SAP e, nesse caso, precisa integrar processos da SAP para processos não SAP. Você pode usar o SAP Integration Suite para integrar processos SAP a SAP e não SAP a SAP. Sua empresa também pode comercializar e gerenciar suas APIs por meio do SAP Integration Suite.

API é um acrônimo de "Interface de programação do aplicativo". É o mediador (representado por um pedaço de software) entre aplicativos/sites e você como usuário. Portanto, é vital que a comunicação entre diferentes instâncias troque informações.

Você encontra APIs no dia a dia sem perceber. Um exemplo é o Google Search: toda vez que você insere algo na barra de pesquisa, o serviço de back-end do Google procura suas palavras-chave no banco de dados e lista os resultados da sua solicitação no site. Na verdade, o site exibe o resultado da API. Um código para isso é o URL da respectiva pesquisa.

Ao pensar em uma pesquisa por "SAP", o URL indica: www.google.com/search?q=sap.

Agora vamos cortar este aqui:

Aqui www.google.com é o endereço do servidor, /search indica o recurso que você pretende usar, ou melhor, a API que você quer chamar, que neste caso é a API de pesquisa do Google, e q (para consulta) diz que agora um valor para consulta é transferido, que é o termo de pesquisa.

O mesmo se aplica à página de ajuda da SAP (https://help.sap.com ). Ao inserir a API na barra de pesquisa, é exibido o seguinte URL: https://help.sap.com/docs/search?q=api.

No entanto, uma chamada API não precisa necessariamente ser iniciada por um computador. Os sistemas de assistência por voz também são um exemplo da integração e do uso de APIs. Pedir ao seu assistente de voz para procurar algo realmente fornece ao assistente a sua consulta. Em seguida, essa consulta é armazenada como texto e adicionada como a consulta à chamada de API. Depois disso, o assistente emite o resultado da API via voz de áudio.

Então, não importa o que você faça com qualquer um dos seus dispositivos conectados, você está usando várias APIs por hora sem perceber. É por isso que as APIs são um tópico tão importante, porque são onipresentes e permitem que usuários e desenvolvedores se concentrem em "o que" precisa ser feito e não em "como". Além disso, você já pensou em como sua mensagem do WhatsApp é enviada para um destinatário?

Portanto, como o nome sugere, uma API é apenas um dos muitos tipos de interfaces usadas para acionar funções específicas, por exemplo, tocar música. Talvez você já esteja familiarizado com outros tipos de interfaces, como GUI (Graphical User Interface), que usamos para navegar entre aplicativos/sites com a ajuda de um mouse/tela sensível ao toque.

Atualmente, as APIs são indispensáveis para arquiteturas de TI. Embora o acesso de front-ends a back-ends, gerenciamento de interface e comunicação ponto-a-ponto tenham sido partes substanciais das arquiteturas de TI há anos, as APIs revolucionaram a forma como aplicativos e sites se comunicam. Portanto, as APIs trouxeram muitos benefícios para a criação e o gerenciamento de estruturas de TI. Os mais importantes e, portanto, os principais motivos pelos quais as empresas precisam implementá-los em sua arquitetura de TI, podem ser resumidos da seguinte forma:

As APIs, em seu núcleo, separam a comunicação da tarefa. Assim, se um serviço se comunica por meio de uma API, o usuário (ou consumidor) da API está totalmente focado nos recursos que a API fornece. O usuário só usa os recursos da API sem pensar no próprio trabalho. O foco é baseado na solicitação e no resultado (resposta) e nada mais.

Para definir e implementar APIs, diferentes padrões globais estão disponíveis para utilização. Alguns destes estão listados abaixo (no entanto, os mais comumente usados são APIs REST):

Com as APIs REST como o tipo de API mais popular, vamos nos aprofundar brevemente nas funções das APIs REST. Ao trabalhar com APIs, você costuma falar de recursos. Isso significa que normalmente você quer:

• Crie algo (como adicionar uma nova entrada a um guest book).
• Leia ou obtenha algo da API (lembre-se de sua Pesquisa Google: aqui você tentou obter uma lista de sites).
• Atualize ou altere algo (geralmente quando você criou algo que precisa ser alterado, como o status de algo ou se você fez um erro de digitação).
• Excluir algo.

Juntas, estas ações são abreviadas como CRUD.

Para APIs REST, esses verbos são muito semelhantes aos verbos CRUD:

Você pode notar que "update" tem dois verbos possíveis: PUT & PATCH.

O patch só altera uma parte do recurso ao qual você está se referindo. Pense na entrada do seu livro de hóspedes, onde você corrige apenas uma palavra e informaria ao livro de convidados que a palavra número 42 precisa ser trocada. Isso seria um patch - um ponto no reparo ou mudança. PUT, por outro lado, estaria mudando todo o texto, mesmo que seja principalmente o mesmo, mas com o erro corrigido (pense em limpar todo o texto e colar tudo de novo).

Normalmente, ao observar a especificação de uma API, esses verbos são exibidos como ilustrado abaixo (recuperados de uma implementação de exemplo no SAP BTP Integration Suite). Uma API não suporta necessariamente todos os verbos.