1. The document discusses RESTful APIs and gRPC, comparing their characteristics and use cases. 2. RESTful APIs typically use HTTP and JSON to access resources via URLs while gRPC uses protocol buffers and HTTP/2 for efficient streaming and RPC. 3. gRPC is better suited for microservices and mobile apps due to its ability to handle streaming and performance, while REST is more widely used due to its simplicity and support in most languages.

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
•
•
•