GraphQL é uma linguagem de consulta para APIs que permite executar consultas usando um sistema de tipos definido para os dados. Originado em 2012 e se tornando open source em 2015, o GraphQL oferece uma experiência de desenvolvimento facilitada e é adotado por grandes plataformas como o GitHub, que já não utiliza mais a API REST em sua versão 4. O GraphQL simplifica a evolução de APIs, reduzindo o payload para aplicativos móveis e permitindo que desenvolvedores explorem dados de forma interativa.

2. @marcosbrizeno

3. O que é GraphQL

4. GraphQL is a query language
for your API, and a server-side
runtime for executing queries
by using a type system you
define for your data.
http://graphql.org/learn/

5. Type Query {
me: User
}
Type User {
id: ID
name: String
}

6. Type Query {
me: User
}
Type User {
id: ID
name: String
}
{
me {
name
}
}

7. {
"me": {
"name": "Luke Skywalker"
}
}
Type Query {
me: User
}
Type User {
id: ID
name: String
}
{
me {
name
}
}

8. Como funciona na prática?
POST http://localhost/graphql
{
"query" : "query { me { name } }"
}

9. Como funciona na prática?
POST http://localhost/graphql
{
"query" : "query { me { name } }"
}
Response
{
"data" : {
"me" : {
"name" : "Luke Skywalker"
}
}
}

10. De onde veio GraphQL?
● Protótipo em 2012
https://youtu.be/zVNrqo9XGOs

11. De onde veio GraphQL?
● Protótipo em 2012
● 2015 Falaram sobre GraphQL
https://youtu.be/zVNrqo9XGOs

12. De onde veio GraphQL?
● Protótipo em 2012
● 2015 Falaram sobre GraphQL
● Mais tarde (Julho) foi OSS (JavaScript)
https://youtu.be/zVNrqo9XGOs

13. De onde veio GraphQL?
● Protótipo em 2012
● 2015 Falaram sobre GraphQL
● Mais tarde (Julho) foi OSS (JavaScript)
● 2016 Production Ready
https://youtu.be/zVNrqo9XGOs

14. Explorando APIs GraphQL
Com GraphiQL!

15. GraphiQL is a graphical
interactive in-browser GraphQL
IDE.
https://github.com/graphql/graphiql

16. https://github.com/graphql/graphiql

17. http://graphql.org/swapi-graphql/

18. GraphiQL
http://graphql.org/swapi-graphql/

19. Show me the Code!
Acessando a
API do Github

20. Quais linguagens
tenho utilizado nos
meus últimos
repositórios?

21. API Rest
GET /user/repos
Response

22. API Rest
GET /user/repos
Response

23. API Rest
GET /repos/:owner/:repo/languages
Response

24. API Rest
10x

25. API GraphQL do Github
https://developer.github.com/v4

26. API GraphQL do Github
https://developer.github.com/v4/explorer/

27. https://developer.github.com/v4/explorer/

28. https://developer.github.com/v4/explorer/

29. https://developer.github.com/v4/explorer/

30. https://developer.github.com/v4/explorer/

31. https://developer.github.com/v4/explorer/

32. https://developer.github.com/v4/explorer/

33. Show me the Code! [2]
Criando uma
API GraphQL

34. Gemfile

35. Gemfile
$> bundle

36. Gemfile
$> bundle
$> rails g graphql:install

37. Gemfile
$> bundle
$> rails g graphql:install
routes.rb

38. app/controllers/graphql_controller.rb

39. app/controllers/graphql_controller.rb

40. app/graphql/leave_management_schema.rb

41. app/graphql/leave_management_schema.rb

42. app/graphql/types/query_type.rb

43. app/graphql/types/query_type.rb

44. app/graphql/types/query_type.rb

45. app/graphql/types/query_type.rb

46. app/graphql/types/leave_query_type.rb

47. app/graphql/types/leave_query_type.rb

48. app/graphql/types/leave_query_type.rb

49. app/graphql/types/leave_query_type.rb

50. app/graphql/types/consultant_query_type.rb

51. app/graphql/types/consultant_query_type.rb

52. http://localhost:3001/graphiql

53. E aí?
GraphQL
ou
REST

54. Ninguém usa GraphQL
- O Github já tá usando! - Retrabalho para novos
consumidores

55. O Github já usa GraphQL!
- A versão nova da API
(v4) não é REST
- Github v3 é o primeiro
resultado no google

56. GraphQL é mais fácil de evoluir
- Evoluir os modelos do
grafo é mais fácil do
que criar uma nova
versão da API
- Mudanças destrutivas
continuam quebrando
os clientes, e GraphQL
não versiona

57. GraphQL é mais fácil de codar
- Uma vez que o grafo é
definido, é fácil
reutilizá-lo

58. GraphiQL facilita muito a Developer Experience
- Consumidores podem
explorar os dados e
criar suas consultas
(além de ver a
documentação)

59. GraphQL facilita muito a Developer Experience
- APIs REST precisam
que você implemente
customizações da
resposta

60. GraphQL + BFF = <3
- GraphQL reduz o
payload (essencial para
apps mobile)

61. GraphQL exige mudança na mentalidade
- Pensar em grafos não é
tão direto assim

62. Beleza!
Quero usar GraphQL,
#comofaz?

63. Preciso de uma linguagem
nova só pro GraphQL?

64. Preciso de uma linguagem
nova só pro GraphQL?
Não!

65. http://graphql.org/code/

66. Preciso de um servidor
só pro GraphQL?

67. Preciso de um servidor
só pro GraphQL?
Não!

68. REST API
GraphQL API

69. GraphQL precisa estar junto
com os dados?

70. GraphQL precisa estar junto
com os dados?
Não!

71. POST /graphql

72. GraphQL é apenas
uma (fina) camada

73. http://graphql.org/learn/thinking-in-graphs/

76. https://martinfowler.com/articles/born-for-it.html

78. Valeu!
@marcosbrizeno