OpenAPI-to-GraphQL: a interface para qualquer API REST

07 Fev 2021 · Tutoriais 1 Comentário

Atualmente são várias as tecnologias na área da programação que simplificam a construção e desenvolvimento de aplicações e plataformas digitais. Se acompanha a área da programação de serviços/aplicações certamente que já ouviu falar no termo “Web Services” e API (Application Programming Interface).

No último artigo ensinamos a criar rapidamente uma API com o loopback da IBM e mongoDB. Hoje vamos ver como usar o GraphQL.

O LoopBack é uma framework para criação de API Node.js que permite criar funcionalidades de back-end. Esta framework funciona como um assistente de criação da API. O programador facilmente pode definir uma modelo de dados, criar controladores, ligar a sua API com bases de dados, etc - pode saber mais aqui.

Hoje vamos mostrar como podem instalar o GraphQL para criar uma interface para qualquer API REST. De relembrar que REST — REpresentational State Transfer é um modelo de arquitetura que usa o protocolo HTTP para comunicação para GET, POST, PUT e DELETE. Existem várias representações para apresentar um recurso como, por exemplo, XML, JSON, sendo que este último é o mais usado. Saber mais aqui.

Como instalar e usar o GraphQL com o loopback?

A instalação do GraphQL é extremamente simples. O OpenAPI-to-GraphQL pode ser usado como uma biblioteca ou uma interface de linha de comando (CLI). Para instalar a CLI OpenAPI-to-GraphQL, basta executar o comando: npm i -g openapi-to-graphql-cli

Em seguida devem executar a vossa app e abrir o endereço http://127.0.0.1:3000/openapi.json e obter o ficheiro openapi.json.

Depois devem executar o comando openapi-to-graphql openapi.json sendo que o output deverá ser algo do tipo.

O próximo passo é abrir o browser e inserir o seguinte endereço: http://127.0.0.1:3000/graphql e começar a fazer as queries que pretendem à vossa API Rest.

Para melhor perceberem como tudo funciona, vejam o seguinte vídeo.

Tal como o GraphQL existem muitas outras ferramentas simples de usar para integração e interação com a nossa API. Se conhecerem outras ferramentas, partilhem neste artigo.

Leia também...

Firebase: A plataforma que procura para as suas apps Web e Mobile

Este artigo tem mais de um ano

Comentários1

Lucas Caminhante das Estrelas says:

8 de Fevereiro de 2021 às 08:29

Muito interressante estes artigos essa relationado com o rest.

Responder

Deixe um comentário Cancelar Resposta

Aviso: Todo e qualquer texto publicado na internet através deste sistema não reflete, necessariamente, a opinião deste site ou do(s) seu(s) autor(es). Os comentários publicados através deste sistema são de exclusiva e integral responsabilidade e autoria dos leitores que dele fizerem uso. A administração deste site reserva-se, desde já, no direito de excluir comentários e textos que julgar ofensivos, difamatórios, caluniosos, preconceituosos ou de alguma forma prejudiciais a terceiros. Textos de caráter promocional ou inseridos no sistema sem a devida identificação do seu autor (nome completo e endereço válido de email) também poderão ser excluídos.