Introdução ao GraphQL: Uma nova forma de criar APIs (Mercado Pago)

Esta talk foi apresentada para o time de "Plugins e Partners" do Mercado Pago, em 10/09/2020.

Transcript

1. Introdução ao GraphQL Uma nova forma de criar APIs
2. Nova forma de criar APIs? Foi criada em 2012 e lançada publicamente em 2015, mas...
3. FACEBOOK STACK https://stackshare.io/facebook/facebook
4. Ecossistema rico Mais de mil pacotes no NPM para o termo “graphql”...
5. Alguém está usando em prod?
6. O que é o GraphQL?
7. GraphQL ➔ Criada pelo Facebook ➔ Open-source ➔ Linguagem de consulta de dados ➔ Não é um protocolo para APIs, mas funciona como um ➔ Agnóstico: independe de linguagem ou banco de dados ➔ É uma spec! Protocolo para APIs? Padrão arquitetural?
8. Motivação
9. Quem solicita decide o que quer receber (somente o que precisa) Essa é a premissa básica, motivo de sua criação
10. No REST não é assim Em uma API REST é preciso criar um novo endpoint para receber uma resposta com estrutura de dados diferente
11. Netflix
12. GraphQL REST
13. • Representational State Transfer • Verbos HTTP (GET, POST, PUT, DELETE, HEAD…) • Resource based URLs - Endpoint (/movie/10) • RESTful: capacidade de determinado sistema aplicar os conceitos REST REST (ful) API
14. Action-based URL x Resource-based URL
16. Como ficam as URLs no GraphQL?
17. Buscando dados com REST GET /babies
18. Buscando dados com GraphQL POST /graphql
19. Buscando dados por ID com REST GET /babies/1
20. Buscando dados por ID com GraphQL POST /graphql
21. Salvando dados com REST POST /babies
22. Salvando dados com GraphQL POST /graphql
23. Filtrando dados com REST POST /babies?name=joaquim
24. Filtrando dados com GraphQL POST /graphql
25. ★ Baixo custo de mudança ★ Mais poder para o front-end Duas grandes vantagens do GraphQL
26. Vamos entender como a mágica acontece
27. 1. Single endpoint 2. Well defined contract (tem schema, é tipado - o REST é schemaless, não tem contrato) 3. No more overfetching 4. No more underfetching (vários endpoints para uma feature) Conceitos fundamentais do GraphQL
28. • Documentação: auto-documentação através do Schema ◦ Chamada de introspection retorna o Schema • Legibilidade da API: sem “salada” de URLs • Menos tráfego de dados no cliente: payload menor • Tempo de desenvolvimento do back-end focado em regras de negócio e qualidade, e não em “ajudar” o front-end Problemas comuns que o GraphQL resolve
30. Problema de versionamento
31. Int: A signed 32‐bit integer Float: A signed double-precision floating-point value String: A UTF‐8 character sequence Boolean: True ou false ID: Unique identifier (não legível para humanos) Tipos primitivos Tipos e schema Enum, custom scalar, listas e non-null
32. Interface
33. Union Types
34. O GraphQL trabalha com o conceito de estado Queries e Mutations
35. Exemplo de query e mutation
36. Resolvers Responsável pela magia mais poderosa
37. Suporte a real time Subscription
38. ★ Sobrecarga de responsabilidades no front-end funciona para todos os times e projetos? ★ Nada impede o dev de escrever (é até fácil) uma query com potencial destrutivo para sua app (ex.: sem paginação) ★ HTTP Cache comprometido GraphQL não é bala de prata
39. Outros protocolos para APIs
40. GraphQL como API Gateway
42. Use Apollo GraphQL;
43. Show me the code! https://github.com/fernandohenriques/nestjs-graphql-boilerplate https://github.com/fernandohenriques/graphql-on-rails
44. Obrigado!