REST and gRPC for microservices backend API

1. API
REST gRPC
#ShinjukuLT
@disc99

2. •
• RESTful API
• gRPC
•

3. ?
• > ThoughtWorks
(O'Reilly)

7. > In short, the microservice architectural style is
an approach to developing a single application
as a suite of small services, each running in its
own process and communicating with
lightweight mechanisms, often an HTTP
resource API.
=> HTTP API
Microservices @Martin Fowler, @James Lewis
https://martinfowler.com/articles/microservices.html

8. RESTful API
> RESTful API Web
(API) REST
REST
REST Web API RESTful API
> URL/URI
( )
> HTTP XML HTML
JSON HTTP
e-Words
http://e-words.jp/w/RESTful_API.html
* RESTful API REST API

9. • Web API
• URL/URI
• : HTTP
• : XML HTML JSON + HTTP
• : :✕

10. ✋API

11. Q1.
Q. API
1. URL
2.
3. HTTP Header
4.

12. Q2. API
Q. API HTTP ?
1. POST
2. REST API PUT
3. PATCH
4.

13. Q3. API
• Q. DB
?
1. DB 500
2.
400+
3. 409
4.

14. Q4. API
• Q. ?
1.
2.
3.
4.

15. A.

16. ?

17. •
>
=>

18. > 2 2
=>
( )

19. RESTful
• Web API
=>
=>
*1
REST
https://togetter.com/li/14062

20. • REST API
•
•
•
• API

21. •
• Web ( )
• RESTful Web (O'Reilly)
• Web API: The Good Parts(O'Reilly)
• Microsoft REST API Guidelines
• https://github.com/Microsoft/api-guidelines/blob/master/
Guidelines.md
• Google API Design Guide
• https://cloud.google.com/apis/design/

22. •
• Google Microsoft Amazon Twitter Facebook
Netflix API
• Dropbox REST AWS API REST
• https://medium.com/@voluntas/http-api-
-7ccaca671d9d

24. • URL
•
•
•
• or :
•
• Swagger API Blueprint RAML JSON (Hyper)Scheme
•
•
•
• E2E Consumer-Driven
Contracts
• API …

26. •
•
•
•
( …)

27. RESTful Web @t_wada
https://www.slideshare.net/t_wada/restful-web-design-review

28. • REST
• REST
• REST
•
•

29. • • REST API
* REST API

30. • • REST API
* REST API

31. REST API
•
•
• HTTP
• API JSON JavaScript
=> API

32. REST API
?

33. Web API
>Web API
REST RPC SOAP
> RPC :
Remote Procedure Call
> RPC :
SDK

34. Web API
>Web API
REST RPC SOAP
> RPC :
Remote Procedure Call
> RPC :
SDK

35. Web API
>Web API
REST RPC SOAP
> RPC :
Remote Procedure Call
> RPC :
SDK
gRPC ( )

36. PRC?
>
>
Wikipedia
https://ja.wikipedia.org/wiki/RPC

37. RPC
• Java RMI
• XML-RPC
• JSON-RPC
• Apache Thrift
• gRPC

38. RPC
• Java RMI
• XML-RPC
• JSON-RPC
• Apache Thrift
• gRPC

39. gRPC
• Google RPC
• Google RPC OSS
• Protocol Buffers *1
•
• HTTP/2
•
• /
Streaming
*1. gRPC Protocol Buffers

40. Protocol Buffers?
•
• IDL( )
•
•
•
• IDL
•
•

41. • Google Protocol Buffers
• DB BigData
Protocol Buffers
rebuild.fm#169 @omo
https://rebuild.fm/169/

42. gRPC
•
• Google
• Square
• Netflix
• CoreOS
• Docker
• Cisco
•
•
• GRPC *1
• AbeamTV
• AbeamTV Microservices *2
•
• Protocol Buffers *3
*1. https://speakerdeck.com/kazegusuri/go-conference-2016-spring
*2. http://www.slideshare.net/RyotaNishio/abematvmicroservices-architecture
*3. http://tayama0324.github.io/slides/20161127-kbkz-tech.html#/

43. 1. (IDL)
2. IDL (
)
3.
4.
5.

45. gRPC API
• URL
•
•
•
•
•

46. URL
• IDL
•
•
• repeat map enum
• message stream service nest
•
• *1
• *2
*1. http://www.grpc.io/docs/guides/error.html
*2. ex:Java) http://www.grpc.io/grpc-java/javadoc/io/grpc/Status.html

47. •
•
•
•

48. • IDL
•
• protoc-gen-doc: IDL Markdown, HTML *1
• grpc-gateway: gRPC JSON
*2
• polyglot: grpc CLI *3
=> IDL
=>
• *1. https://github.com/estan/protoc-gen-doc
• *2. https://github.com/grpc-ecosystem/grpc-gateway
• *3. https://github.com/grpc-ecosystem

49. • (Protocol Buffers)
• IDL
•
• /
•
• 1
=> IDL ?

50. • .proto
• SSL/TLS Google API
•

51. •
•
•
•
•
=>
•
• https://github.com/grpc/grpc-java/issues/
1469#issuecomment-230852433

52. Other Pros
•
• XML JSON
•
•
• Protocol Buffers (JSON XML )
•
•

53. Cons
•
• RESTful API
=> REST ( AbemaTV)
• JSON
=> grpc-gateway polyglot
=>
•
=>
=> grpc-gateway *1
• HTTP/2
=> Kubernetes
*1. https://github.com/grpc/grpc-experiments/issues/159

54. Note
• gRPC
• gRPC
• DDD + DIP
• API( )

55. REST API
• (IDL)
=>
=> REST
=>
•
=>
=>
• Google
• …
=>
=>

56. •
• HTTP API
• RESTful API
•
•
•
• gRPC
•
•
•