平静を保ち、コードを生成せよ 〜 OpenAPI Generator誕生の背景と軌跡 〜 / gunmaweb34

Gunma.web #34 スキーマ駆動開発で発表した資料です！
https://gunmaweb.connpass.com/event/113974/

(追記)
OpenAPI Generatorの電子書籍をリリースしましたのでぜひチェックしてください！

REST API のためのコード生成入門 (OpenAPI Generator)
https://gumroad.com/l/openapi_generator_ebook_jp
(/追記)

発表時から下記修正を加えました。
* サブタイトルをつけ忘れていたのを修正しました
* 一部の画面キャプチャを非表示にしました (非表示にした理由はスライドに記載しています)

Transcript

1. ʙ
   0QFO"1*
   (FOFSBUPS஀ੜͷഎܠͱي੻
   ʙ த໺
   ڿਓ
   
   ΞεΫϧגࣜձࣾ
   
   (VONBXFC
   
   εΩʔϚۦಈ։ൃ ฏ੩ΛอͪɺίʔυΛੜ੒ͤΑ
2. 8FCΞϓϦέʔγϣϯΤϯδχΞ த໺
   ڿਓ
   !/","/0@"LJIJUP ܈അݝ༢ָ܊༢ָொ
   ग़਎ IUUQTBDLJOUPTIHJUIVCJPBCPVU
3. ܈അݝ༢ָ܊༢ָொ
   ग़਎ IUUQTXXXUPXOPSBHVONBKQ
5. 044׆ಈ w0QFO"1*
   (FOFSBUPS
   wIUUQTHJUIVCDPN0QFO"1*5PPMTPQFOBQJHFOFSBUPS
   w(BOFTIB
   Ψωʔγϟ
   wIUUQTHJUIVCDPNBDLJOUPTIHBOFTIB
   w4OJEFM
   εφΠσϧ
   wIUUQTHJUIVCDPNBDLJOUPTITOJEFM
6. 8&# %#
   13&44
   7PM ಛू
   <ޮ཰ٸ্ঢ>εΩʔϚۦಈ
   8FC"1*։ൃ
   ষޙ൒ʙষΛࣥච͍͖ͤͯͨͩ͞·͠ ͨ
   !
   ײँ
   
7. Gunma.web #34 εΩʔϚۦಈ։ൃ
8. ໨࣍ wεΩʔϚۦಈ։ൃ
   w lεΩʔϚۦಈ։ൃz
   ͷىݯɺಛ௃
   w0QFO"1*
   w 0QFO"1*஀ੜͷྺ࢙ɺه๏ɺ4XBHHFS
   5PPMT
   w0QFO"1*
   (FOFSBUPS
   w ஀ੜͷഎܠɺجຊૢ࡞
   w ΧελϚΠζํ๏ɺΞϯνύλʔϯ εΩʔϚۦಈ։ൃ΍0QFO"1* ʹ͍ͭͯ֓؍ͨ͋͠ͱɺ
   ࢲͷಘҙ෼໺Ͱ͋Δ
   ίʔυੜ੒ʹ͍ͭͯ۷ΓԼ͛ ͓ͯ࿩͍͖ͯ͠·͢
9. εΩʔϚۦಈ։ൃ
10. εΩʔϚۦಈ։ൃͱ͸ w໌֬ͳఆ͕ٛ͋ΔΘ͚Ͱ͸ͳ͍
    w8&# %#
    13&44ͷಛूͰ͸POL͞ΜͷԼهͷϒϩάண૝Λಘͯ
 zεΩʔϚۦಈ։ൃzͱ͍͏λΠτϧΛ͚ͭͨ
    wεΩʔϚϑΝʔετ։ൃͷεεϝ
    wIUUQTCMPHPOLOJOKBTDIFNB@pSTU@EFWFMPQNFOU
    
11. εΩʔϚۦಈ։ൃͱ͸
    
    ։ൃͷྲྀΕͷҧ͍ Ҿ༻
    
    IUUQTCMPHPOLOJOKBTDIFNB@pSTU@EFWFMPQNFOU API هड़ݴޠҎલͷੈք: API هड़ݴޠҎޙͷੈք:
12. εΩʔϚۦಈ։ൃͱ͸
    
    ։ൃͷྲྀΕͷҧ͍ API هड़ݴޠҎલͷੈք: API هड़ݴޠҎޙͷੈք: Ҿ༻
    
    IUUQTCMPHPOLOJOKBTDIFNB@pSTU@EFWFMPQNFOU
13. εΩʔϚۦಈ։ൃͱ͸
    
    εΩʔϚͱ͸ wԿ͔͠Βͷߏ଄Λఆٛͯ͠ɺ͋ΔఆΊΒΕͨܗࣜͰهड़ͨ͠΋ͷ
    wྫ
    
    σʔλϕʔεεΩʔϚ
    
    %%-
    w8FC
    "1*Ͱ͍͏ͱʜ
    wͲͷΤϯυϙΠϯτ͕
    wͲΜͳϦΫΤετΛड෇͚Δͷ͔
    wͲΜͳϨεϙϯεΛฦ͢ͷ͔
14. εΩʔϚۦಈ։ൃͱ͸
    
    ͭ·Γ w͸͡ΊʹΈΜͳͰ૬ஊ͠ͳ͕ΒεΩʔϚΛܾΊͯɺ
    wͦΕΛ΋ͱʹฒߦͯ͠։ൃ͢Δ͜ͱ ։ൃνʔϜશମͷϫʔΫϑϩʔ Ͱ͋Δɻ ͭ·Γ
15. εΩʔϚۦಈ։ൃ
    
    ৽͍͠։ൃख๏ͱ͍͏Θ͚Ͱ͸ͳ͍ wίϯτϥΫτϑΝʔετ
    wσβΠϯϑΝʔετ Ͱ͸εΩʔϚۦಈ։ൃΛಛ௃͚ͮΔ΋ͷͱ͸ʜ ʢಉ͡ࢥ૝ͷ։ൃϑϩʔʣ
    εΩʔϚͰ։ൃΛۦಈ͢Δ͜ͱ 8FC
    "1*ͷ࢓༷Λهड़͠
    ֤छπʔϧΛ׆༻ͯ͠։ൃΛޮ཰Խ͢Δ͜ͱ
16. 8&# %#
    13&44
    7PM 8&# %#
    13&44
    7PMͷಛूͰ͸ɺ
    εΩʔϚۦಈ։ൃͷελΠϧ͕ొ৔͢Δ લ͔Βͷ։ൃख๏ͷભҠΛஈ֊తʹ͝঺ հ͍ͯ͠·͢ɻ
    εΩʔϚͰۦಈ͢Δ։ൃͷྑ͞΍ɺͦͷ ඞཁੑΛΑΓਂ͘஌Δ͜ͱ͕Ͱ͖·͢
    IUUQTHJIZPKQNBHB[JOFXEQSFTTBSDIJWFWPM
17. εΩʔϚۦಈ։ൃͱ͸
    
    εΩʔϚͱ͸
    ࠶ wԿ͔͠Βͷߏ଄Λఆٛͯ͠ɺ͋ΔఆΊΒΕͨܗࣜͰهड़ͨ͠΋ͷ
    wྫ
    
    σʔλϕʔεεΩʔϚ
    w8FC
    "1*Ͱ͍͏ͱʜ
    wͲͷΤϯυϙΠϯτ͕
    wͲΜͳϦΫΤετΛड෇͚Δͷ͔
    wͲΜͳϨεϙϯεΛฦ͢ͷ͔
18. εΩʔϚۦಈ։ൃ
    
    εΩʔϚΛهड़͢ΔϑΥʔϚοτ w0QFO"1*
    TQFDJpDBUJPO
    چ4XBHHFS
    TQFDJpDBUJPO
    w"1*
    #MVFQSJOU
    w3".- 8FC
    "1* 3&45
    "1* ͷεΩʔϚΛهड़͢ΔϑΥʔϚοτ
19. OpenAPI
20. 0QFO"1*
    
    ֓ཁ IUUQTHJUIVCDPN0"*0QFO"1*4QFDJpDBUJPO The OpenAPI Specification w0QFO"1*
    0QFO"1*
    TQFDJpDBUJPO
    wچ4XBHHFS
    TQFDJpDBUJPO
    w3&45
    "1*ͷ࢓༷Λهड़͢ΔϑΥʔϚοτ
    w0QFO"1*
    *OJUJBUJWF
    w0QFO"1*ͷϑΥʔϚοτΛਪਐ͢Δஂମ
    w.JDSPTPGUɺ(PPHMFɺ*#.ɺ4NBSU#FBSͳͲ͕ ࢀՃ
21. w೥݄
    0QFO"1*
    *OJUJBUJWF
    ݁੒
    w೥݄
    4XBHHFS
    TQFDJpDBUJPO͕0QFO"1*
    *OJUJBUJWFʹدଃ͞ΕΔ
    w4XBHHFS
    TQFDJpDBUJPO
    
    ͕0QFO"1*
    TQFDJpDBUJPO
    
    ʹϦωʔϜ͞ ΕΔ
    w೥݄
    0QFO"1*
    TQFDJpDBUJPO
    
    ϦϦʔε
    w೥݄
    ݱࡏͷόʔδϣϯ͸0QFO"1*
    TQFDJpDBUJPO
     0QFO"1*
    
    ྺ࢙ 4XBHHFSϓϩδΣΫτ 0QFO"1*
    *OJUJBUJWF 0QFO"1*
    TQFD
     4XBHHFS
    TQFD
     4XBHHFS
    UPPMT
22. 0QFO"1*
    
    ༻ޠʹ͍ͭͯͷ஫ҙࣄ߲ w0QFO"1*ͷϑΥʔϚοτͷ໊শ͸ɺݫີʹ͸
    l0QFO"1*
    4QFDJpDBUJPOz
    w௕͍ͷͰ
    0QFO"1*
    Ͱݺ͹ΕΔɻ0"4ͱུ͢͜ͱ΋͋Δ
    w0QFO"1*ͷੈքͰ͸ɺ0QFO"1*Ͱॻ͔Εͨ΋ͷΛz0QFO"1*
    υΩϡϝϯτzͱ ݺͿ
    w IUUQTHJUIVCDPN0"*0QFO"1*4QFDJpDBUJPOCMPCNBTUFSWFSTJPOTNEPQFOBQJEPDVNFOU
    w"1*ͷߏ଄Λఆٛ͢ΔʮεΩʔϚʯͱɺʮ0QFO"1*υΩϡϝϯτʯ͸ಉ͡ ΋ͷΛࢦ͢
23. 8&# %#
    13&44
    7PM εΩʔϚۦಈ։ൃ͸։ൃશମͷϫʔΫϑ ϩʔͰ͢ͷͰɺ4XBHHFS0QFO"1*΍ 3&45ͱ͍ͬͨಛఆͷπʔϧ܈΍ύϥμΠ Ϝʹݶͬͨ΋ͷͰ͸͋Γ·ͤΜɻ
    ಛूͰ͸ɺ(SBQI2-ʹΑΔεΩʔϚۦಈ ։ൃ΋঺հ͍ͯ͠·͢
    IUUQTHJIZPKQNBHB[JOFXEQSFTTBSDIJWFWPM
24. 0QFO"1*
    
    ϑΥʔϚοτ IUUQTCMPHSFBENFJPBOFYBNQMFpMMFEHVJEFUPTXBHHFS
25. 0QFO"1*
    
    ϑΥʔϚοτ
    ϝλ৘ใ IUUQTCMPHSFBENFJPBOFYBNQMFpMMFEHVJEFUPTXBHHFS
26. 0QFO"1*
    
    ϑΥʔϚοτ
    ΤϯυϙΠϯτ IUUQTCMPHSFBENFJPBOFYBNQMFpMMFEHVJEFUPTXBHHFS
27. 0QFO"1*
    
    ϑΥʔϚοτ
    ίϯϙʔωϯτ IUUQTCMPHSFBENFJPBOFYBNQMFpMMFEHVJEFUPTXBHHFS
28. 8&# %#
    13&44
    7PM 8&# %#
    13&44
    7PMͷಛूͰ͸ɺ
    0QFO"1*υΩϡϝϯτΛߏ੒͢Δ༷ʑͳ ΦϒδΣΫτΛৄࡉʹղઆ͍ͯ͠·͢ɻ
    ۩ମతͳه๏ɾ஫ҙ఺΍هड़ͨ͠ 0QFO"1*υΩϡϝϯτͷ؅ཧํ๏ͳͲΛ ஌Δ͜ͱ͕Ͱ͖·͢ IUUQTHJIZPKQNBHB[JOFXEQSFTTBSDIJWFWPM
29. εΩʔϚۦಈ։ൃͱ͸
    ࠶ w͸͡ΊʹΈΜͳͰ૬ஊ͠ͳ͕ΒεΩʔϚΛܾΊͯɺ
    wͦΕΛ΋ͱʹฒߦͯ͠։ൃ͢Δ͜ͱ ։ൃνʔϜશମͷϫʔΫϑϩʔ Ͱ͋Δɻ ͭ·Γ πʔϧͷࢧԉ͕ඞཁ
30. Swagger Tools
31. 0QFO"1*
    
    4XBHHFS
    5PPMT w4XBHHFS
    &EJUPS
    w0QFO"1*υΩϡϝϯτ εΩʔϚ ͷهड़Λࢧԉ
    wIUUQTFEJUPSTXBHHFSJP
    w4XBHHFS
    6*
    w"1*࢓༷Λࢹ֮ԽɺΠϯλϥΫςΟϒͳ"1*ૢ࡞
    wIUUQTQFUTUPSFTXBHHFSJP
    w4XBHHFS
    $PEFHFO
    w0QFO"1*υΩϡϝϯτ͔ΒιʔείʔυΛࣗಈੜ੒
32. 0QFO"1*
    
    εΩʔϚۦಈ։ൃͱ4XBHHFS
    5PPMT IUUQTCMPHPOLOJOKBTDIFNB@pSTU@EFWFMPQNFOU API هड़ݴޠҎޙͷੈք 0QFO"1*υΩϡϝϯτͷهड़ ࢓༷ͷڞ༗ɾ֬ೝ ελϒੜ੒ػೳΛར༻ͨ͠εΩϟϑΥʔϧσΟϯά ੜ੒ͨ͠ελϒΛར༻ͨ͠ฏߦ։ൃ ੜ੒ͨ͠ΫϥΠΞϯτΛར༻ͨ͠޻਺࡟ݮ ςετίʔυͷࣗಈੜ੒ Swagger Editor Swagger UI Swagger Codegen
33. 0QFO"1*υΩϡϝϯτͷهड़ ࢓༷ͷڞ༗ɾ֬ೝ Swagger Editor Swagger UI 0QFO"1*
    
    ίʔυੜ੒ͷԸܙ͸େ͖͍ IUUQTCMPHPOLOJOKBTDIFNB@pSTU@EFWFMPQNFOU API هड़ݴޠҎޙͷੈք ελϒੜ੒ػೳΛར༻ͨ͠εΩϟϑΥʔϧσΟϯά ੜ੒ͨ͠ελϒΛར༻ͨ͠ฏߦ։ൃ ੜ੒ͨ͠ΫϥΠΞϯτΛར༻ͨ͠޻਺࡟ݮ ςετίʔυͷࣗಈੜ੒ Swagger Codegen
34. OpenAPI Generator
35. 0QFO"1*
    (FOFSBUPS
    
    ֓ཁ w೥݄ʹ஀ੜ
    w4XBHHFS
    $PEFHFO
    W
    ͔ΒϑΥʔΫ
    wαϙʔτ͢ΔݴޠɾϑϨʔϜϫʔΫ͸Ҏ্
    w0QFO"1*
    ʹରԠ
    w0QFO"1*
    *OJUJBUJWFͱ͸ؔ܎ͳ͍
    w 0"*഑ԼͷϓϩδΣΫτͩͱؒҧΘΕΔ͜ͱ͕͋Δ IUUQTPQFOBQJHFOFSBUPSUFDI
36. OpenAPI Generator ϑΥʔΫͷഎܠͱ͜Ε·Ͱͷي੻
37. 0QFO"1*
    (FOFSBUPS
    
    ϑΥʔΫͷഎܠ
    4NBSU#FBSࣾͷίϛϡχςΟܰࢹ w4XBHHFS
    $PEFHFOͷ։ൃ͸
    4NBSU#FBS͕ࣾओಋ͍ͯ͠Δ
    w೥ʹ4XBHHFSϓϩδΣΫτͷεϙϯαʔγοϓΛ4NBSU#FBS͕ࣾҾ ͖ܧ͍ͩ
    w IUUQTRJJUBDPNSJOBYTVNPNPJUFNTCFFFBFFEDG
    w೥݄ʹ0QFO"1*
    ͕ϦϦʔε͞Εɺ֤044ϓϩδΣΫτ΍༗ঈαʔ Ϗε͸ͦͷରԠʹணख
    w͔͠͠ɺ4XBHHFS
    $PEFHFO͸೥ॳΊʹͳͬͯ΋ରԠ͕ਐΜͰ͓Βͣڝ ߹͔Β஗ΕΛͱ͍ͬͯͨ
    wʹ΋ؔΘΒͣ4NBSU#FBSࣾ͸0QFO"1*
    ରԠͱ͸ؔ܎ແ͍େ͖ͳվमΛ
    lಠ அͰz
    ߦ͏
38. wϦϙδτϦͷ෼ׂ 0QFO"1*
    (FOFSBUPS
    
    ϑΥʔΫͷഎܠ
    ಠஅͰߦΘΕͨେ͖ͳվम TXBHHFSDPEFHFO TXBHHFSDPEFHFOHFOFSBUPST
39. 0QFO"1*
    (FOFSBUPS
    
    ϑΥʔΫͷഎܠ
    ίϛϡχςΟʹ޿͕Δෆ৴ײ wಠஅͰਐΜͰ͍͘։ൃํ਑ʹ͍ͭͯɺίϛϡχςΟ͔Β੠্͕͕Δ͕ɺฉ͖ೖ ΕΒΕͳ͍ ൃද࣌͸ɺ౰࣌ͷঢ়گΛΑΓϦΞϧʹ఻͑ΔͨΊʹJTTVFͳͲͷ
    ը໘ΩϟϓνϟΛ͜͜ʹೖΕ͍ͯ·͕ͨ͠ɺ
    ಛఆͷݸਓ΁ͷ൷൑ʹܨ͕Γ͔Ͷͳ͍ͨΊɺެ։͢ΔεϥΠυͰ͸߇͍͖͑ͤͯͨͩ͞·͢
40. wϨϏϡʔΛ௨ͣ͞ʹςετίʔυΛҰؾʹແޮԽ 0QFO"1*
    (FOFSBUPS
    
    ϑΥʔΫͷഎܠ
    ίϛϡχςΟʹ޿͕Δෆ৴ײ ൃද࣌͸ɺ౰࣌ͷঢ়گΛΑΓϦΞϧʹ఻͑ΔͨΊʹJTTVFͳͲͷ
    ը໘ΩϟϓνϟΛ͜͜ʹೖΕ͍ͯ·͕ͨ͠ɺ
    ಛఆͷݸਓ΁ͷ൷൑ʹܨ͕Γ͔Ͷͳ͍ͨΊɺެ։͢ΔεϥΠυͰ͸߇͍͖͑ͤͯͨͩ͞·͢
41. ೥ʹ4NBSU#FBS͕ࣾεϙϯαʔγοϓΛҾ͖ܧ͍ͩͱ͖ͷهࣄ w 5POZ5BNࢯ 4XBHHFSϓϩδΣΫτ૑࢝ऀͷͻͱΓ ͕4NBSU#FBSࣾΛબΜͩཧ༝ Λޠ͍ͬͯΔ IUUQTXXXJOGPRDPNOFXTTXBHHFSGPVOEFSXIBUTOFYU ൴Β 4NBSU#FBS ͕
 ࣗݾརӹͷͨΊ͚ͩʹ
    4XBHHFSΛར༻͢Δ͜ͱ͸ͳ͍
    ͱ֬৴͍ͯ͠Δ ݱࡏͷৼΔ෣͍͔Β͸
    ͦͷΑ͏ʹ͸ײ͡ΒΕͳ͘
    ͳ͍ͬͯΔ
    
42. ։ൃίϛϡχςΟ͸
    4NBSU#FBSࣾͷϏδωεʹແঈͰߩݙ͢Δ
    ϘϥϯςΟΞͰ͸ͳ͍
43. w4NBSU#FBSࣾͷ։ൃίϛϡχςΟΛܰࢹͨ͠ಈ͖ʹɺࠞཚͨ͠Γٙ໰Λ๊͘։ ൃऀ͕ͨͪग़ͯ͘Δ
    w͜ͷঢ়گΛվળ͢ΔͨΊʹ8JMMJBN τοϓίϯτϦϏϡʔλ ͕4NBSU#FBSࣾ ͱ࿩͠߹͍ΛॏͶΔ
    w͕ɺ4NBSU#FBSࣾ͸શ͘ฉ͖ೖΕͳ͔ͬͨ
    w8JMMJBN͸4NBSU#FBSࣾͷઆಘΛఘΊɺࠓޙʹ͍ͭͯ։ൃίϛϡχςΟͱ࿩͠ ߹ͬͨ 4XBHHFS
    $PEFHFOΛϑΥʔΫͯ͠ผͷϓϩδΣΫτͱͯ͠
    ίϛϡχςΟɾυϦϒϯͳ։ൃΛਐΊΔ͜ͱΛܾΊΔ William(@wing328) (2018೥3݄ࠒ) 0QFO"1*
    (FOFSBUPS
    
    ϑΥʔΫͷഎܠ
    ৽ϓϩδΣΫτͷελʔτ
44. w8JMMJBNͷݺͼ͔͚Ͱू·ͬͨਓҎ্ͷίϯτϦϏϡʔλʹΑͬͯ0QFO"1*
    (FOFSBUPSͷॳظ։ൃ͕ߦΘΕͨ
    wϓϩδΣΫτͷެ։·Ͱ͸ϓϥΠϕʔτϦϙδτϦͰ։ൃ
    w0QFO"1*
    ରԠͷͨΊʹҎ্ͷϓϧϦΫΤετ͕ग़͞Εͨ
    wܞΘͬͨϝϯόʔ͸3&"%.&ʹ'PVOEJOH
    .FNCFSͱͯ͠ܝࡌ͞Ε͍ͯΔ
    w IUUQTHJUIVCDPN0QFO"1*5PPMTPQFOBQJHFOFSBUPSGPVOEJOHNFNCFSTBMQIBCFUJDBMPSEFS
    w0QFO"1*
    ͷରԠ͕Ұ௨Γ׬ྃ͠ɺ೥݄೔ʹϕʔλ൛ͱͯ͠ެ։ 0QFO"1*
    (FOFSBUPS
    
    ॳظ։ൃΛܦͯϕʔλ൛Λެ։
45. 
    ϦϙδτϦΛެ։ 
    ࠷ॳͷ҆ఆ൛ΛϦϦʔε
46. 0QFO"1*
    (FOFSBUPS
    
    ೝ஌౓ͷߴ·Γ ϒϩά ٕज़ܥϝσΟΞ ެࣜ5XJUUFSΞΧ΢ϯτ (JU)VCελʔ਺
47. w-JOPEFࣾ
    w0QFO"1*
    (FOFSBUPS
    0OMJOFΛϗετ͍ͯ͠ ΔαʔόʔΛ-JOPEF͔ࣾΒఏڙ͍͍ͯͨͩ͠ ͍ͯΔ
    w63-
    
    IUUQBQJPQFOBQJHFOFSBUPSUFDI
    w ˞
    0QFO"1*
    (FOFSBUPS
    0OMJOF
    w ίʔυੜ੒αʔόʔͷػೳ
    w IUUQTHJUIVCDPN0QFO"1*5PPMTPQFOBQJHFOFSBUPSCMPCNBTUFS EPDTPOMJOFNE 0QFO"1*
    (FOFSBUPS
    
    اۀ͔Βͷαϙʔτ IUUQTXXXMJOPEFDPN
48. 0QFO"1*
    (FOFSBUPS
    
    Ϣʔβʔͷ֦େ IUUQTPQFOBQJHFOFSBUPSUFDIVTFSTIUNM w׆༻͍͍͍ͯͨͩͯ͠ΔاۀΛ
 υΩϡϝϯταΠτʹܝࡌ
    w΢ν΋࢖ͬͯΔΑʂͱ͍͏͔ͨ͸ ͥͻϓϧϦΫΤετΛ͍ͩ͘͞
    
    wl&EJU
    UIJT
    QBHFz
    ͷϦϯΫ͔Β
 ϓϧϦΫΤετΛग़ͤ·͢ʂ
49. 0QFO"1*
    (FOFSBUPS
    
    ఆظతͳϦϦʔε wύονϦϦʔε
    
    ִि
    wޙํޓ׵ੑͷ͋Δมߋ
    wϚΠφʔϦϦʔε
    
    ִ݄
    wޙํޓ׵ੑͷͳ͍มߋ
    w Φϓγϣϯ౳ͰҎલͷڍಈΛ࠶ݱՄ
    wϝδϟʔϦϦʔε
    
    ൒೥ຖ
    wޙํޓ׵ੑͷͳ͍มߋ IUUQTHJUIVCDPN0QFO"1*5PPMTPQFOBQJHFOFSBUPSXJLJ(JU#SBODIFT
50. 0QFO"1*
    (FOFSBUPS
    
    ։ൃίϛϡχςΟ w 3&"%.&
    
    l"CPVU
    VTz
    IUUQTHJUIVCDPN0QFO"1*5PPMTPQFOBQJHFOFSBUPSBCPVUVT
    w5FNQMBUF
    $SFBUPS
    wݴޠɺϑϨʔϜϫʔΫͳͲͷςϯϓϨʔτΛ࡞੒ͨ͠ਓͨͪ
    w5FDIOJDBM
    $PNNJUUFF
    wಛఆͷݴޠ޲͚ͷJTTVFɾ13ͷϨϏϡʔͳͲΛߦ͏ਓͨͪ
    w$PSF
    5FBN
    wϓϩδΣΫτʹϓϥεʹͳΔͰ͋Ζ͏ࣄΛ΍Δਓͨͪ
    wϚʔδݖݶ͋Γ
51. 0QFO"1*
    (FOFSBUPS
    
    ΑΓڧ͍ίϛϡχςΟ΁ w0QFO"1*
    (FOFSBUPS͸
    lίϛϡχςΟओମz
    ͷϓϩδΣΫτ
    w΋ͬͱͨ͘͞Μͷ։ൃऀʹؔΘ͍͖͍ͬͯͨͩͨ
    w৽͍͠໾ׂΛ৽ઃͯ͠ɺΞΫςΟϒʹ׆ಈ͞Ε͍ͯΔํʹϚʔδݖݶΛ౉ͯ͠ ͍͘ࢼΈ͕Ұ෦ࢼݧతʹ࢝·͍ͬͯΔ ϓϩδΣΫτͷԣ΁ͷ޿͕Γ͚ͩͰͳ͘
    ؔ৺ͷߴ͍։ൃऀ͸ΑΓਂؔ͘Θ͍͚ͬͯΔΑ͏ॎͷ޿͕Γ΋࡞͍ͬͯ͘
52. 0QFO"1*
    (FOFSBUPS
    
    ΑΓڧ͍ίϛϡχςΟ΁ ಺෦ߏ଄ͷϦϑΝΫλϦϯά ৽͍͠δΣωϨʔλͷ࣮૷ 0QFO"1*
    ରԠͷڧԽ ։ൃͷϩʔυϚοϓ
53. ,&&1
    $"-.
    BOE
    (&/&3"5&
    $0%&
54. 0QFO"1*υΩϡϝϯτͷهड़ ࢓༷ͷڞ༗ɾ֬ೝ Swagger Editor Swagger UI 0QFO"1*
    (FOFSBUPSͰίʔυੜ੒͢Δ IUUQTCMPHPOLOJOKBTDIFNB@pSTU@EFWFMPQNFOU API هड़ݴޠҎޙͷੈք ελϒੜ੒ػೳΛར༻ͨ͠εΩϟϑΥʔϧσΟϯά ੜ੒ͨ͠ελϒΛར༻ͨ͠ฏߦ։ൃ ੜ੒ͨ͠ΫϥΠΞϯτΛར༻ͨ͠޻਺࡟ݮ ςετίʔυͷࣗಈੜ੒ OpenAPI Generator
55. OpenAPI Generator ͸͡Ί͔ͨ
56. υΩϡϝϯταΠτ 5IBOLT
    !KJNTDIVCFSU
    ✨ IUUQTPQFOBQJHFOFSBUPSUFDI ࠷ۙυΩϡϝϯταΠτ͕Ͱ͖·ͨ͠ʂ
57. 0QFO"1*
    (FOFSBUPSͷ͸͡Ί͔ͨ
    
    ଟ༷ͳΠϯλʔϑΣʔε wίϚϯυ
    w)PNFCSFXɺOQNɺ%PDLFSΠϝʔδɺKBSϑΝΠϧ
    wϏϧυπʔϧͷϓϥάΠϯ
    w.BWFOɺ(SBEMF
    w0QFO"1*
    (FOFSBUPS
    0OMJOF
    wίʔυੜ੒༻ͷ)551αʔόʔΛࣾ಺౳ʹཱͯΔػೳ
58. 0QFO"1*
    (FOFSBUPSͷ͸͡Ί͔ͨ
    
    جຊίϚϯυ αϒίϚϯυ 0QFO"1*
    υΩϡϝϯτͷύε δΣωϨʔλ໊
    ੜ੒͢ΔݴޠɾϑϨʔϜϫʔΫͳͲ ग़ྗઌ
59. 0QFO"1*
    (FOFSBUPSͷ͸͡Ί͔ͨ
    
    ੜ੒͞ΕΔϑΝΠϧͷྫ ྫ
    
    1)1ΫϥΠΞϯτ "1* Ϟσϧ υΩϡϝϯτ ੜ੒͞Εͨ"1*ΫϥΠΞϯτ΍Ϟσϧͷ࢓༷͕
 ϚʔΫμ΢ϯͰॻ͔ΕͨυΩϡϝϯτ
60. 0QFO"1*
    (FOFSBUPSͷ͸͡Ί͔ͨ
    
    ੜ੒͞ΕΔϑΝΠϧͷྫ ྫ
    
    1)1ΫϥΠΞϯτ "1*ΫϥΠΞϯτΫϥε
61. 0QFO"1*
    (FOFSBUPSͷ͸͡Ί͔ͨ
    
    ੜ੒͞ΕΔϑΝΠϧͷྫ ྫ
    
    1)1ΫϥΠΞϯτ Ϟσϧ
62. 0QFO"1*
    (FOFSBUPSͷ͸͡Ί͔ͨ
    
    ੜ੒͞ΕΔϑΝΠϧͷྫ ྫ
    
    1)1ΫϥΠΞϯτ ςετ 1)16OJUΛ࢖ͬͨςετίʔυ
 ͷΨϫ͚͕ͩੜ੒͞ΕΔ
    ɹɹɹɹɹ
63. 0QFO"1*
    (FOFSBUPSͷ͸͡Ί͔ͨ
    
    جຊίϚϯυ ͲΜͳαϒίϚϯυ͕͋Δͷ͔஌Γ͍ͨͱ͖
    
    ɹˠ
    lIFMQz
    αϒίϚϯυ αϒίϚϯυʹࢦఆͰ͖ΔΦϓγϣϯΛ஌Γ͍ͨͱ͖
    
    ɹˠzIFMQ
    \αϒίϚϯυ^z
64. 0QFO"1*
    (FOFSBUPSͷ͸͡Ί͔ͨ
    
    جຊίϚϯυ δΣωϨʔλݻ༗ͷΦϓγϣϯΛ஌Γ͍ͨͱ͖
    
    ྫ
    1)1ΫϥΠΞϯτ
    ɹˠ
    lDPOpHIFMQz
    αϒίϚϯυ ͲΜͳδΣωϨʔλ H
    Φϓγϣϯͷ஋ ͕͋Δͷ͔஌Γ͍ͨͱ͖
    
    ɹˠ
    Ҿ਺ΛԿ΋ࢦఆ͠ͳ͍
65. OpenAPI Generator ͷग़ྗΛΧελϚΠζ͢Δ
66. 0QFO"1*
    (FOFSBUPS
    
    ύοέʔδ໊Λࢦఆ͢Δ wŠBQJQBDLBHF
    wŠNPEFMQBDLBHF
67. 0QFO"1*
    (FOFSBUPS
    
    ੜ੒͢ΔϑΝΠϧΛݶఆ͢Δ wϞσϧ͚ͩੜ੒͢Δ৔߹
    l%NPEFMTz wͦͷଞ
    w%BQJTɺ%TVQQPSUJOH'JMFT
    wςετ͸ཁΒͳ͍৔߹
    w%NPEFM5FTUTGBMTFɺ%BQJ5FTUTGBMTF
68. 0QFO"1*
    (FOFSBUPS
    
    ੜ੒͢ΔܕΛࢦఆ͢Δ wŠUZQFNBQQJOHT
    ͰܕͷϚοϐϯάΛࢦఆ͢Δ ྫ
    
    ೔࣌Λѻ͏ΫϥεͰ͸
    -PDBM%BUF5JNF
    Λ࢖͍͍ͨ৔߹
69. 0QFO"1*
    (FOFSBUPS
    
    ΠϯϥΠϯͰఆٛͨ͠Ϟσϧͷ໊લΛࢦఆ͢Δ ࣗಈతʹ෇༩͞ΕΔϞσϧ໊͕ඍົͳͱ͖͸ʜ
70. 0QFO"1*
    (FOFSBUPS
    
    ΠϯϥΠϯͰఆٛͨ͠Ϟσϧͷ໊લΛࢦఆ͢Δ ˠ
    εοΩϦʂ
    w $PNNVOJUZϞσϧͷ
    lNFNCFSTz
    ϓϩύςΟʹ
    w l.FNCFSz
    Ϟσϧͷ഑ྻΛ࣋ͭΑ͏ʹͳΔ 0QFO"1*υΩϡϝϯτͷ
    lUJUMFz
    ଐੑΛࢦఆ͢Δ͜ͱͰɺ
71. OpenAPI Generator ͦͷଞ΋Ζ΋Ζ
72. 0QFO"1*
    (FOFSBUPS
    
    ੜ੒࣌ͷϩά͕͏Δ͍͞ͱ͖ l%MPHMFWFMz
    ͰϩάϨϕϧΛࢦఆ͢Δ
73. 0QFO"1*
    (FOFSBUPS
    
    ্ॻ͖ͷڍಈΛ੍ޚ͍ͨ͠ͱ͖ wҰ཯Ͱ্ॻ͖ͨ͘͠ͳ͍৔߹͸
    lŠTLJQPWFSXSJUFz
    Φϓγϣϯ
    w͜·੍͔͘ޚ͍ͨ͠৔߹͸
    PQFOBQJHFOFSBUPSJHOPSF
    ϑΝΠϧΛ࢖͏
    wHJUJHOPSF
    ͱಉ͡Α͏ͳจ๏ ͢΂ͯͷCVJMETI ϧʔτͷCVJMETI EPDT഑Լ͢΂ͯ EPDT6TFS"QJNE͸্ॻ͖͢Δ TSD഑Լͷ"QJ͸্ॻ͖͠ͳ͍
74. 0QFO"1*
    (FOFSBUPS
    
    0QFO"1*υΩϡϝϯτͷόϦσʔγϣϯ εΩʔϚۦಈ։ൃΛ࣮ફ͢Δ͜ͱͰ։ൃͷޮ཰্͕͕ͬͨʂ࠷ߴʂ
    Ͱ΋ɺ0QFO"1*υΩϡϝϯτΛϛεͳ͘ॻ͘ͷ͸େมʜɻ
    ϨϏϡʔͰຖճ
    4XBHHFS
    &EJUPS
    Λ࢖ͬͯΤϥʔ͕ͳ͍͔֬ೝ͢Δ ͷ͸໘౗ͩ͠ɻྑ͍ํ๏͕ͳ͍͔ͳ͊ʜ lWBMJEBUFz
    αϒίϚϯυΛ࢖͑͹
    0QFO"1*υΩϡϝϯτͷจ๏νΣοΫΛ
    $*
    Ͱग़དྷ·͢
75. 0QFO"1*
    (FOFSBUPS
    
    0QFO"1*υΩϡϝϯτͷόϦσʔγϣϯ wσϑΥϧτͰɺίʔυੜ੒࣌ʹ΋όϦσʔγϣϯ͕૸͍ͬͯΔ
    wlWBMJEBUFz
    αϒίϚϯυ͸
    !UBYQPO
    ͞Μ͕࣮૷ͯͩͬͨ͘͠͞
    !
    ײँ ิ଍ ࣮ߦྫ
    
    ඞਢͷϑΟʔϧυ͕ൈ͚͍ͯͨͱ͖ !UBYQPO
76. ίʔυੜ੒࣌ʹࢦఆ͢Δ৭ʑͳΦϓγϣϯͷψέ΍ϒϨ͕ͳ͍Α͏ ʹ౷Ұ͍ͨ͠ɻ͋ͱ࢖͏0QFO"1*
    (FOFSBUPSͷόʔδϣϯ΋ɻ
    8JOEPXT΍Β.BD΍ΒϝϯόʔʹΑͬͯ৭ʑ͔ͩΒͦͷ΁Μ΋ߟྀ ͠ͳ͍ͱʜ 0QFO"1*
    (FOFSBUPS
    
    ։ൃϝϯόʔ಺Ͱॾʑ౷Ұ͍ͨ͠
77. wΦϓγϣϯΛ+40/ϑΝΠϧʹ·ͱΊ͓͍ͯͯɺzDz
    ΦϓγϣϯͰύεΛ౉͢
    w+40/ϑΝΠϧ͸όʔδϣϯ؅ཧ͢Δ w.BWFOɺ(SBEMFΛ࢖͍ͬͯΔϓϩδΣΫτͳΒɺϓϥάΠϯΛ࢖͏ͷ͕Ұ൪ ྑͦ͞͏
    wΦϓγϣϯ΋ϏϧυπʔϧͷઃఆϑΝΠϧʹॻ͚Δ 
    ࢦఆ͢ΔΦϓγϣϯͷψέɾϒϨΛ๷ࢭ 
    0QFO"1*
    (FOFSBUPSͷόʔδϣϯΛ౷Ұ 0QFO"1*
    (FOFSBUPS
    
    ։ൃϝϯόʔ಺Ͱॾʑ౷Ұ͍ͨ͠
78. "1*αʔόʔͷιʔείʔυʹॻ͍ͨΞϊςʔγϣϯ͔Β0QFO"1*υ ΩϡϝϯτΛੜ੒͢Δํ๏΋͋ΔΈ͍ͨɻ
    0QFO"1*υΩϡϝϯτΛઌʹهड़͢Δํ๏ͱɺͲ͕͍͍ͬͪͷʁ εΩʔϚۦಈ։ൃΛߦ͏ͳΒ͹ɺ
    0QFO"1*υΩϡϝϯτ εΩʔϚ Λઌʹهड़͠·͠ΐ͏ αʔόʔͷίʔυ͔ΒυΩϡϝϯτΛੜ੒͢Δํ๏΋͋Δ͚Ͳʁ
79. w͸͡ΊʹεΩʔϚΛΈΜͳͰ૬ஊ͠ͳ͕ΒܾΊͯɺͦΕΛ΋ͱʹαʔόʔͱΫ ϥΠΞϯτΛฒߦͯ͠։ൃ͢Δ͜ͱͰޮ཰Λ্͛Δͷ͕εΩʔϚۦಈ։ൃ
    wͳͷͰɺ0QFO"1*υΩϡϝϯτΛઌʹهड़͢Δ wαʔόʔͱΫϥΠΞϯτͷ։ൃ͕෼཭͍ͯ͠Δ৔߹
    wྫ
    
    ,VCFSOFUFTͷ3&45
    "1*
    wl,VCFSOFUFTͷ։ൃz
    ͱ
    l,VCFSOFUFT ͷ3&45
    "1* Λ࢖͏ΫϥΠΞϯτz
    ͷ։ൃϑϩʔ͸෼཭͍ͯ͠Δ
    w IUUQTHJUIVCDPNLVCFSOFUFTDPNNVOJUZCMPCNBTUFSDPOUSJCVUPSTEFWFMTJHBQJNBDIJOFSZHFOFSBUJOHDMJFOUTFUNE 
    ҰํͰɺ"1*αʔόʔͷίʔυ͔Β0QFO"1*υΩϡϝϯτΛੜ੒ͨ͠ํ͕ྑ͍৔߹ͱ͸ʁ αʔόʔͷίʔυ͔ΒυΩϡϝϯτΛੜ੒͢Δํ๏΋͋Δ͚Ͳʁ
80. ͦ͏͍͑͹ੜ੒ͨ͠ίʔυͷϥΠηϯεͬͯͲ͏ͳΔͷʁ 0QFO"1*
    (FOFSBUPS
    
    ੜ੒ͨ͠ίʔυͷϥΠηϯε͸ʁ ੜ੒ͨ͠ίʔυ͸Ϣʔβʔ͕ॴ༗͢Δ΋ͷͰ͋Γ
 ໨తʹԠͯࣗ͡༝ʹϥΠηϯεΛద༻͢Δ͜ͱ͕Ͱ͖·͢ IUUQTHJUIVCDPN0QFO"1*5PPMTPQFOBQJHFOFSBUPSMJDFOTFJOGPSNBUJPOPOHFOFSBUFEDPEF
81. ίʔυੜ੒ Ξϯνύλʔϯ
82. ίʔυੜ੒ͷΞϯνύλʔϯ wमਖ਼ͨ͠Օॴ͕࣍ճੜ੒࣌ʹ্ॻ͖͞Εͯ͠·͏
    wͱ͸͍͑ɺ্ॻ͖͠ͳ͍ͱ"1*ఆٛͱίʔυ͕ဃ཭ͯ͠͠·͏ ੜ੒ͨ͠ίʔυʹखͰमਖ਼ΛՃ͑Δ
83. (FOFSBUJPO
    (BQύλʔϯʹΑΔղܾ wࣗಈੜ੒͢Δίʔυ͸৮Βͳ͍
    wॲཧΛ௥Ճ͍ͨ͠৔߹͸ܧঝɾҕৡ౳Λ࢖͏ (FOFSBUJPO
    (BQύλʔϯ IUUQTXXXIZVLJDPNEQEQJOGPIUNM(FOFSBUJPO(BQ 0QFO"1*
    (FOFSBUPSͷ
    εΩϟϑΥʔϧυ༻్Ͱߟ͑ͨ৔߹ͷ ελϒαʔόʔੜ੒ػೳͰɺ
    (FOFSBUJPO
    (BQύλʔϯͷ࣮ફΛࢧԉ͢ΔࢼΈ͕͞Ε͍ͯΔͷͰ঺հ͠·͢
    
84. w4MJN
    1)1
    ͷ৔߹
    wW͔Β͸ɺίϯτϩʔϥ͸ந৅ΫϥεΛੜ੒͢ΔΑ͏ʹͳͬͨ
    wIUUQTHJUIVCDPN0QFO"1*5PPMTPQFOBQJHFOFSBUPSQVMM
    w4QSJOH
    +BWB
    ͷ৔߹
    wlJOUFSGBDF0OMZz
    ͱ͍͏Φϓγϣϯ͕͋Δ
    wIUUQTHJUIVCDPN0QFO"1*5PPMTPQFOBQJHFOFSBUPSCMPCNBTUFS EPDTHFOFSBUPSTTQSJOHNE 0QFO"1*
    (FOFSBUPS
    
    (FOFSBUJPO
    (BQύλʔϯΛద༻͢Δ
85. 0QFO"1*
    (FOFSBUPS
    
    (FOFSBUJPO
    (BQύλʔϯΛద༻͢Δ w͜ͷΑ͏ͳػೳ͸δΣωϨʔλʹΑͬͯαϙʔτঢ়گ͕͞·͟·
    wΈͳ͞Μ͕ར༻͍ͨ͠δΣωϨʔλͰαϙʔτ͕ෆे෼ͳ৔߹͸ͥͻJTTVFΛ ্͛ͯΈ͍ͯͩ͘͞
    w΋ͪΖΜϓϧϦΫΤετ΋େ׻ܴͰ͢
86. 0QFO"1*
    (FOFSBUPS
    
    ϓϧϦΫνϟϯε͔΋ wੜ੒ͨ͠ίʔυʹखΛೖΕͨ͘ͳͬͨͱ͖ɺ
    w΋͔ͨ͠͠Βͦͷमਖ਼͸0QFO"1*
    (FOFSBUPSࣗମʹೖΕͨํ͕ྑ͍ͷ͔΋͠ Ε·ͤΜ
    wϓϧϦΫνϟϯε͔΋
    wࠃ಺ΤϯδχΞ޲͚ͷ
    (JUUFS
    νϟοτϧʔϜ͕͋Γ·͢ͷͰࠔΓ͝ͱ͕͋Ε ͹ͥͻؾܰʹ
    wIUUQTHJUUFSJNPQFOBQJHFOFSBUPSKBQBOFTF-PCCZ
87. ίʔυੜ੒Λ׆༻ͯ͠
    ޮ཰తͳ։ൃΛʂ
88. Έͳ͞Μͷ͝ࢀՃΛ͓଴͍ͪͯ͠·͢ʂ
89. ,&&1
    $"-.
    BOE
    (&/&3"5&
    $0%&