Awesome Web API Design ੒ޭ͢Δ8FC
"1*σβΠϯͱ͸ Ϋϥ΢υɾϚΠΫϩαʔϏεษڧձ 

ͱ͍͏࿩͸͠·ͤΜ 

8FC
"1*ઃܭͷ
ྑॻΛಡΈ·͠ΐ͏ʂ ͋ͱͰ঺հ͠·͢ 

ຊ೔ͷλΠτϧ 

΍͸ΓԶͷ Web API͸ ·͕͍ͪͬͯΔɻ ͱ͋Δ3&45ͷߟ࡯ه࿥ Ϋϥ΢υɾϚΠΫϩαʔϏεษڧձ 

ࣗݾ঺հ 名前 ジョブ スキル こざけ しんいち システムアーキテクト Java 資格 アプリケーションエンジニア テクニカルエンジニア（DB） 安全確保支援士 

"CPVU
3&45 

8IZ
3&45 "+"9Λۦ࢖ͨ͠8FC։ൃ εϚʔτϑΥϯͷීٴ खܰʹࢼͤΔ

༧ଌ͠΍͍͢ 

σʔλ࿈ܞ ෼ࢄΦϒδΣΫτ 8FCαʔϏε 8FC
"1* +BWB3.*ɾ&+# $03#" 9.-31$ 40"1 3&45 3&45͸͓खܰʂ 

8IBU
3&45 3&QSFTFOUBUJPOBM
4UBUF
5SBOTGFS Ϧιʔεࢦ޲ΞʔΩςΫνϟͷ࣮૷ Ϧιʔεͷঢ়ଶΛදݱͨ͠΋ͷΛసૹ͢Δ͜ͱɻ 3&45ΞʔΩςΫνϟͱ͍͏΋ͷ͸ଘࡏ͠ͳ͍ɻ
3&45͸Ұ࿈ͷઃܭ৚݅ɻ 

8IBU
30" ͭͷ֓೦ ͭͷಛੑ Ϧιʔε ໊લ 63* දݱ ϦιʔεؒͷϦϯΫ ΞυϨεՄೳੑ εςʔτϨεੑ ઀ଓੑ ౷ҰΠϯλʔϑΣʔε 

8IBU
30" (&5
VTFSTLP[BLF \




pSTU/BNF

৴Ұ




MBTU/BNF

খञ




BHF






CPEZ8FJHIU


^ )551ϝιου
ʹΑΔ౷Ұ*' Ϧιʔεͷ63- Ϧιʔεͷදݱ
ɾ+40/ܗࣜ
ɾ೔ຊޠ 

ͦͷઃܭख๏30"Ͱ͔͢ʁ IUUQTqJDLSQNT;" 

Α͋͘Δઃܭख๏ Ϣʔεέʔεਤ 

Α͋͘Δઃܭख๏ ΞΫςΟϏςΟਤ 

Α͋͘Δઃܭख๏ ը໘ۦಈઃܭ 

ͦͷઃܭख๏30"Ͱ͔͢ʁ γεςϜͱར༻ऀͷڥքΛ෼ੳ͠ɺ
ιϑτ΢ΣΞͷػೳ୯ҐΛநग़͢Δઃܭख๏ αʔϏεࢦ޲ 

Ϧιʔεࢦ޲ͱαʔϏεࢦ޲ Ϧιʔεࢦ޲ αʔϏεࢦ޲ ɾϦιʔεΛத৺ʹߟ͑Δ ɾ࣮ߦ͞ΕΔϝιουʢػೳʣ
ɹΑΓ΋ϦιʔεʢσʔλϞσϧʣ
ɹΛॏࢹ͢Δ ɾϦιʔε͸໊ࢺͰఆٛͰ͖Δ
ɹʢྫ͑͹ɺlϏσΦͷϨϯλϧzʣ ɾػೳΛத৺ʹߟ͑Δ ɾར༻ऀଆ͔Βݟͨιϑτ΢ΣΞͷ
ɹαʔϏεʢػೳʣͷ૊Έ߹Θͤ
ɹͰγεςϜߏஙΛ͢Δ ɾαʔϏε͸ಈࢺͰఆٛͰ͖Δ
ɹʢྫ͑͹ɺlϏσΦΛϨϯλϧ͢Δzʣ ɾ໊ࢺɺΦϒδΣΫτ໊ɺର৅୯Ґ
ɹͰ"1*Λ੔ཧ͢Δ ɾಈࢺɺίϚϯυ໊ɺϝιου໊୯Ґ
ɹͰ"1*Λ੔ཧ͢Δ 

Ϧιʔεࢦ޲ͱαʔϏεࢦ޲ Ϧιʔεࢦ޲ αʔϏεࢦ޲ $MJFOU 3FTPVSDF $MJFOU 4FSWJDF
(&5

1045

165

%&-&5&

*/70,&

*/70,&

*/70,&

*/70,&
4FSWJDF 4FSWJDF 4FSWJDF αʔϏε͕8FCʹ͓͚Δ31$ͳΒɺ
3&45͸8FCʹ͓͚Δ%#.4 

ͦͷΞϓϦέʔγϣϯ
3&45ʹै͏ඞཁ͋Γ·͔͢ʁ IUUQTqJDLSQNT;" 

-46%TʢMBSHF
TFU
PG
VOLOPXO
EFWFMPQFSTʣͱ
44,%TʢTNBMM
TFU
PG
LOPXO
EFWFMPQFSTʣͱ͍͏֓೦ ͱ͋Δ3&45ͷߟ࡯ ୭͕࢖͏͔Θ͔Βͳ͍-46%T޲͚ͷ"1*͸ɺ͞·͟·ͳϢʔεέʔεΛ૝ఆͯ͠ͳΔ΂͘ ൚༻తʹ͠ͳ͚Ε͹ͳΒͳ͍ 44,%T޲͚ͷ"1*͸ಛఆͷ։ൃऀ΍ͦͷઌʹଘࡏ͢ΔΤϯυϢʔβʹͱͬͯศརͰ࢖͍΍ ͍͢΋ͷʹͳΔ͸ͣ ʮඒ͠͞ʯͷఆٛ͸େ͖͘ҧ͏͸ͣ ʙॻ੶ʮ8FC
"1*
5IF
(PPE
1BSUTʯ
QΑΓҾ༻ʙ 

Αʔ͘ߟ͑Αʙ
ࢦ޲͸େࣄͩΑʙ σʔλ࿈ܞํࣜ͸ΞϓϦέʔγϣϯͷछྨʹґଘ͢Δɻ
ɾͻͱͭͷΞʔΩςΫνϟʔʹݻࣥ͢Δඞཁੑ͸͋Δ͔ʁ
ɾΞϓϦέʔγϣϯಛੑΛجʹΞʔΩςΫνϟͷબ୒Λߦͳ͏΂͖Ͱ͸ʁ ۀ຿ܥΞϓϦέʔγϣϯʹ͓͍ͯ͸ɺ
ϦιʔεΑΓ΋αʔϏεʹয఺͕͋ͨΓ΍͍͢ɻ ͱ͋Δ3&45ͷߟ࡯ ͦ΋ͦ΋Ϧιʔεࢦ޲ʹԠͨ͡ઃܭख๏͕࠾ΒΕ͍ͯΔ͔ʁ 

ͱ͋Δ3&45ͷߟ࡯ ڞ௨ͷαʔό"1* ΞϓϦέʔγϣ" ޲͚ʹΠϯλʔ ϑΣΠεΛม׵ ΞϓϦέʔγϣ# ޲͚ʹΠϯλʔ ϑΣΠεΛม׵ ΞϓϦέʔγϣ$ ޲͚ʹΠϯλʔ ϑΣΠεΛม׵ ΞϓϦέʔγϣ% ޲͚ʹΠϯλʔ ϑΣΠεΛม׵ ΞϓϦέʔγϣ" ΞϓϦέʔγϣ# ΞϓϦέʔγϣ$ ΞϓϦέʔγϣ% αʔό ΫϥΠΞϯτ Φʔέετ Ϩʔγϣϯ૚ ʙॻ੶ʮ8FC
"1*
5IF
(PPE
1BSUTʯ
QΑΓҾ༻ʙ ʰ
/FUqJYࣾͰ͸04'"ʢPOFTJ[FpUTBMMʣͷΞϓϩʔνΛ΍Ίɺαʔόʔଆͷ൚༻తͳ "1*ͱΫϥΠΞϯτͷؒʹz$MJFOU
"EBQUFS
$PEFzΛ࣮ߦ͢Δ૚ΛڬΈɺ͞·͟·ͳͰσό ΠεʹରԠͰ͖ΔΑ͏ʹ͍ͯ͠·͢ɻʱ 

ͱ͋Δ3&45ͷߟ࡯ ϏσΦϨϯλϧγεςϜͰߟ͑ͯΈΔ 

·ͱΊ 

3&45ʹै͏͔ͷબ୒͸ɺ
։ൃ͢ΔΞϓϦέʔγϣϯʹͱͬͯ
Կ͕࠷ॏཁͰ͋Δ͔ʹΏͩͶΒΕΔɻ ·ͱΊ ৔߹ʹΑͬͯ͸ɺ୯ͳΔٕज़ํࣜͱͯ͠3&45Λ࠾༻͢Δ͚ͩͰ΋͍͍͔΋͠Εͳ͍ɻ ͜Ε͸࠶ར༻ͷߟ͑ํʹ΋ࣅ͍ͯΔؾ͕͢Δɻ
ຊ౰ʹͦΕ͸ίετΛ෷ͬͯ࠶ར༻͢Δͷ͔ʁΛߟ͑Δඞཁ͕͋Δɻ 

4JNQMF
JT
OPU
&BTZ ·ͱΊ &BTZ͸ɺ݁ՌΛੜ੒͢ΔͨΊͷ࠷খݶͷ࿑ྗɻ
γϯϓϧ͸ɺॏཁͳ΋ͷҎ֎ͷ͢΂ͯΛ࡟আ͢Δ͜ͱɻ 

ॻ੶঺հ 

αΠτ঺հ $MPVE
"1*
"1*ઃܭΨΠυ IUUQTDMPVEHPPHMFDPNBQJTEFTJHO IMKB 
೥Ҏདྷ
(PPHMF
಺෦Ͱ࢖༻͞Εɺ$MPVE
"1*
΍ͦͷଞͷ

(PPHMF
"1*
Λઃܭ͢Δͱ͖ʹ
(PPHMF
͕ै͏ΨΠυ 

αΠτ঺հ 8FC
"1*
%FTJHO
$SBGUJOH
*OUFSGBDFT
UIBU
%FWFMPQFST
-PWF IUUQTQBHFTBQJHFFDPNSTBQJHFFJNBHFT BQJEFTJHOFCPPLQEG 

ࢀߟʹͨ͠αΠτ ѹ౗తײँ 8FC
"1*ͱ͸Կͳͷ͔ Ϧιʔεࢦ޲ΞʔΩςΫνϟ 30" ͱ͸Կͳͷ͔ Ϧιʔεࢦ޲8FCαʔϏεͱΞΫςΟϏςΟʔࢦ޲8FCαʔϏεΛൺֱ͢Δ 40"ͷະདྷ͸3&45͔ 40"1
ͱ3&45ͷҧ͍ʹ͍ͭͯΘ͔Γ΍͘͢ڭ͍͚͑ͯͨͩ·ͤΜͰ͠ΐ͏͔ʁ https://qiita.com/NagaokaKenichi/items/df4c8455ab527aeacf02 https://qiita.com/NagaokaKenichi/items/0f3a55e422d5cc9f1b9c https://www.ibm.com/developerworks/jp/webservices/library/ws-restvsoap/index.html https://teratail.com/questions/34703 https://www.infoq.com/jp/articles/RESTSOAFuture/ 

͝੩ௌ
͋Γ͕ͱ͏͍͟͝·ͨ͠ʂ ͓ΘΓ