{"id":12739,"date":"2016-12-19T10:00:03","date_gmt":"2016-12-19T01:00:03","guid":{"rendered":"http:\/\/www.techscore.com\/blog\/?p=12739"},"modified":"2018-11-14T16:33:43","modified_gmt":"2018-11-14T07:33:43","slug":"swagger%e3%81%a7rest-api%e3%82%92%e8%a8%98%e8%bf%b0%e3%81%99%e3%82%8b%e3%81%93%e3%81%a8%e3%81%ab%e3%81%a4%e3%81%84%e3%81%a6%e5%83%95%e3%81%8c%e6%80%9d%e3%81%86%e3%81%93%e3%81%a8","status":"publish","type":"post","link":"https:\/\/www.techscore.com\/blog\/2016\/12\/19\/swagger%e3%81%a7rest-api%e3%82%92%e8%a8%98%e8%bf%b0%e3%81%99%e3%82%8b%e3%81%93%e3%81%a8%e3%81%ab%e3%81%a4%e3%81%84%e3%81%a6%e5%83%95%e3%81%8c%e6%80%9d%e3%81%86%e3%81%93%e3%81%a8\/","title":{"rendered":"Swagger\u3067REST API\u3092\u8a18\u8ff0\u3059\u308b\u3053\u3068\u306b\u3064\u3044\u3066\u50d5\u304c\u601d\u3046\u3053\u3068"},"content":{"rendered":"

\u3053\u308c\u306f\u3001 TECHSCORE Advent Calendar 2016 TECHSCORE BLOG<\/a> \u306e19\u65e5\u76ee\u306e\u8a18\u4e8b\u3067\u3059\u3002<\/p>\n

\u6700\u8fd1\u3001\u5f0a\u793e\u306e\u3068\u3042\u308b\u30d7\u30ed\u30b8\u30a7\u30af\u30c8\u3067Swagger\u3092\u4f7f\u3044\u59cb\u3081\u307e\u3057\u305f\u3002Swagger\u3068\u306f\u3001\u7c21\u5358\u306b\u8a00\u3063\u3066\u3057\u307e\u3046\u3068REST API\u3092\u8a18\u8ff0\u3059\u308b\u30eb\u30fc\u30eb(Swagger Specification)\u3068\u305d\u308c\u306b\u95a2\u9023\u3059\u308b\u30c4\u30fc\u30eb\u7fa4\u3067\u3059\u3002<\/p>\n

\u5f53\u7136\u306a\u304c\u3089\u3001Swagger\u3092\u4f7f\u308f\u306a\u304f\u3066\u3082REST API\u306e\u4ed5\u69d8\u3092\u66f8\u304f\u3053\u3068\u306f\u3067\u304d\u307e\u3059\uff08\u305f\u3068\u3048\u3070Excel\u306a\u3069\u3067\uff09\u3002<\/p>\n

\u65b0\u3057\u3044\u6280\u8853\u3092\u5c0e\u5165\u3059\u308b\u5834\u5408\u3001\u5b66\u7fd2\u30b3\u30b9\u30c8\u306f\u304b\u304b\u308a\u307e\u3059\u3057\u3044\u308d\u3044\u308d\u3068\u82e6\u52b4\u3059\u308b\u3053\u3068\u304c\u591a\u3044\u306e\u304c\u5e38\u3067\u3059\u304c\u3001\u3069\u3046\u3057\u3066\u308f\u3056\u308f\u3056Swagger\u3092\u4f7f\u3046\u306e\u3067\u3057\u3087\u3046\u304b\u3002Swagger\u3092\u4f7f\u3046\u3068\u4f55\u304c\u3046\u308c\u3057\u3044\u306e\u3067\u3057\u3087\u3046\u3002<\/p>\n

Swagger\u3092\u4f7f\u3063\u3066\u3046\u308c\u3057\u3044\u3053\u3068<\/h2>\n

Swagger\u3068\u305d\u308c\u3089(\u305f\u3068\u3048\u3070Excel\u3092\u4f7f\u3063\u305f\u5834\u5408)\u306e\u5927\u304d\u306a\u9055\u3044\u306f\u3001\u300cREST API\u306e\u4ed5\u69d8\u3092\u8a18\u8ff0\u3059\u308b\u30eb\u30fc\u30eb\uff08\u30d5\u30a9\u30fc\u30de\u30c3\u30c8\uff09\u304c\u3042\u3089\u304b\u3058\u3081\u5b9a\u3081\u3089\u308c\u3066\u3044\u308b\u70b9\u300d\u3001\u305d\u3057\u3066\u300c\u30b3\u30f3\u30d4\u30e5\u30fc\u30bf\u3068\u4eba\u9593\u304c\u6271\u3044\u3084\u3059\u3044YAML\u3084JSON\u3067\u66f8\u304b\u308c\u308b\u70b9\u300d\u306b\u3042\u308a\u307e\u3059\u3002<\/p>\n

\u30eb\u30fc\u30eb\u306b\u5f93\u3063\u3066REST API\u306e\u4ed5\u69d8\u3092\u8a18\u8ff0\u3059\u308b\u3053\u3068\u3067\u3001\u4ed5\u69d8\u3084\u30c9\u30ad\u30e5\u30e1\u30f3\u30c8\u304c\u5185\u5bb9\u3068\u3057\u3066\u5fc5\u8981\u5341\u5206\u306b\u306a\u308b\u3068\u540c\u6642\u306b\u3001\u958b\u767a\u8005\u540c\u58eb\u3082\u3057\u304f\u306f\u30b5\u30fc\u30d3\u30b9\u63d0\u4f9b\u8005\u3068\u5229\u7528\u8005\u306e\u9593\u3067\u30b3\u30df\u30e5\u30cb\u30b1\u30fc\u30b7\u30e7\u30f3\u304c\u53d6\u308a\u3084\u3059\u304f\u306a\u308a\u307e\u3059\u3002\u4e00\u5b9a\u306e\u30eb\u30fc\u30eb\u306b\u3082\u3068\u3065\u3044\u3066\u8a18\u8ff0\u3055\u308c\u305fREST API\u306e\u4ed5\u69d8\u306f\u3001\u7406\u89e3\u3057\u3084\u3059\u304f\u8b70\u8ad6\u306e\u30d9\u30fc\u30b9\u306b\u3082\u306a\u308a\u307e\u3059\u3002<\/p>\n

\u307e\u305f\u3001YAML\u3084JSON\u3067\u66f8\u304b\u308c\u308b\u3053\u3068\u306b\u3088\u3063\u3066\u3001\u8a18\u8ff0\u3055\u308c\u305fAPI\u306e\u4ed5\u69d8\u3092\u5404\u7a2e\u30c4\u30fc\u30eb\u304b\u3089\u6271\u3046\u3053\u3068\u3092\u5bb9\u6613\u306b\u3057\u307e\u3059\u3002<\/p>\n

Swagger\u3067\u306f\u3001Swagger Editor\u3084Swagger UI\u306a\u3069\u306e\u30c4\u30fc\u30eb\u3092\u4f7f\u3046\u3053\u3068\u3067\u3001\u30c9\u30ad\u30e5\u30e1\u30f3\u30c8\u306e\u751f\u6210\u3084API\u306e\u5b9f\u884c\u3001\u3055\u3089\u306b\u306f\u30af\u30e9\u30a4\u30a2\u30f3\u30c8SDK\u3084\u30b5\u30fc\u30d0\u5074\u306e\u5b9f\u88c5\u306e\u3072\u306a\u5f62\u3092\u751f\u6210\u3059\u308b\u3053\u3068\u304c\u53ef\u80fd\u3067\u3059\u3002<\/p>\n

\u4f8b\u3068\u3057\u3066\u3001Swagger Editor\u3092\u898b\u3066\u307f\u307e\u3057\u3087\u3046\u3002
\n\"swagger_editor_full-1\"<\/a>\uff08\u753b\u50cf\u306fSwagger Editor<\/a>\u306e\u30c8\u30c3\u30d7\u30da\u30fc\u30b8\u304b\u3089\u5f15\u7528\uff09<\/p>\n

\u5de6\u5074\u304c\u30e6\u30fc\u30b6\u306e\u8a18\u8ff0\u3059\u308bYAML\u3067\u3001\u53f3\u5074\u304c\u305d\u3053\u304b\u3089\u751f\u6210\u3055\u308c\u305f\u30c9\u30ad\u30e5\u30e1\u30f3\u30c8\u3067\u3059\uff08\u753b\u50cf\u3060\u3051\u3060\u3068\u5206\u304b\u308a\u306b\u304f\u3044\u3068\u601d\u3044\u307e\u3059\u306e\u3067\u3001\u3053\u3061\u3089<\/a>\u304b\u3089\u5b9f\u969b\u306e\u753b\u9762\u3092\u3054\u89a7\u304f\u3060\u3055\u3044\u3002\uff09<\/p>\n

\u5de6\u5074\u3067YAML\u3092\u7de8\u96c6\u3057\u3066\u3044\u304f\u3068\u3001\u30ea\u30a2\u30eb\u30bf\u30a4\u30e0\u306b\u53f3\u5074\u306e\u30c9\u30ad\u30e5\u30e1\u30f3\u30c8\u304c\u66f4\u65b0\u3055\u308c\u3066\u3044\u304f\u306e\u3067\u3001\u7d50\u679c\u3092\u78ba\u8a8d\u3057\u306a\u304c\u3089\u7de8\u96c6\u3059\u308b\u3053\u3068\u304c\u3067\u304d\u307e\u3059\u3002<\/p>\n

\u307e\u305f\u3001\u3053\u306e\u753b\u9762\u304b\u3089API\u306e\u5b9f\u884c\u3084\u30b3\u30fc\u30c9\u306e\u751f\u6210\u3082\u5b9f\u884c\u53ef\u80fd\u3067\u3059\u3002<\/p>\n

\u3053\u306e\u3088\u3046\u306b\u3001\u30c4\u30fc\u30eb\u3092\u4f7f\u3044\u3053\u306a\u3059\u3053\u3068\u3067\u3001\u958b\u767a\u8005\u306f\u3088\u308a\u4fa1\u5024\u306e\u9ad8\u3044\u4f5c\u696d\u306e\u307b\u3046\u3078\u96c6\u4e2d\u3067\u304d\u308b\u3088\u3046\u306b\u306a\u308a\u307e\u3059\uff08\u5404\u8a00\u8a9e\u3054\u3068\u306e\u30af\u30e9\u30a4\u30a2\u30f3\u30c8SDK\u3092\u81ea\u52d5\u751f\u6210\u3067\u304d\u308b\u306e\u306f\u3001\u3046\u308c\u3057\u3044\u3067\u3059\u3088\u306d\uff1f\uff09\u3002<\/p>\n

\u305d\u308c\u4ee5\u5916\u306eSwagger\u3092\u5229\u7528\u3059\u308b\u30e1\u30ea\u30c3\u30c8\u3068\u3057\u3066\u306f\u3001Swagger\u3067\u66f8\u304b\u308c\u305fAPI\u306e\u4ed5\u69d8\u306f\u901a\u5e38\u30c6\u30ad\u30b9\u30c8\u30d5\u30a1\u30a4\u30eb\u3068\u3057\u3066\u4fdd\u5b58\u3055\u308c\u308b\u305f\u3081\u3001\u30d0\u30fc\u30b8\u30e7\u30f3\u7ba1\u7406\u30b7\u30b9\u30c6\u30e0\u3068\u76f8\u6027\u304c\u826f\u304f\u5dee\u5206\u306e\u78ba\u8a8d\u304c\u5bb9\u6613\u3067\u3059\u3002<\/p>\n

\u5b89\u5fc3\u3057\u3066Swagger\u3092\u4f7f\u3063\u3066\u826f\u3044\uff1f<\/h2>\n

REST API\u306e\u4ed5\u69d8\u306e\u8a18\u8ff0\u306e\u6a19\u6e96\u5316\u3092\u76ee\u6307\u3059Open API Initiative(Google\u3084Microsoft\u3001IBM\u304c\u53c2\u52a0)\u3084\u3001AWS\u306eAmazon API Gateway\u3067\u306fSwagger\u304c\u63a1\u7528\u3055\u308c\u3066\u3044\u308b\u306e\u3067\u3001\u5b9f\u7e3e\u306f\u3042\u308b\u3068\u8a00\u3048\u308b\u3067\u3057\u3087\u3046\u3002<\/p>\n

\u4f7f\u3063\u3066\u307f\u305f\u611f\u899a\u7684\u306b\u306f\u3001API\u306e\u4ed5\u69d8\u3092\u8a18\u8ff0\u3057\u3001\u30c9\u30ad\u30e5\u30e1\u30f3\u30c8\u3092\u751f\u6210\u3059\u308b\u306e\u306f\u554f\u984c\u306a\u304f\u5b9f\u884c\u3067\u304d\u307e\u3059\u3002\u305f\u3060\u3057\u3001\u30b3\u30fc\u30c9\u751f\u6210(Swagger Codegen\u3068\u3044\u3046\u30c4\u30fc\u30eb\u3092\u4f7f\u3044\u307e\u3059)\u306f\u3001\u307e\u3060\u767a\u5c55\u9014\u4e0a\u306e\u5370\u8c61\u3092\u53d7\u3051\u307e\u3057\u305f\u3002\u30d0\u30fc\u30b8\u30e7\u30f3\u3054\u3068\u306e\u5909\u66f4\u304c\u591a\u304f\u3001\u30d0\u30b0\u306e\u5831\u544a\u3082\u591a\u3044\u3088\u3046\u306b\u898b\u53d7\u3051\u3089\u308c\u307e\u3059\u3002\uff08\u5b9f\u969b\u3044\u304f\u3064\u304b\u8e0f\u307f\u307e\u3057\u305f\uff09<\/p>\n

Swagger\u3068\u540c\u3058\u76ee\u7684\u3067\u4f7f\u3048\u308b\u4ed5\u69d8\u30fb\u30c4\u30fc\u30eb\u3068\u3057\u3066\u306f\u3001RAML\u3068API Blueprint\u304c\u30e1\u30b8\u30e3\u30fc\u306a\u3088\u3046\u3067\u3059\u304c\u3001Swagger\u304c\u3082\u3063\u3068\u3082\u666e\u53ca\u3057\u3066\u3044\u308b\u3088\u3046\u3067\u3059\uff08Google\u3067\u306e\u691c\u7d22\u7d50\u679c\u3084Google Trends\u3092\u898b\u308b\u3068\uff09\u3002<\/p>\n

\u304a\u308f\u308a\u306b<\/h2>\n

\u306f\u3058\u3081\u3066Swagger\u3092\u8abf\u3079\u305f\u6642\u3001\u305d\u308c\u304c\u3044\u3063\u305f\u3044\u3069\u3046\u3044\u3046\u3082\u306e\u306a\u306e\u304b\u3001\u306a\u304b\u306a\u304b\u6349\u3048\u308b\u3053\u3068\u304c\u3067\u304d\u307e\u305b\u3093\u3067\u3057\u305f\u3002<\/p>\n

Swagger\u306fREST API\u306e\u4ed5\u69d8\u3092\u8a18\u8ff0\u3059\u308b\u305f\u3081\u306e\u30eb\u30fc\u30eb\u3068\u305d\u308c\u3092\u6271\u3046\u30c4\u30fc\u30eb\u7fa4\u304b\u3089\u6210\u308a\u7acb\u3063\u3066\u3044\u3066\u3001\u305d\u306e\u4e8c\u3064\u306e\u95a2\u4fc2\u3092\u982d\u306e\u4e2d\u3067\u4e0a\u624b\u304f\u6574\u7406\u3067\u304d\u3066\u3044\u306a\u304b\u3063\u305f\u305f\u3081\u3060\u3068\u601d\u3044\u307e\u3059\u3002<\/p>\n

\"API Description Languages\"\u3068\u3044\u3046\u8a00\u8449\u304c\u3042\u308b\u306b\u306f\u3042\u308b\u3088\u3046\u3067\u3001Swagger\u3082\u305d\u3053\u306b\u5206\u985e\u3055\u308c\u3066\u3044\u305f\u308a\u3057\u307e\u3059\u304c\u3001Swagger\u306fAPI\u3092\u8a18\u8ff0\u3059\u308b\u8a00\u8a9e\uff08\u30eb\u30fc\u30eb\uff09\u3068\u30c4\u30fc\u30eb\u3092\u5408\u308f\u305b\u305f\u30a8\u30b3\u30b7\u30b9\u30c6\u30e0\u304c\u7279\u5fb4\u7684\u3067\u3059\u3002Swagger\u81ea\u8eab\u3068\u3057\u3066\u3082\u305d\u3053\u3092\u5f37\u307f\u3068\u3057\u3066\u63a8\u3057\u3066\u3044\u308b\u611f\u3058\u304c\u3057\u307e\u3059\u3002<\/p>\n

\u305f\u3060\u3001Swagger\u306e\u516c\u5f0f\u30b5\u30a4\u30c8\u306e\u30c8\u30c3\u30d7\u30da\u30fc\u30b8<\/a>\u306b\u3042\u308b\u3088\u3046\u306b\u3001\u300cTHE WORLD'S MOST POPULAR API FRAMEWORK\u300d\u3068\u3044\u308f\u308c\u3066\u3057\u307e\u3046\u3068\u3001\u306a\u3093\u3060\u304b\u3088\u304f\u5206\u304b\u3089\u306a\u304f\u306a\u3063\u3066\u3057\u307e\u3046\u306e\u3067\u3057\u305f\u3002<\/p>\n","protected":false},"excerpt":{"rendered":"

\u3053\u308c\u306f\u3001 TECHSCORE Advent Calendar 2016 TECHSCORE BLOG \u306e19\u65e5\u76ee\u306e\u8a18\u4e8b\u3067\u3059\u3002<\/p>\n

\u6700\u8fd1\u3001\u5f0a\u793e\u306e\u3068\u3042\u308b\u30d7\u30ed\u30b8\u30a7\u30af\u30c8\u3067Swagger\u3092\u4f7f\u3044\u59cb\u3081\u307e\u3057\u305f\u3002
\u7d9a\u304d\u3092\u8aad\u3080...<\/a><\/p>\n","protected":false},"author":58,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[239,18],"tags":[141,250],"_links":{"self":[{"href":"https:\/\/www.techscore.com\/blog\/wp-json\/wp\/v2\/posts\/12739"}],"collection":[{"href":"https:\/\/www.techscore.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.techscore.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.techscore.com\/blog\/wp-json\/wp\/v2\/users\/58"}],"replies":[{"embeddable":true,"href":"https:\/\/www.techscore.com\/blog\/wp-json\/wp\/v2\/comments?post=12739"}],"version-history":[{"count":283,"href":"https:\/\/www.techscore.com\/blog\/wp-json\/wp\/v2\/posts\/12739\/revisions"}],"predecessor-version":[{"id":13509,"href":"https:\/\/www.techscore.com\/blog\/wp-json\/wp\/v2\/posts\/12739\/revisions\/13509"}],"wp:attachment":[{"href":"https:\/\/www.techscore.com\/blog\/wp-json\/wp\/v2\/media?parent=12739"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.techscore.com\/blog\/wp-json\/wp\/v2\/categories?post=12739"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.techscore.com\/blog\/wp-json\/wp\/v2\/tags?post=12739"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}