APIドキュメンテーションとmockサーバ #meguroes #gotandajs

E1dbe585427fa87cbfb0f4dbcebc3b2f?s=47 mizuki_r
April 28, 2017

APIドキュメンテーションとmockサーバ #meguroes #gotandajs

Meguro.es x Gotanda.js での発表資料です

E1dbe585427fa87cbfb0f4dbcebc3b2f?s=128

mizuki_r

April 28, 2017
Tweet

Transcript

  1. APIドキュメンテーション と mockサーバ 2017/04/28 Meguro.es x Gotanda.js @mizuki_r

  2. @mizuki_r • シニアフロントエンドエンジニア • エンジニア 2 #javascript #gotandajs #meguroes #perl

    #kichijojipm 五反田のM社で位置ゲー開発に携わる。
 エンジニアとして新卒入社して7年目に突 入。3年目くらいからフロントエンドエン ジニアを兼任。 about me こんな人です
  3. theme

  4. APIドキュメンテーション と mockサーバ

  5. まあつまりは、 
 harikoの話です

  6. hariko

  7. what is hariko • JSON API Mock Server. • API-Blueprint

    based.
  8. why talk about hariko • ࠷ۙ࢖ͬͯΔ • ͪΐͬͱલʹΞοϓσʔτͨ͠ • ͦ͏ݴ͑͹ͪΌΜͱ঺հͯ͠ͳ͍ͳˡ

  9. context

  10. 開発体制 ཁ݅ UI API ϞοΫ API αʔ ό ʔ ·ͣ͸UI

    ৘ใΛ੔ཧ͠ αʔόΛ ࡞Γ UIʹ൓ө͢Δ
  11. 解決したい問題 • stubcell / json mockͳͲ͸JSONΛஔ͚ͩ͘ • આ໌ɾυΩϡϝϯςʔγϣϯ͕ෆ଍ • υΩϡϝϯτͱͯ͠੔ܗ͞Εͳ͍͠ɺͦ΋ͦ΋ಡ

    Έʹ͍͘ →͜Ε͸API-Blueprint͕ղܾͯ͘͠ΕΔ
  12. harikoで解決したい • MemberResourceͷදݱΛ࠷খͰॻ͖͍ͨ • ϖʔδϟʔͷόϦΤʔγϣϯΛදݱ͍ͨ͠ • खಈͰΞϓϦέʔγϣϯͷڍಈΛ࠶ݱ͍ͨ͠ →ͨͩͷJSONΑΓ΋ͪΐͬͱݡ͍ͨ͘͠

  13. hariko’s power

  14. 複数のレスポンスのパターン /api/users/:idͱ͍͏API͕͋Δͱͯ͠ɺ id͕1, 2, 3, ͦͷଞͰҧ͏ϨεϙϯεΛฦ͍ͨ͠

  15. クエリパラメータによって レスポンスを変えたい /api/items?page=1 /api/items?page=2 Ͱ10݅ͱ5݅ͰϨεϙϯεΛฦ͍ͨ͠

  16. オンラインでデータを書き換えたい 1. POST /api/messagesʹϦΫΤετΛૹΔ 2. mockΛ௥ه͢Δ 3. GET /api/messagesΛୟ͘ͱ௥هͨ͠σʔλ Λड͚औΕΔ

  17. demo

  18. まとめ

  19. まとめ • harikoͷ঺հͰͨ͠ • େن໛ͳAPIΛ؅ཧ͢ΔͨΊͷॊೈੑΛ࣋ͬͨMockαʔόͰ ͢ • ҎԼͷΑ͏ͳํʹ͓͢͢ΊͰ͢ • JSONஔ͚ͩ͘͡Ό΋͏ͭΒ͍

    • ॊೈʹΑ͠ͳʹͯ͠΄͍͠
  20. ご清聴ありがとうございました