[B! OpenAPI] nekoruriã®ãƒ–ãƒƒã‚¯ãƒžãƒ¼ã‚¯

nekoruri id:nekoruri

OpenAPIã«é–¢ã™ã‚‹nekoruriã®ãƒ–ãƒƒã‚¯ãƒžãƒ¼ã‚¯ (6)

${{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}}

TypeSpecã§OpenAPIãƒ‰ã‚ãƒ¥ãƒ¡ãƒ³ãƒˆã‚’åŠ¹çŽ‡çš„ã«ä½œæˆã—ã€åž‹å®‰å…¨ãªREST APIé€šä¿¡ã‚’å®Ÿç¾ã™ã‚‹æ–¹æ³• - GMO MAKESHOP engineer blog
GMOãƒ¡ã‚¤ã‚¯ã‚·ãƒ§ãƒƒãƒ—ã‚³ã‚¢ã‚°ãƒ«ãƒ¼ãƒ—ã®åŽŸç”°ã§ã™ã€‚ãƒ•ãƒãƒ³ãƒˆã‚¨ãƒ³ãƒ‰ã¨ãƒãƒƒã‚¯ã‚¨ãƒ³ãƒ‰é–“ã®REST APIã‚„ã‚Šå–ã‚Šã«åž‹å®šç¾©ãŒç„¡ã„ã¨ã„ã†èª²é¡ŒãŒã‚ã£ãŸãŸã‚ã€OpenAPIãƒ‰ã‚ãƒ¥ãƒ¡ãƒ³ãƒˆã‚’ä½œæˆã€ãã‚Œã‚’å…ƒã«ã—ãŸåž‹å®šç¾©ã‚’ãƒ•ãƒãƒ³ãƒˆã‚¨ãƒ³ãƒ‰ã§åˆ©ç”¨ã§ãã‚‹ã‚ˆã†ã«ã—ã¾ã—ãŸã€‚ä»Šå›žã¯ã€OpenAPIãƒ‰ã‚ãƒ¥ãƒ¡ãƒ³ãƒˆã‚’æ›¸ããŸã‚ã«åˆ©ç”¨ã—ãŸTypeSpecã‚’ã”ç´¹ä»‹ã—ã¾ã™ã€‚ èª²é¡Œ è§£æ±ºç– TypeSpecã¨ã¯? TypeSpecã®è¨˜æ³• ãƒ¢ãƒ‡ãƒ«å®šç¾© ã‚¨ã‚¤ãƒªã‚¢ã‚¹ ã‚¹ã‚«ãƒ©ãƒ¼ å®šæ•°å®šç¾© ãƒ«ãƒ¼ãƒ†ã‚£ãƒ³ã‚°ãƒ‡ã‚³ãƒ¬ãƒ¼ã‚¿ãƒ¼ ã‚¸ã‚§ãƒãƒªã‚¯ã‚¹ TypeSpecã®ã‚³ãƒ³ãƒ‘ã‚¤ãƒ«æ–¹æ³• TypeSpecã®ã‚³ãƒ³ãƒ‘ã‚¤ãƒ«çµæžœ åˆ©ç”¨ã—ã¦ã¿ãŸæ„Ÿæƒ³ ã¾ã¨ã‚ å‚è€ƒè³‡æ–™ èª²é¡Œ æ¬¡ä¸–ä»£ECç®¡ç†ç”»é¢ã§ã¯SPAã‚’æŽ¡ç”¨ã—ã¦ãŠã‚Šã€ãƒãƒƒã‚¯ã‚¨ãƒ³ãƒ‰ã¨ã®ã‚„ã‚Šå–ã‚ŠãŒé »ç¹ã«ç™ºç”Ÿã—ã¾ã™ã€‚ã‚„ã‚Šå–ã‚Šæ–¹æ³•ã«GraphQLã‚’ä½¿ã†ã‚¨ãƒ³ãƒ‰ãƒã‚¤ãƒ³ãƒˆã¯ graphql-codegenã‚’ç”¨ã„ãŸåž‹å®šç¾©ãŒå˜åœ¨ã—ã¾ã™ãŒã€REST APIã¸ã®
nekoruri 2024/12/16
openapi

typespec
ãƒªãƒ³ã‚¯
OpenAPI Spec ã‚’å‡ºåŠ›ã§ãã‚‹ DSLã€TypeSpec ã®å®Ÿè·µä¾‹ - ãƒ‰ãƒ¯ãƒ³ã‚´æ•™è‚²ã‚µãƒ¼ãƒ“ã‚¹é–‹ç™ºè€…ãƒ–ãƒã‚°
ã“ã®è¨˜äº‹ã¯ãƒ‰ãƒ¯ãƒ³ã‚´ Advent Calendar 2024ã® 1 æ—¥ç›®ã®è¨˜äº‹ã§ã™ã€‚ ã¯ã˜ã‚ã« ã“ã‚“ã«ã¡ã¯ã€‚ZEN IDã®é–‹ç™ºã‚’ã—ã¦ã„ã‚‹ã€ã‚¨ãƒ³ã‚¸ãƒ‹ã‚¢ã®ãƒ¦ãƒ¼ãƒ³ã§ã™ã€‚ æ ªå¼ä¼šç¤¾ãƒ‰ãƒ¯ãƒ³ã‚´ã¯å…ˆæ—¥2024å¹´11æœˆ16æ—¥ã«é–‹å‚¬ã•ã‚ŒãŸæ—¥æœ¬æœ€å¤§ç´šã®TypeScriptã‚’ãƒ†ãƒ¼ãƒžã¨ã—ãŸæŠ€è¡“ã‚«ãƒ³ãƒ•ã‚¡ãƒ¬ãƒ³ã‚¹ TSKaigi Kansai 2024 ã«ãƒ—ãƒ©ãƒãƒŠã‚¹ãƒãƒ³ã‚µãƒ¼ã¨ã—ã¦å”è³›ã„ãŸã—ã¾ã—ãŸã€‚ ãƒ‰ãƒ¯ãƒ³ã‚´ã®ã‚¹ãƒãƒ³ã‚µãƒ¼ãƒ–ãƒ¼ã‚¹ ç§ã¯å€‹äººã§ã‚»ãƒƒã‚·ãƒ§ãƒ³ã€Œåž‹ä»˜ã API ãƒªã‚¯ã‚¨ã‚¹ãƒˆã‚’å®Ÿç¾ã™ã‚‹ã„ãã¤ã‹ã®æ‰‹æ³•ã¨ãã®é¸æŠžã€ã‚’ç™ºè¡¨ã—ã€OpenAPI ã‚’ä¸å¿ƒã¨ã—ãŸæ‰‹æ³•ã‚’ä¸€ä¾‹ã¨ã—ã¦ç´¹ä»‹ã—ã¾ã—ãŸã€‚ speakerdeck.com ã“ã®ã‚»ãƒƒã‚·ãƒ§ãƒ³ã§ OpenAPI ã‚’è¨˜è¿°ã™ã‚‹æ‰‹æ®µã¨ã—ã¦ç´¹ä»‹ã—ãŸ TypeSpec ã«ã¤ã„ã¦ã€ ZEN ID ã§ã®å®Ÿè·µä¾‹ã‚’äº¤ãˆã¦æ·±ãå–ã‚Šä¸Šã’ã¾ã™ã€‚ OpenAPI ã®æ‰‹æ›¸ãã«ç–²ã‚ŒãŸæ–¹ã€ã¾ãŸ TypeSpec ã‚’ä½¿ã„å§‹
nekoruri 2024/12/16
openapi

typespec
ãƒªãƒ³ã‚¯
OpenAPIã ã£ã¦Lintã—ãŸã„ - Qiita
$ spectral lint petstore.yaml /work/petstore.yaml 2:6 warning info-contact Info object must have "contact" object. info 2:6 warning info-description Info "description" must be present and non-empty string. info 11:9 warning operation-description Operation "description" must be present and non-empty string. paths./pets.get 15:11 warning operation-tag-defined Operation tags must be defined in global
nekoruri 2024/02/12
OpenAPI
ãƒªãƒ³ã‚¯
OpenAPIä»•æ§˜ãªAPIã®æ›´æ–°ç›£è¦–ã«ã¤ã„ã¦ - Qiita
èƒŒæ™¯ ç§é”ã®ãƒ—ãƒãƒ€ã‚¯ãƒˆã§ã¯ã€å¤–éƒ¨ã‚µãƒ¼ãƒ“ã‚¹ã¨ã®é€£æºæ©Ÿèƒ½ã‚’æä¾›ã—ã¦ã„ã¾ã™ã€‚ ã“ã‚Œã‚‰ã®æ©Ÿèƒ½ã¯ã€å¤–éƒ¨ã‚µãƒ¼ãƒ“ã‚¹ãŒå…¬é–‹ã—ã¦ã„ã‚‹OpenAPIä»•æ§˜ã®APIãƒ‰ã‚ãƒ¥ãƒ¡ãƒ³ãƒˆã«åŸºã¥ã„ã¦å®Ÿè£…ã•ã‚Œã¦ã„ã¾ã™ã€‚é€£æºå…ˆã‚µãƒ¼ãƒ“ã‚¹ã®ä»•æ§˜å¤‰æ›´ã¯ç§é”ãŒã‚³ãƒ³ãƒˆãƒãƒ¼ãƒ«ã§ãã‚‹ã‚‚ã®ã§ã¯ãªãã€é€£æºå…ˆã®éƒ½åˆã«ã‚ˆã‚Šå®Ÿæ–½ã•ã‚Œã¾ã™ã€‚ ãã®ä¸ã«ã¯ç§é”ã®æä¾›æ©Ÿèƒ½ã«ç›´æŽ¥çš„ãªå½±éŸ¿ã‚’ä¸Žãˆã‚‹ç ´å£Šçš„ãªå¤‰æ›´ã‚‚å«ã¾ã‚Œã¾ã™ã€‚ã“ã‚Œã‚‰ã®å¤‰æ›´ã‚’è¿…é€Ÿã«å¯ŸçŸ¥ã—ã€é©åˆ‡ã«å¯¾å¿œã§ãã‚‹ã‚ˆã†ã«ã—ãŸã„ã€ã¨ã„ã†ã®ãŒç™ºç«¯ã§ã™ã€‚ ç›£è¦–æ–¹æ³•ã®æŽ¢ç´¢ æœ€åˆã®ã‚¢ãƒ—ãƒãƒ¼ãƒã¨ã—ã¦ã€APIä»•æ§˜æ›¸ã®å¤‰æ›´ã‚’æ¤œçŸ¥ã™ã‚‹ãŸã‚ã«å¤å…¸çš„ãªdiffã‚³ãƒžãƒ³ãƒ‰ã®åˆ©ç”¨ã‚’æ¤œè¨Žã—ã¾ã—ãŸã€‚ ã—ã‹ã—ã€ä»•æ§˜æ›¸ãŒJSONã‚„YAMLå½¢å¼ã§è¨˜è¿°ã•ã‚Œã¦ã„ã‚‹ãŸã‚ã€å˜ãªã‚‹ãƒ†ã‚ã‚¹ãƒˆæ¯”è¼ƒã§ã¯å¤‰æ›´ã®å½±éŸ¿ã‚’æ£ç¢ºã«åˆ¤æ–ã™ã‚‹ã®ãŒé›£ã—ã„ã“ã¨ã¯æ˜Žã‚‰ã‹ã§ã™ã€‚ ä¾‹ãˆã°ã€ãƒ¬ã‚¹ãƒãƒ³ã‚¹ã®ã‚¹ã‚ãƒ¼ãƒžå®šç¾©ãŒå¤‰æ›´ã•ã‚ŒãŸå ´åˆã€ãã®å½±éŸ¿ç¯„å›²ã‚’æ£ã—ãæŠŠæ¡ã™ã‚‹ã«ã¯ã€å„ä½¿ç”¨ç®‡æ‰€ã‚’è©³ç´°ã«æ¤œè¨¼ã™ã‚‹
nekoruri 2024/02/03
oasdiffè‰¯ã•ãã†

OpenAPI
ãƒªãƒ³ã‚¯
openapi-generatorã‚’ä½¿ã£ã¦OpenAPIå®šç¾©ãƒ•ã‚¡ã‚¤ãƒ«ã‹ã‚‰Goã‚³ãƒ¼ãƒ‰ã‚’ç”Ÿæˆã™ã‚‹ - LayerX ã‚¨ãƒ³ã‚¸ãƒ‹ã‚¢ãƒ–ãƒã‚°
ã“ã‚“ã«ã¡ã¯ã€ãƒã‚¯ãƒ©ã‚¯äº‹æ¥éƒ¨ ãƒã‚¯ãƒ©ã‚¯ãƒ“ã‚¸ãƒã‚¹ã‚«ãƒ¼ãƒ‰é–‹ç™ºãƒãƒ¼ãƒ ã§EMã¨TechLeadã‚’æ‹…å½“ã—ã¦ã„ã‚‹é«˜æ±Ÿ @shnjtk ã§ã™ã€‚ ä»Šå›žã¯ã€openapi-generator ã‚’ä½¿ã£ã¦OpenAPIå®šç¾©ãƒ•ã‚¡ã‚¤ãƒ«(OpenAPI Specification)ã‹ã‚‰Goã®ã‚³ãƒ¼ãƒ‰ã‚’ç”Ÿæˆã™ã‚‹æ–¹æ³•ã¨ã€é‹ç”¨æ™‚ã®Tipsã«ã¤ã„ã¦ã”ç´¹ä»‹ã—ã¾ã™ã€‚ èƒŒæ™¯ ãƒã‚¯ãƒ©ã‚¯äº‹æ¥éƒ¨ã§ã¯ã€ã‚¹ã‚ãƒ¼ãƒžé§†å‹•é–‹ç™ºã«ã‚ˆã‚ŠDBã‚„GraphQLã®ã‚¹ã‚ãƒ¼ãƒžå®šç¾©ã€OpenAPIå®šç¾©ãƒ•ã‚¡ã‚¤ãƒ«ãªã©ã‹ã‚‰è‡ªå‹•ç”Ÿæˆã•ã‚ŒãŸã‚³ãƒ¼ãƒ‰ã‚’ç©æ¥µçš„ã«åˆ©ç”¨ã™ã‚‹é–‹ç™ºã‚¹ã‚¿ã‚¤ãƒ«ãŒæŽ¡ç”¨ã•ã‚Œã¦ã„ã¾ã™ã€‚ OpenAPIã«ã¤ã„ã¦ã¯ã€ã“ã‚Œã¾ã§ã¯ go-swagger ã‚’åˆ©ç”¨ã—ã¦ã„ã¾ã—ãŸãŒã€å¯¾å¿œã—ã¦ã„ã‚‹ãƒãƒ¼ã‚¸ãƒ§ãƒ³ãŒ OpenAPI v2.0 ã¾ã§ã§ã‚ã‚‹ãŸã‚ã€OpenAPI v3.0 ã«æº–æ‹ ã—ãŸOpenAPIå®šç¾©ãƒ•ã‚¡ã‚¤ãƒ«ã‹ã‚‰ã¯ã‚³ãƒ¼ãƒ‰ã®ç”ŸæˆãŒã§ãã¾ã›ã‚“ã§ã—ãŸã€‚ è‡ªç¤¾é–‹ç™ºã®APIã§ã‚ã‚Œã°ãƒãƒ¼ã‚¸ãƒ§
nekoruri 2023/07/27
LayerX

golang

OpenAPI
ãƒªãƒ³ã‚¯
OpenAPIãƒ‰ã‚ãƒ¥ãƒ¡ãƒ³ãƒˆã‹ã‚‰å…¨APIã®è‡ªå‹•ãƒ†ã‚¹ãƒˆã‚’ç”Ÿæˆã™ã‚‹ - Qiita
ã¯ã˜ã‚ã« ã‚°ãƒãƒ¼ã‚¹ã‚¨ã‚¯ã‚¹ãƒ‘ãƒ¼ãƒˆãƒŠãƒ¼ã‚º Advent Calendar 2020 3æ—¥ç›®ã€‚ yitoã§ã™ã€‚ APIé–‹ç™ºã‚’ã—ã¦ã„ã‚‹ä¸ã§ã€ãƒ†ã‚¹ãƒˆã™ã‚‹ã®ã«æ¯Žå›žã‚¯ãƒ©ã‚¤ã‚¢ãƒ³ãƒˆãƒ„ãƒ¼ãƒ«ã«ãƒªã‚¯ã‚¨ã‚¹ãƒˆã‚’ç”¨æ„ã—ã¦APIã‚’å‘¼ã³å‡ºã™ã®ãŒæ‰‹é–“ã§ã—ãŸã€‚ ãã‚Œã‚’ã€ã‚³ãƒžãƒ³ãƒ‰ä¸€ç™ºã§ã€APIä»•æ§˜æ›¸ã«å®šç¾©ã—ãŸå…¨ã¦ã®APIã‚’ãƒ†ã‚¹ãƒˆã§ãã‚‹ã‚ˆã†ã«ã—ãŸã®ã§ã€ãã®æ–¹æ³•ã‚’ç´¹ä»‹ã—ã¾ã™ã€‚ æ¦‚è¦ OpenAPIãƒ‰ã‚ãƒ¥ãƒ¡ãƒ³ãƒˆã‚’APIã‚¯ãƒ©ã‚¤ã‚¢ãƒ³ãƒˆãƒ„ãƒ¼ãƒ«ã§åˆ©ç”¨å¯èƒ½ãªJSONã«å¤‰æ›ã—ã€ãã‚Œã‚’CLIãƒ©ã‚¤ãƒ–ãƒ©ãƒªã§å®Ÿè¡Œã—ã¾ã™ã€‚ ã“ã‚Œã‚’å®Ÿç¾ã™ã‚‹ã€ä»¥ä¸‹ã«ã¤ã„ã¦é †ç•ªã«èª¬æ˜Žã—ã¦ã„ãã¾ã™ã€‚ Postmanã«ã¤ã„ã¦ OpenAPI 3.0 to Postman Collection v2.1.0 Converter Postman Collection SDK newman Postmanã«ã¤ã„ã¦ APIãƒªã‚¯ã‚¨ã‚¹ãƒˆã®ã‚¯ãƒ©ã‚¤ã‚¢ãƒ³ãƒˆãƒ„ãƒ¼ãƒ«ã«PostmanãŒã‚ã‚Šã¾ã™ã€‚ Post
nekoruri 2020/12/03
OpenAPI
ãƒªãƒ³ã‚¯
1