O que é uma API?

Porquê utilizar uma API?

A principal vantagem de uma API é a poupança de tempo. Um programador não precisa de saber como a API é implementada, pois limita-se a utilizar a interface como um canal de comunicação entre várias aplicações ou programas.

As vantagens da API são as seguintes:

• A simplificação dos processos. Tem acesso às informações das aplicações a partir de uma única interface.
• Uma precisão acrescida das aplicações e funcionalidades suplementares para estas últimas. Por exemplo, pode ligar um serviço de geolocalização a uma aplicação de aluguer de bicicletas elétricas, a fim de encontrar a mais próxima de si.
• Uma segurança reforçada dos dados em trânsito, tornada possível através da implementação de tokens, de assinaturas eletrónicas ou ainda da encriptação TLS (Transport Layer Security).

Quais são os diferentes tipos de API?

As API são definidas de forma diferente em função da sua acessibilidade, da sua utilização e da forma como um programador as utiliza. No entanto, podemos distinguir quatro grandes famílias de API.

• A API interna, ou API privada,é a forma que mais se privilegia na rede interna de uma empresa. Por exemplo, permite-lhe ligar um software de gestão do armazém ao sistema integrado de gestão empresarial (ERP). Como não está exposta ao público, em geral não beneficia de uma segurança elevada. No entanto, esta situação está a evoluir: a proteção das ferramentas informáticas nas empresas começa a abranger todos os programas utilizados.
• A API externa, ou API pública, está aberta a todos. Pode ser utilizada por qualquer programador terceiro. Atenção: embora o seu nome inglês, «Open API», possa causar confusão, ela nem sempre está ligada a uma tecnologia open source. A sua principal vantagem consiste em dar acesso a um grande número de linguagens de programação, facilitando a interligação dos serviços. As medidas de segurança de uma API pública são, por definição, limitadas. Isto implica que uma empresa deve refletir sobre a exposição dos seus dados se pretender utilizá-la.
• A API parceira assemelha-se a uma API interna, oferecendo a possibilidade de conceder direitos de acesso a programadores ou a prestadores externos. Por exemplo, se uma empresa recorrer a uma agência para tratar do seu site, pode fornecer-lhe identificadores e autorizações específicos.
• A API compósita é mais complexa. Tem geralmente várias interfaces de programação destinadas a utilizações específicas. É frequentemente utilizada como uma solução de gestão de outras API interligadas.

A sua ação processa-se geralmente da seguinte forma:

1. Uma aplicação ou um programa efetua um pedido. Este será transmitido ao servidor web através do URI (Uniform Resource Identifier).
2. Depois de validar o pedido, a API transfere-o para o servidor web (ou para o programa externo, se for caso disso).
3. A seguir, o servidor web envia a resposta à API.
4. A API devolve finalmente as informações recebidas à aplicação que fez o pedido.

Note, no entanto, que o tipo de dados transferidos pode depender do serviço web utilizado. Ainda assim, os pedidos e as respostas são sempre transmitidos pela API. Além disso, o seu design permite-lhe ser usada por um ser humano ou por um computador, o que lhe confere flexibilidade.

É possível adicionar etapas de segurança neste processo. Tendo em conta o papel de canal intermediário da API, é a etapa ideal para definir uma autenticação. Por exemplo, pode adicionar palavras-passe, verificações dos cabeçalhos HTTPS, cookies, etc. Esta medida deve ser privilegiada no âmbito da manipulação de dados sensíveis (como dados bancários, administrativos ou privados).

O que é uma API de ponte?

Trata-se de uma ferramenta que lhe permite gerir as diferentes API. A maior parte das API internas ou privadas recorre a esta solução por razões de segurança e de desempenho. Como mencionado anteriormente, uma API recebe um pedido e transmite uma resposta. Mas, neste caso de uso, a realidade é mais complexa.

Para uma empresa, é importante incluir parâmetros de segurança, de monitorização e/ou de restrição. Se dispõe de vários microsserviços, pode haver um grande número de pedidos a gerir simultaneamente. É por esta razão que a API de ponte constitui uma vantagem não negligenciável. Permite-lhe um melhor controlo dos fluxos de dados que circulam entre as API, mas também entre as API e os serviços.

L’utilisation de l’API s’est démocratisée au cours des 10 dernières années. Son fonctionnement s’est, de ce fait, adapté aux applications les plus récentes. Différents protocoles ont été créés pour répondre à ces évolutions.

• SOAP (Simple Object Access Protocol) est un protocole qui repose sur du XML. Son but est de faciliter le transfert d’informations entre applications et logiciels fonctionnant dans des langages et des environnements différents. Cela est notamment rendu possible via des protocoles SMTP et HTTP. Il s’agit du protocole d’API le plus ancien.
• XML-RPC est un protocole qui repose sur un type précis de format XML. Il a été développé après SOAP, mais est reconnu comme plus simple et plus économe en bande passante.
• JSON-RPC est similaire au protocole XML-RPC dans son fonctionnement. Il repose toutefois sur le format de texte JSON plutôt que sur du XML. Il est réputé simple et permet de ne transmettre qu’une réponse à des requêtes complexes.
• REST constitue davantage un ensemble de règles sur l’architecture d’une API qu’un réel protocole. Pour qu’une API soit REST — on parle alors de RESTful API — elle doit respecter un ensemble de critères prédéfinis. Le but de ce « cahier des charges d’une API » est de faciliter la création et l’intégration d’applications.

La majorité des API présentes en ligne à l’heure actuelle sont des API REST. Ces règles ont permis de créer des API plus légères et plus simples d’utilisation. Elles sont particulièrement adaptées à l’IoT (Internet des objets ou Internet of Things en anglais) et les applications mobiles.

A API SOAP e a API REST

É preciso recordar que se trata de dois elementos diferentes. Em primeiro lugar, o SOAP é um protocolo, enquanto o REST é uma arquitetura. Além disso, embora ambos tenham por objetivo facilitar a criação de API, não estão sujeitos às mesmas regras.

Ao elaborar normas e padrões de criação, permitiram aos programadores uma simplificação no intercâmbio e na utilização de API. Quando a sua utilização se democratizou, o SOAP pretendia criar um padrão de pedidos e de formatos de mensagens para facilitar as trocas de dados. Isto permitiu uma melhor comunicação entre as aplicações, apesar de linguagens ou de ambientes de programação diferentes.

O REST, por sua vez, baseia-se em seis grandes princípios de criação de API. Estes últimos são mais fáceis de seguir do que um protocolo restritivo. É em parte por essa razão que a maioria das API é hoje essencialmente RESTful.

De modo a criar os seus projetos web, disponibilizamos a API OVHcloud. Consiste numa ferramenta segura que respeita os seus dados pessoais, à semelhança do resto das nossas soluções.

A nossa API permite-lhe:

• gerir as soluções OVHcloud (administração, atualização, acompanhamento);
• criar e aperfeiçoar aplicações próprias;
• automatizar certas tarefas e otimizar funções.

Precisa de ajuda? Não hesite em consultar os nossos manuais.