GraphQL e REST com Node.js: qual escolher para suas APIs?

• Como começar a aprender Node.js

• REST API: desvendando o poder das aplicações web.

REST: a fundação das APIs modernas

O que é REST?

• Recursos como URLs (e.g., /users).

• Métodos HTTP: GET, POST, PUT, DELETE.

• Stateless (sem estado): cada requisição é independente.

Desafios do REST

• Over-fetching: dados adicionais que não são necessários ao cliente podem ser enviados.

• Under-fetching: múltiplas requisições para obter informações relacionadas.

• Falta de flexibilidade: alterações no cliente podem exigir novos endpoints.

Exemplo com Node.js e Express

const express = require('express');
const app = express();

app.use(express.json());

app.get('/users', (req, res) => {
  res.json([{ id: 1, name: 'Diego' }, { id: 2, name: 'Mayk' }]);
});

app.listen(3000, () => console.log('API REST rodando em http://localhost:3000'));

📽️

Para você que está começando a explorar o universo das APIs e quer entender conceitos fundamentais como API, REST e RESTful, convidamos você a assistir a um vídeo incrível do Mayk Brito. Nele, você vai aprender com exemplos práticos o que são esses conceitos e como aplicá-los no desenvolvimento de APIs.

GraphQL: a linguagem de consultas para APIs modernas

O que é GraphQL?

Principais conceitos:

• Schema: define a estrutura e os tipos de dados.

• Resolvers: funções que retornam os dados.

• Queries e mutations: consultas e alterações de dados.

Exemplo de queries e mutations:

type Query {
  getUser(id: ID!): User
  getAllUsers: [User]
}

type Mutation {
  createUser(name: String!, email: String!): User
}

type User {
  id: ID
  name: String
  email: String
}

const users = [];

const resolvers = {
  Query: {
    getUser: (_, { id }) => users.find(user => user.id === id),
    getAllUsers: () => users,
  },
  Mutation: {
    createUser: (_, { name, email }) => {
      const newUser = { id: users.length + 1, name, email };
      users.push(newUser);
      return newUser;
    },
  },
};

• Query para obter todos os usuários:

query {
  getAllUsers {
    id
    name
    email
  }
}

• Mutation para criar um novo usuário:

mutation {
  createUser(name: "Mayk", email: "mayk@example.com") {
    id
    name
    email
  }
}

Exemplo com Apollo Server

const { ApolloServer, gql } = require('apollo-server');

const typeDefs = gql`
  type Query {
    hello: String
  }
`;

const resolvers = {
  Query: {
    hello: () => 'Olá, GraphQL!',
  },
};

const server = new ApolloServer({ typeDefs, resolvers });

server.listen().then(({ url }) => console.log(`Server ready at ${url}`));

📽️

Se você ficou curioso sobre como construir APIs GraphQL utilizando Node.js, este vídeo é para você! Nele, você vai aprender desde os conceitos iniciais até a criação de dois aplicativos completos com GraphQL. É uma ótima oportunidade para entender como essa tecnologia pode transformar a forma como você consome e entrega dados.

REST + GraphQL: usando o melhor dos dois mundos

Por que combinar REST e GraphQL?

• Migração incremental: transforme APIs REST existentes em GraphQL gradualmente.

• Flexibilidade: use GraphQL como uma camada para consolidar diferentes APIs REST.

• Simplicidade: utilize REST para operações simples e GraphQL para consultas mais complexas.

Exemplo: Wrapping REST com GraphQL

Definindo o Schema

type Query {
  user(id: ID!): User
}

type User {
  id: ID
  name: String
  email: String
}

Resolver que faz requisição à API REST

const fetch = require('node-fetch');

const resolvers = {
  Query: {
    user: async (_, { id }) => {
      const response = await fetch(`https://jsonplaceholder.typicode.com/users/${id}`);
      const data = await response.json();
      return data;
    },
  },
};

Configurando o Apollo Server

const { ApolloServer } = require('apollo-server');
const typeDefs = require('./schema');
const resolvers = require('./resolvers');

const server = new ApolloServer({ typeDefs, resolvers });

server.listen().then(({ url }) => console.log(`Server ready at ${url}`));

Essa abordagem permite reaproveitar APIs REST existentes e ainda aproveita a flexibilidade do GraphQL.

Quando usar REST ou GraphQL?

REST é ideal para:

• Aplicações simples.

• Operações CRUD diretas.

• APIs públicas amplamente documentadas.

GraphQL brilha em:

• Aplicações com requisitos dinâmicos de dados, como dashboards.

• Mobile apps, onde a otimização do uso de dados é essencial.

• Projetos que exigem interatividade ou tempo real.

Conclusão

Agora que você tem uma visão mais clara, que tal dar o próximo passo na sua jornada como desenvolvedor?

Domine as tecnologias que estão transformando o mercado!

• Mais de 72 horas de conteúdo gravado.

• +8 projetos profissionais para o seu portfólio.

• Certificado de Especialista em Node.js validado pelo mercado.

• Acompanhamento personalizado com tutorias individuais e em grupo.

• Networking e mentorias para impulsionar sua carreira dev.

Ministrada pelo Diego Fernandes, co-fundador e CTO da Rocketseat, a formação é voltada para quem deseja construir projetos reais e se destacar no mercado.

Está esperando o quê?