Conceção e desenvolvimento de uma plataforma para a democratização de APIs

Abstract

Numa era em que tudo está interligado, as organizações que mais antecipadamente adotam estraté-gias de conexão entre os seus produtos, dados e consumidores finais, são aquelas que frequentemente conseguem obter uma vantagem competitiva no mercado. A Sonae MC, como presença dominante no mercado português, adotou uma nova evolução de uma Arquitetura Orientada a Serviços, de modo a manter esse destaque. API-led Connectivity visa estabelecer a conexão acima referida, com recurso às APIs previamente existentes, cada uma com um único propósito, facilitando a sua reutilização e modularidade da arquite-tura. Este conceito é simbólico da transformação digital na Sonae MC e surge agora a oportunidade de estruturar, documentar e divulgar todas as APIs existentes no seu portefólio. Sendo assim, esta dissertação pretende expor um modo mais fácil e autónomo de implementação e manutenção, tanto de novos projetos, como daqueles já existentes dentro da empresa. Isto será atingível através de um reforço da governação e visibilidade dos ativos digitais da organização, que terão como face um novo Portal de APIs. A dissertação acompanha a criação deste portal e descreve como todos os conceitos envolvidos dão origem a uma nova e mais acessível forma de adoção de APIs pelas equipas que delas necessitam. Neste processo de criação, são abordadas diversas fases do desenvolvimento do software, nomeadamente o levantamento e modelação dos seus casos de uso e a sua análise, conceção e implementação. É provado que é de facto vantajoso para uma empresa fornecedora de APIs ter um portal para as apresentar e, por fim, são enumeradas formas de como comprovar e aumentar estas vantagens para o caso da Sonae MC.

In an era when everything is interconnected, the organizations that most early adopt connection strate-gies between their products, data and final consumers, are the ones that often obtain a competitive ad-vantage in the market. Sonae MC, as a dominant presence in the Portuguese market, has adopted a new evolution of Service Oriented Architecture, in order to maintain this prominence. API-led connectivity aims to establish the connection mentioned above, using previously existing APIs, each with a unique purpose, facilitating its reuse and modularity of the architecture. This concept is a symbol of the digital transformation at Sonae MC and now there is an opportunity to structure, document and disseminate all the APIs existing in its portfolio. This dissertation intends to expose an easier and autonomous way of implementation and mainte-nance, both for new projects, and for those already existing within the company. It will be attainable through a strengthening of the governance and visibility of the digital assets of the organization, which will be represented via a new API Portal. The dissertation follows the creation of this portal and describes how all concepts involved result in a new and more accessible way of adopting APIs by the teams that need them. Several phases of the software development are addressed in the process, namely the elicitation and modelling of its use cases and its analysis, design and implementation. It is proved that it is indeed advantageous for an API provider to have a portal to present them. Finally, some ways of how to prove and increase these advantages are enumerated for Sonae MC's case.