ã¾ã APIå®ç¾©ç®¡çã§æ¶èãã¦ãã®ï¼ãSwaggerãç¨ãã大è¦æ¨¡ã¢ããªæ代ã®APIå®ç¾©ç®¡çã¨ã³ã¼ãã¸ã§ãã¬ã¼ãã for DroidKaigi 2018
2018å¹´3æ8æ¥ãUIT#2 æ ããããã«åªåãæãã¾ãªã ããã®ããã³ãã¨ã³ãã¨ã³ã¸ãã¢ãã¡ã㨠2018å¹´3æ9æ¥ãGotanda.js #10ãã«ã¦çºè¡¨ããè³æã§ãã - https://uit.connpass.com/event/79891/ - https://gotandajsâ¦
ã第5åãSwaggerã®ãããªãæ´»ç¨ Swaggerã¯ãAPIã¤ã³ã¿ãã§ã¼ã¹ä»æ§æ¸ãAPIåä½ãä½ãã ãã§ãªããAPI Gatewayãã¿ã¼ã³ã®æ§ç¯ã«ãæ´»ç¨ãããã¨ãã§ãã¾ããä¾ã¨ãã¦ä»åãSwagger Specãã¤ã³ãã¼ãããGoogleåä¸ã®Apigeeãæä¾ããAPI Gatewayã§ãããAPI Proxyããä½æãã¾ãããã
ãã¸ã¿ã«ãã¸ãã¹æ代ãè¿ããAPIé£æºã¸ã®ãã¼ãºãããã¾ã§ä»¥ä¸ã«é«ã¾ã£ã¦ããç¾å¨ãAPIä»æ§ã管çããOSSãã¬ã¼ã ã¯ã¼ã¯ãSwaggerã(ã¹ã¯ãã¬ã¼)ã大ããªæ³¨ç®ãæµ´ã³ã¦ãã¾ããæ¬é£è¼ã§ã¯ãåãã¬ã¼ã ã¯ã¼ã¯ã®æªçµé¨è ã»åå¿è ã対象ã«ããã®æ¦è¦ãåºæ¬çãªä½¿ãæ¹ã解説ãã¦ããã¾ãã ä»æ§ã¨å®è£ ã®ä¹é¢ã許ãããªãAPI ã·ã¹ãã éçºã®ãã¬ã³ãã¨ãã¦ããã¤ã¯ããµã¼ãã¹åãé²ãã§ãã¦ãã¾ããã¢ããªã¹(ä¸æ岩)ã¹ã¿ã¤ã«ã®éçºã«æ¯ã¹ã¦ãã¢ããªã±ã¼ã·ã§ã³ã®åä½ã¯å°ãããªããå¤ãã®ãµã¼ãã¹ãæ§ç¯ããã¾ãã Uberã®é è»ãã¸ãã¹ãAirbnbã®æ°æ³ã«ä»£è¡¨ããããã¸ã¿ã«ãã¸ãã¹ã«ããã¦ããAPIã¨ã³ããã¼åãé²ãã§ãã¦ãããGoogle Map APIãTwitter APIãªã©ãã¾ãã¾ãªAPIãçµã¿åããã¦ç´ æ©ãã·ã¹ãã ãæ§ç¯ãã¾ãã Programmable Webã§ã¯ã2017å¹´1ææç¹ã§16,59
# pet.yaml swagger: "2.0" info: description: "ããã¯ãããã¹ãã¢ã«é¢ããAPIã§ãã" version: "1.0.0" title: "Petstore API" termsOfService: "http://swagger.io/terms/" contact: email: "api[email protected]" license: name: "Apache 2.0" url: "http://www.apache.org/licenses/LICENSE-2.0.html" produces: - "application/json" consumes: - application/x-www-form-urlencoded paths: /pets/{petId}: get: summary: "ãããæ å ±API" descrip
ãã®è¨äºã§ã¯OpenAPI Specification v2ã«é¢ããå 容ãåãä¸ãã¦ãã¾ãããããã2023å¹´9æç¾å¨ã§ã®ææ°ã®ä»æ§ã¯OpenAPI Specification v3ã¨ãªã£ã¦ãã¾ããææ°ã®ä»æ§ã«åºã¥ãã¦å®è£ ãå¦ç¿ãè¡ãããæ¹ã¯ãå ¬å¼ããã¥ã¡ã³ããããã«é¢é£ããè³æããåç §ãã ããã ããã«ã¡ã¯ï¼ ããã¯ã¨ã³ãã¨ã³ã¸ãã¢ã®ãã»ããã§ãã 以åãããã¯ããã°ã§APIã¢ãã¯ã¨ä»æ§æ¸ãä½æãããã¨ãã§ããSwaggerã«ã¤ãã¦ãç´¹ä»ãã¾ããã Swaggerãã®ãã®ã«ã¤ãã¦ç¥ãããå ´åãSwaggerãå®éã«å°å ¥ãããå ´åã¯ããã¡ãã®è¨äºãã¨ã¦ãåèã«ãªãã¾ãã techblog.zozo.com æ¬è¨äºã§ã¯ãSwaggerã®APIå®ç¾©ãè¡ãSwagger YAMLã®è¨æ³ã«ã¤ãã¦ã¾ã¨ãã¦ã¿ã¾ããã 使ãåãã¯ã¨ã£ã¤ãã«ããSwaggerã§ããããã®è¨äºãSwaggerã使ãæ¹ã®åè
èæ¯ æè¿ã¯å¤åãç¶ããè¦ä»¶ã«å¯¾å¿ããããã«ãã·ã¹ãã ãæè»ã§ãããã¨ãæ±ãããã¦ãã¾ãã ãã®ãããé¨åçã«å¤æ´ãã¹ã±ã¼ã«ã®å¯è½ãªã·ã¹ãã ãæ§ç¯ããAPIçµç±ã§é£æºãããã¤ã¯ããµã¼ãã¹çã¢ã¼ããã¯ãã£ãå¢ãã¦ãã¦ãã¾ãã ãããã£ãè¨è¨ã®ä¸ã§åé¡ã«ãªã£ã¦ããã®ããå¾æ¥ã®ã¢ããªã·ãã¯ãªã¢ããªã±ã¼ã·ã§ã³ã§ã¯IDEãã³ã³ãã¤ã©ãªã©ã§è¡ã£ã¦ãããæ©è½éã®ã¤ã³ã¿ã¼ãã§ã¤ã¹ãã©ã管çãããã¨ããé¨åã§ãã Swaggerã¨ã¯? Swaggerã¨ã¯RESTful APIã®ããã¥ã¡ã³ããããµã¼ããã¯ã©ã¤ã¢ã³ãã³ã¼ããã¨ãã£ã¿ãã¾ãããããæ±ãããã®ä»æ§ãªã©ãæä¾ãããã¬ã¼ã ã¯ã¼ã¯ã§ãã å ¬å¼ãµã¤ãã§ã¯ãThe World's Most Popular Framework for APIsã¨è¬³ã£ã¦ãã¾ãã ãã®çç±ã¯ããã¤ã¯ãã½ãããGoogleãIBMãSmartBearãªã©ã大æã®ä¼æ¥ãå«ããOpen
MOONGIFTã¯ãªã¼ãã³ã½ã¼ã¹ã»ã½ããã¦ã§ã¢ãç´¹ä»ããããã°ã§ãã2021å¹´07æ16æ¥ã§æ´æ°åæ¢ãã¾ãã Swaggerã¯Web APIã®æ¨æºè¨è¿°ãã©ã¼ãããã¨ãã¦ç¥ããã¤ã¤ããã¾ããæ¨æºãã§ããã¨ãããã¨ã¯ãããã使ã£ã¦ããã°åããã¼ã¿ã使ã£ã¦ä»ã®ãã©ã¼ãããããµã¼ãã¹ã§ä½¿ããã¨ãã§ããããã«ãªãã¾ãã ãã§ã«ã³ã¼ãçæã©ã¤ãã©ãªãªã©ãä½ããã¦ãã¾ãããä»åã¯Swaggeråãã®ããã¥ã¡ã³ããä½ããSwagger Editorãç´¹ä»ãã¾ãã Swagger Editorã®ä½¿ãæ¹ ãã¡ããã¡ã¤ã³ç»é¢ã§ããå·¦å´ãã¨ãã£ã¿ãå³å´ã«ãã®çµæã表示ããã¾ãã ã¤ãããè¨è¿°ããä»ãJSONãè²¼ãä»ãã¦èªã¿è¾¼ã¾ãããã¨ãã§ãã¾ãã è¨å®ãå¤æ°ç¨æããã¦ãã¾ãã ã¯ã©ã¤ã¢ã³ãããµã¼ããµã¤ãã®ã³ã¼ãçæãè¡ãã¾ãããã®çµæã¯Zipãã¡ã¤ã«ã§ãã¦ã³ãã¼ãã§ãã¾ãã ä¾ãã°Rubyã®ã³ã¼ãã¯ãã®ããã«ãªã
追è¨ï¼ãã®è¨äºã¯ãã¼ã¸ã§ã³ãå¤ããã®ã§ããããæ°ããæ å ±ã«ã¤ã㦠Swagger 2.0 ã«å¯¾å¿ãã ASP.NET Web API ã®ããã¥ã¡ã³ããä½æãã ãã¡ããã覧ãã ããã ASP.NET Advent Calendar 2014 17 æ¥ç® ã®è¨äºã§ããåå㯠iwate ããã® ASP.NETããã¸ã§ã¯ãããDBã³ã³ããã¹ããåãé¢ãã¦ãã¤ã°ã¬ã¼ã·ã§ã³ãã ã§ãã ãã®è¨äºã§ã¯ãSwagger ã使ã£ã ASP.NET Web API ã®ããã¥ã¡ã³ããçæããæ¹æ³ã«ã¤ãã¦æ¸ãã¾ãã ASP.NET Web API ã®ããã¥ã¡ã³ãçæã¨ããã°ãNuGet PackageãMicrosoft.AspNet.WebApi.HelpPageãã使ãæ¹æ³ ãããã¾ãããããæ¬ ç¹ãããã¾ãã ãã®æ¬ ç¹ãã«ãã¼ã§ãã Swagger ã®æ¦è¦ã確èªããå¾ãå®éã« ASP.NET Web AP
ã©ã³ãã³ã°
ã©ã³ãã³ã°
ã©ã³ãã³ã°
ãªãªã¼ã¹ãé害æ å ±ãªã©ã®ãµã¼ãã¹ã®ãç¥ãã
ææ°ã®äººæ°ã¨ã³ããªã¼ã®é ä¿¡
å¦çãå®è¡ä¸ã§ã
j次ã®ããã¯ãã¼ã¯
kåã®ããã¯ãã¼ã¯
lãã¨ã§èªã
eã³ã¡ã³ãä¸è¦§ãéã
oãã¼ã¸ãéã
{{#tags}}- {{label}}
{{/tags}}