[B! swagger] p_tanã®ãƒ–ãƒƒã‚¯ãƒžãƒ¼ã‚¯

p_tan id:p_tan

swaggerã«é–¢ã™ã‚‹p_tanã®ãƒ–ãƒƒã‚¯ãƒžãƒ¼ã‚¯ (7)

${{author_name}}$

{{{comment_expanded}}}

{{label}}

{{#is_bookmark}}ãƒªã‚¹ãƒˆ{{/is_bookmark}}{{^is_bookmark}}ãƒªãƒ³ã‚¯{{/is_bookmark}}

${{author_name}}$
{{author_name}}{{created}}
{{ #comment }}{{ comment }}{{ /comment }}
- {{ label }}

${{author_name}}$

{{{comment_expanded}}}

{{label}}

{{#is_bookmark}}ãƒªã‚¹ãƒˆ{{/is_bookmark}}{{^is_bookmark}}ãƒªãƒ³ã‚¯{{/is_bookmark}}

ã‚¹ã‚ãƒ¼ãƒžå®šç¾©è¨€èªž Protocol Buffers ã¨ protoc-gen-swagger ã‚’ä½¿ã£ã¦ Web API ã®ã‚¹ã‚ãƒžã‚’åŸ‹ã‚ã‚ˆã† - VOYAGE GROUP techlog
VOYAGE Lighthouse Studio ã®æµ·è€åŽŸ (@co3k) ã§ã™ã€‚å…ˆæ—¥ 30 æ³ã«ãªã£ãŸè¨˜å¿µã¨ã—ã¦ã‚¿ã‚¤ãƒˆãƒ«ã¯ã‚ªãƒ¤ã‚¸ã‚®ãƒ£ã‚°ã§ã™ã€‚ ã•ã¦ã€æ™®æ®µã¯ ç¥žã‚²ãƒ¼æ”»ç•¥ ã¨ã„ã†ã‚²ãƒ¼ãƒ æ”»ç•¥ã‚µã‚¤ãƒˆã‚’é‹å–¶ã—ã¦ã„ã‚‹ã®ã§ã™ãŒã€ã¨ã‚ã‚‹æ´¾ç”Ÿã‚µãƒ¼ãƒ“ã‚¹ã‚’ç«‹ã¡ä¸Šã’ã‚‹ã«ã‚ãŸã‚Šã€ Web API ã‚¹ã‚ãƒ¼ãƒžå®šç¾©ã‚’ gRPC ã«åŸºã¥ãå½¢å¼ã® Protocol Buffers ã§æ›¸ãã€ protoc-gen-swagger ãƒ—ãƒ©ã‚°ã‚¤ãƒ³ã‚’ä»‹ã—ã¦ OpenAPI å®šç¾©ãƒ•ã‚¡ã‚¤ãƒ«ã¨ã—ã¦ç”Ÿæˆã™ã‚‹ã€ã¨ã„ã†ã‚¢ãƒ—ãƒãƒ¼ãƒã‚’æŽ¡ã‚Šã¾ã—ãŸã€‚ yugui ã•ã‚“ã®ç´ æ™´ã‚‰ã—ã„è¨˜äº‹ã€ã€Œä»Šã•ã‚‰Protocol Buffersã¨ã€æ‰‹ã«é¦´æŸ“ã‚€é“å…·ã®è©±ã€ã«ã‚ˆã£ã¦ã‚¹ã‚ãƒ¼ãƒžå®šç¾©è¨€èªžã¨ã—ã¦ã® Protocol Buffers ãŒã«ã‚ã‹ã«æ³¨ç›®ã‚’æµ´ã³ã¦ä»¥é™ã€ä¼¼ãŸã‚ˆã†ãªã“ã¨ã‚’ã‚„ã‚ŠãŸã„ã¨ã„ã†æ–¹ã‚‚ã„ã‚‰ã£ã—ã‚ƒã‚‹ã®ã§ã¯ãªã„ã§ã—ã‚‡ã†ã‹ã€‚ ã¨ã“ã‚ãŒã€ãŠãã‚‰ãå˜ä½“ã§ protoc-g
p_tan 2018/10/12
swagger

API

OpenAPI

grpc

web

json
ãƒªãƒ³ã‚¯
REST APIä»•æ§˜ã‹ã‚‰APIã‚¯ãƒ©ã‚¤ã‚¢ãƒ³ãƒˆã‚„ã‚¹ã‚¿ãƒ–ã‚µãƒ¼ãƒã‚’è‡ªå‹•ç”Ÿæˆã™ã‚‹ã€ŒOpenAPI Generatorã€ã‚ªãƒ¼ãƒ—ãƒ³ã‚½ãƒ¼ã‚¹ã§å…¬é–‹ã€‚Swagger Codegenã‹ã‚‰ã®ãƒ•ã‚©ãƒ¼ã‚¯
REST APIä»•æ§˜ã‹ã‚‰APIã‚¯ãƒ©ã‚¤ã‚¢ãƒ³ãƒˆã‚„ã‚¹ã‚¿ãƒ–ã‚µãƒ¼ãƒã‚’è‡ªå‹•ç”Ÿæˆã™ã‚‹ã€ŒOpenAPI Generatorã€ã‚ªãƒ¼ãƒ—ãƒ³ã‚½ãƒ¼ã‚¹ã§å…¬é–‹ã€‚Swagger Codegenã‹ã‚‰ã®ãƒ•ã‚©ãƒ¼ã‚¯ RESTful APIã®ä»•æ§˜ã‚’åŸºã«ã€APIã‚¯ãƒ©ã‚¤ã‚¢ãƒ³ãƒˆç”¨SDKã€APIã‚¯ãƒ©ã‚¤ã‚¢ãƒ³ãƒˆã®ãƒ†ã‚¹ãƒˆç”¨ã«APIã‚µãƒ¼ãƒã®ã‚ˆã†ã«æŒ¯ã‚‹èˆžã£ã¦ãã‚Œã‚‹ã‚¹ã‚¿ãƒ–ã‚µãƒ¼ãƒã€Webã‚µãƒ¼ãƒã®ã‚³ãƒ³ãƒ•ã‚£ã‚°ãƒ¬ãƒ¼ã‚·ãƒ§ãƒ³ã€ãƒ‰ã‚ãƒ¥ãƒ¡ãƒ³ãƒˆãªã©ã‚’è‡ªå‹•ç”Ÿæˆã—ã¦ãã‚Œã‚‹ã€ŒOpenAPI Generatorã€ãŒã‚ªãƒ¼ãƒ—ãƒ³ã‚½ãƒ¼ã‚¹ã¨ã—ã¦å…¬é–‹ã•ã‚Œã¾ã—ãŸã€‚ RESTful APIä»•æ§˜ã®è¨˜è¿°ãƒ•ã‚©ãƒ¼ãƒžãƒƒãƒˆã¯ã€2015å¹´ã«ãƒžã‚¤ã‚¯ãƒã‚½ãƒ•ãƒˆã‚„Googleã€IBMã‚‰ãŒç«‹ã¡ä¸Šã’ãŸã€ŒOpen API Initiativeã€ãŒæå”±ã™ã‚‹ã€ŒOpenAPI Specificationã€ãŒäº‹å®Ÿä¸Šã®æ¥ç•Œæ¨™æº–ã¨ãªã£ã¦ãŠã‚Šã€OpenAPI Generatorã‚‚ã“ã®OpenAPI Specificationã‚’åŸºã«é–‹
p_tan 2018/05/16
swagger

OpenAPI

API
ãƒªãƒ³ã‚¯
SwaggerProvider
p_tan 2018/05/03
Swaggerç”¨Type Providerã€‚

swagger

F#

Type Provider
ãƒªãƒ³ã‚¯
æœ¬ç•ªé‹ç”¨ã¾ã§è¡Œã‹ãªã‹ã£ãŸgRPCã®çŸ¥è¦‹ã‚’ã¾ã¨ã‚ã¦ãŠã - suusan2å·ã®æˆ¯ã‚Œ
ä¼šç¤¾ã®ãƒ–ãƒã‚°ã«æ›¸ã“ã†ã¨æ€ã£ãŸã‚“ã ã‘ã©ã€ã¡ã‚‡ã£ã¨ãƒžã‚¤ãƒŠã‚¹ã‚¤ãƒ¡ãƒ¼ã‚¸ã‚’æŒã¤äººã‚‚ã„ãã†ãªæ°—ãŒã—ãŸã®ã§ã€å€‹äººãƒ–ãƒã‚°ã«æ›¸ãã“ã¨ã«ã—ãŸã€‚ ã“ã®3ãƒ¶æœˆãã‚‰ã„ã€ã‚·ã‚¹ãƒ†ãƒ ã®ãƒªãƒ‹ãƒ¥ãƒ¼ã‚¢ãƒ«(ã‚¢ãƒ—ãƒªé–“ã§åˆ†æ•£ã—ãŸãƒã‚¸ãƒƒã‚¯ã‚’é›†ç´„ã™ã‚‹ãƒãƒƒã‚¯ã‚¨ãƒ³ãƒ‰ã‚µãƒ¼ãƒã¨ã€ç”¨é€”ã«å¿œã˜ãŸãƒ•ãƒãƒ³ãƒˆã‚¨ãƒ³ãƒ‰ã‚µãƒ¼ãƒã‚’ç«‹ã¦ã‚‹ã¿ãŸã„ãªãƒžã‚¤ã‚¯ãƒã‚µãƒ¼ãƒ“ã‚¹æ§‹æˆ)ã‚’ã‚„ã£ã¦ã„ã¦ã€ãã“ã§ã‚µãƒ¼ãƒé–“ã®ã‚„ã‚Šã¨ã‚Šã«gRPCã‚’ä½¿ã£ã¦ã„ãŸã€‚ã™ã”ãƒ¼ãé›‘ãªçµµã‚’æ›¸ãã¨ã“ã‚“ãªæ„Ÿã˜ã§ã™ã€‚ ã—ã‹ã—ã€æœ€è¿‘ã«ãªã£ã¦ãƒ—ãƒã‚¸ã‚§ã‚¯ãƒˆã®ã‚¹ã‚³ãƒ¼ãƒ—ã«ã¤ã„ã¦è¦‹ç›´ã—ãŒå…¥ã‚Šã¾ã—ãŸã€‚ãƒžã‚¤ã‚¯ãƒã‚µãƒ¼ãƒ“ã‚¹åŒ–ã§ã¯ãªãå˜ç´”ã«ãƒ¬ã‚¬ã‚·ãƒ¼Javaã§ç‹¬è‡ªFWãªã‚¢ãƒ—ãƒªã‚’ãƒªãƒ—ãƒ¬ãƒ¼ã‚¹ã™ã‚‹ã ã‘ã«ãªã‚Šã€å¿…è¦ãªã®ã¯SPAã¨SpringBootã®APIã‚µãƒ¼ãƒã ã‘ã«(è¦ã™ã‚‹ã«Railså´ã®ãƒã‚¸ãƒƒã‚¯ã‚’ãªã‚“ã¨ã‹ã™ã‚‹ã®ãŒã‚¹ã‚³ãƒ¼ãƒ—å¤–ã«ãªã£ãŸ)ã€‚ ã§ã€SPAã«æä¾›ã™ã‚‹APIã®ãŸã‚ã«gRPC(+ grpc-gateway)ã‚’ä½¿ã†ã®ã¯ã¡ã‚‡ã£ã¨ã‚ªãƒ¼ãƒãƒ¼ã‚¹ãƒšãƒƒã‚¯
p_tan 2018/03/28
grpc

çŸ¥è¦‹

json

swagger

API
ãƒªãƒ³ã‚¯
OpenAPI and gRPC Side-by-Side
Spend some time working with OpenAPI and gRPC and youâ€™ll notice that these two techno logies have a lot in common. Both are open source efforts, both describe APIs, and both promise better experiences for API producers and consumers. So why do we need both? If we do, what value does each provide? What can each project learn from the other? We need to talk about APIs.OpenAPI and gRPC are two approac
p_tan 2018/03/13
grpc

OpenAPI

swagger
ãƒªãƒ³ã‚¯
gRPC with REST and Open APIs
By Brandon Phillips (CoreOS) | From this [original post](https://coreos.com/blog/grpc-protobufs-swagger.html), revised by Brandon Phillips, with additional content by Lisa Carey and others at Google. Monday, May 09, 2016 Our guest post today comes from Brandon Phillips of CoreOS. CoreOS builds open source projects and products for Linux Containers. Their flagship product for consensus and discover
p_tan 2018/03/13
grpc

REST

RPC

OpenAPI

swagger
ãƒªãƒ³ã‚¯
Swaggerã§RESTful APIã®ç®¡ç†ã‚’æ¥½ã«ã™ã‚‹ - Qiita
èƒŒæ™¯ æœ€è¿‘ã¯å¤‰åŒ–ã—ç¶šã‘ã‚‹è¦ä»¶ã«å¯¾å¿œã™ã‚‹ãŸã‚ã«ã€ã‚·ã‚¹ãƒ†ãƒ ã‚‚æŸ”è»Ÿã§ã‚ã‚‹ã“ã¨ãŒæ±‚ã‚ã‚‰ã‚Œã¦ã„ã¾ã™ã€‚ ãã®ãŸã‚ã€éƒ¨åˆ†çš„ã«å¤‰æ›´ã‚„ã‚¹ã‚±ãƒ¼ãƒ«ã®å¯èƒ½ãªã‚·ã‚¹ãƒ†ãƒ ã‚’æ§‹ç¯‰ã—ã€APIçµŒç”±ã§é€£æºã™ã‚‹ãƒžã‚¤ã‚¯ãƒã‚µãƒ¼ãƒ“ã‚¹çš„ã‚¢ãƒ¼ã‚ãƒ†ã‚¯ãƒãƒ£ãŒå¢—ãˆã¦ãã¦ã„ã¾ã™ã€‚ ãã†ã„ã£ãŸè¨è¨ˆã®ä¸ã§å•é¡Œã«ãªã£ã¦ã„ãã®ãŒã€å¾“æ¥ã®ãƒ¢ãƒŽãƒªã‚·ãƒƒã‚¯ãªã‚¢ãƒ—ãƒªã‚±ãƒ¼ã‚·ãƒ§ãƒ³ã§ã¯IDEã‚„ã‚³ãƒ³ãƒ‘ã‚¤ãƒ©ãªã©ã§è¡Œã£ã¦ã„ãŸã€æ©Ÿèƒ½é–“ã®ã‚¤ãƒ³ã‚¿ãƒ¼ãƒ•ã‚§ã‚¤ã‚¹ã‚’ã©ã†ç®¡ç†ã™ã‚‹ã‹ã¨ã„ã†éƒ¨åˆ†ã§ã™ã€‚ Swaggerã¨ã¯? Swaggerã¨ã¯RESTful APIã®ãƒ‰ã‚ãƒ¥ãƒ¡ãƒ³ãƒˆã‚„ã€ã‚µãƒ¼ãƒã€ã‚¯ãƒ©ã‚¤ã‚¢ãƒ³ãƒˆã‚³ãƒ¼ãƒ‰ã€ã‚¨ãƒ‡ã‚£ã‚¿ã€ã¾ãŸãã‚Œã‚‰ã‚’æ‰±ã†ãŸã‚ã®ä»•æ§˜ãªã©ã‚’æä¾›ã™ã‚‹ãƒ•ãƒ¬ãƒ¼ãƒ ãƒ¯ãƒ¼ã‚¯ã§ã™ã€‚ å…¬å¼ã‚µã‚¤ãƒˆã§ã¯ã€The World's Most Popular Framework for APIsã¨è¬³ã£ã¦ã„ã¾ã™ã€‚ ãã®ç†ç”±ã¯ã€ãƒžã‚¤ã‚¯ãƒã‚½ãƒ•ãƒˆã€Googleã€IBMã€SmartBearãªã©ã‚’å¤§æ‰‹ã®ä¼æ¥ã‚’å«ã‚€ã€ŒOpen
p_tan 2018/03/13
API

REST

swagger

RESTful

OpenAPI
ãƒªãƒ³ã‚¯
1