api-design-practice.pdf

Transcript

1. API ઃܭͰ஫ҙ͍ͯ͠Δࣄ toshiki takezawa @to4iki
3. ࠓ͔Βͷ಺༰͸ ͋͘·Ͱ։ൃऀࢹ఺Ͱ͢ APIΛ࡞Δࢹ఺Ͱ
4. લఏ REST ~.pl ~.do ~servletͱ͔ ಛఆݴޠʹґଘ͍ͯ͠Δ͔ΒγεςϜมߋ͠ ʹ͍͘ɻ FW(struts → rails)ͱ͔ม͑ͨΒURLมΘΔ ΑͶ ! ɾwebΛࢧ͑Δٕज़ಡ΋͏
5. 1. ಈࢺͰ͸ͳ໊͘ࢺ ɾϦιʔεΛ໊ࢺͰද͢ collectionͰ υϝΠϯʹΑͬͯ͸ಈࢺ΋͋Γ /convert?from=EUR&to=CNY&amount=100` ɾHTTP ϝιουΛϦιʔεͷૢ࡞ͱ͢Δ get, post, put, delete ɾ֊૚͸ͳΔ͚ͩઙ͘อͭɺγϯϓϧʹ /users/5678/dogs /resource/identifier/resource ͕໨҆ ɾURLʹϝιουΛؚΊͳ͍ /users/show/123ͱ͔ → /users/123 ɾෳࡶ͞͸ΫΤϦύϥϝʔλʹԡ͠ࠐΉ /users?q=hoge&offset=50&limit=30
6. 2. ΤϥʔϋϯυϦϯά ɾεςʔλείʔυΛద੾ʹ࢖༻͢Δ 200: success 400൪୅: client error 404: not found 409 conflict 500: server error
7. 3. όʔδϣχϯά ɾAPI ͷϨεϙϯεΛϋϯυϧͯ͠ϩδοΫ͕มΘΔ ৔߹, URL ʹ͍ΕΔ ͔ͯɺೖΕͳ͍ͱޓ׵ੑ੾ͬͨมߋ͘Θ͑ͨͱ͖ࢮ ͵ /api/1.0/dogs /api/1.1/dogs ! AcceptsϔομʔͰόʔδϣχϯάͯ͠΋
8. 4. ϦιʔεͷUUIDΛఏڙ͢Δ “uuid":"39D3FA7E-­‐29F5-­‐4406-­‐9B54-­‐AE70FA3CBF87"   ! sequenceͰ΋͍͍ͱࢥ͏͚Ͳ ! mysqlͳΒ SELECT UUID() AS u ! postgre͸σϑΥϧτରԠͯ͠ͳ͍͔Β uuid-ossp͍ΕͯͶ
9. 5. ϦιʔεͷtimestampΛఏڙ͢Δ {      "createTime":1406391453253,      "modifyTime":1406421657000   }
10. 6. ֎෦Ωʔͷࢀষ͸ωετ͢Δ    "name":"fute",      "ownerId":  “13524-­‐...",   ! Ͱ͸ͳ͘   !    "name":"fute",      "owner":  {          "id":  "13524-­‐...",      }   Ϩεϙϯεͷߏ଄Λมߋͨ͠ΓɺτοϓϨϕϧͷϑΟʔ ϧυΛ௥Ճ͢Δࣄͳ͘ɺؔ࿈৘ใΛؚΊΔࣄ͕Ͱ͖Δ
11. 7. Ϧιʔεࢀরͷalias༻ҙ͠ͱ͘ ɾid /users/:id ɾname /users/:name ɾmail /users/:mail
12. ଞʹ΋ ɾAPIΞΫηε͸SSLඞਢʹ͍͔ͨ͠΋ ɾdocumentॆ࣮ͤ͞Α͏ ɾEtagͰΩϟογϡαϙʔτͱ͔ (ΫϥΠΞϯτͷif-none-matchϔομͰ cache࠷৽͔νΣοΫͱ͔)
13. ͓ΘΓ