1. 1 © 2012 Warehouse TERRADA
API デザイン
〜ノンプログラマーがチームをつくり
API 開発するプロセス〜
寺⽥倉庫 株式会社
minikura チーム・サブリーダー
藏森 安治

2. 2 © 2012 Warehouse TERRADA
私が担当しているサービス
2013〜 2014〜

3. 3 © 2012 Warehouse TERRADA
APIデザイン〜ノンプログラマーがチームをつくりAPI 開発するプロセス〜
1. ご紹介
1. ⾃⼰紹介
2. 寺⽥倉庫
3. minikrua
4. minikura API
2. API 開発アプローチ
1. ⾏動
2. 効果
3. API のこれから

4. 4 © 2012 Warehouse TERRADA
⾃⼰紹介
藏森 安治
kuramori.yasuharu@terrada.co.jp
https://jp.linkedin.com/in/anjikuramori
プロダクトマネージャー（2016〜）
システムディレクター（2015〜）
クリエイティブディレクター（2014〜）

5. 5 © 2012 Warehouse TERRADA
⼀⾒「超不利」な状況…
① システムの専⾨職でない
② 会社やチームの IT に対する理解も少ない
③ 当時⼊社してまだ１年くらい

6. 6 © 2012 Warehouse TERRADA
寺⽥倉庫（1950〜）
事業内容：不動産業・保管保存業
http://www.terrada.co.jp/

7. 7 © 2012 Warehouse TERRADA
寺⽥倉庫（twitter 検索より）
“天王洲に希少な画材揃える「ピグモン」
店舗デザインは隈研吾”
fashionsnap.com
“スタイリストが選ぶレンタルサービス
「エアークローゼット」事業拡⼤へ
10億円弱調達”
fashionsnap.com
“寺⽥倉庫、コレクター向け
楽器専⽤保管サービスを開始”
産経ニュース
“オランダ デン・ハーグ発、
先端アートの祭典が東京で開催”
Adver Times
“デヴィッド・ボウイ回顧展
『DAVID BOWIE is』１⽉から
寺⽥倉庫で開催“ CINRA.NET

8. 8 © 2012 Warehouse TERRADA
twitter で検索してみてください…
寺⽥倉庫

9. 9 © 2012 Warehouse TERRADAhttps://minikura.com
Webで申し込むプライベート倉庫
①つめて ②おくって ③あずけて ④チェック

10. 10 © 2012 Warehouse TERRADA
Webで申し込むプライベート倉庫
https://minikura.com

11. 11 © 2012 Warehouse TERRADA
Web × 倉庫 × 物流の API
minikura のすべての
機能が使える！
https://minikura.com/lineup/api.html

12. 12 © 2012 Warehouse TERRADA
モノのハブステーション構想
From minikura
to Somewhere...
Tokyo
Fukuoka
Okinawa

13. 13 © 2012 Warehouse TERRADA
API 活⽤事例
https://pocket.sumally.comhttp://www.buyma.comhttps://www.air-closet.com/

14. 14 © 2012 Warehouse TERRADA
開発アプローチ
1. ⾏動
2. 効果

15. 15 © 2012 Warehouse TERRADA
⾏動その①
サービス分解

16. 16 © 2012 Warehouse TERRADA
「サービスの分解」とは…
「流れ」で認識されているサービスを
「点」にして曖昧さをなくすこと
サービス・依頼
要素
責任
条件
条件 要素
責任要素
条件

17. 17 © 2012 Warehouse TERRADA
実際にやったことは…
① 担当質問
② 倉庫出張
③ 現場作業
Point
新⼈に
やらせる

18. 18 © 2012 Warehouse TERRADA
「⼊庫」の分解例〜これまでの認識〜
⼊庫

19. 19 © 2012 Warehouse TERRADA
「⼊庫」の分解例 〜分解後〜
⼿続き
ログ
アウト
お知らせ⼊庫依頼カレンダーボックスログイン
責 任 法務・システム倉庫法務・PR・システム
条 件 ID・PW BOX ID 住所・⽇時 依頼ID
確 認 本⼈認識 依頼意志 依頼確認

20. 20 © 2012 Warehouse TERRADA
「サービス分解」する意味は…
① サービス理解
② チーム交流の下地

21. 21 © 2012 Warehouse TERRADA
⾏動その②
APIっぽく会話

22. 22 © 2012 Warehouse TERRADA
APIっぽい会話の要素①
項⽬ 説明 例
API
依頼や
アクションの単位
会員登録
ログイン

23. 23 © 2012 Warehouse TERRADA
APIっぽい会話の要素①

24. 24 © 2012 Warehouse TERRADA
APIっぽい会話の要素②
項⽬ 説明 例
パラメータ ⼊⼒項⽬
（会員登録の場合）
⽒名、メルアド
メソッド
（アクションの種類）
登録（POST）
取得（GET）
会員登録
会員情報取得

25. 25 © 2012 Warehouse TERRADA
APIっぽい会話の要素②

26. 26 © 2012 Warehouse TERRADA
APIっぽい会話の要素②
項⽬ 説明 例
パラメータ ⼊⼒項⽬
（会員登録の場合）
⽒名、メルアド
メソッド
（アクションの種類）
登録（POST）
取得（GET）
会員登録
会員情報取得

27. 27 © 2012 Warehouse TERRADA
APIっぽい会話の要素②

28. 28 © 2012 Warehouse TERRADA
APIっぽい会話の要素③
項⽬ 説明 例
リクエスト 依頼の前提条件
⼊⼒項⽬の
必須事項
レスポンス
依頼の結果、
相⼿に応えるもの
（会員登録した場合）
会員番号

29. 29 © 2012 Warehouse TERRADA
APIっぽい会話の要素③

30. 30 © 2012 Warehouse TERRADA
APIっぽい会話の要素③
項⽬ 説明 例
リクエスト 依頼の前提条件
⼊⼒項⽬の
必須事項
レスポンス
依頼の結果、
相⼿に応えるもの
（会員登録した場合）
会員番号

31. 31 © 2012 Warehouse TERRADA
APIっぽい会話の要素③

32. 32 © 2012 Warehouse TERRADA
例２：社内の会話 〜登場⼈物〜
藏森
クリエイティブ
30代男性
⿊⽊
法務
20代⼥性
⻑⽥
システム
40代男性
浅⾒
倉庫
30代男性

33. 33 © 2012 Warehouse TERRADA
例２：社内の会話 〜会話〜
法務
minikura の会員登録って
必須パラメータ多くない？
でも‥システム上ではメルアドと
パスワードだけでOKですよ
Sys
法務
あ！配送業者と、債権チームは
電話番号使ってるみたいです
契約する上で、⽒名・住所
は必須なんです！

34. 34 © 2012 Warehouse TERRADA
例２：社内の会話 〜会話〜
後⽇…
法務
会員登録の時に
すべてのパラメータは必要？
んー…契約始まる前にすべて
揃えば問題ないです
倉庫
会員番号とボックスIDが
あれば作業できますー！

35. 35 © 2012 Warehouse TERRADA
例２：社内の会話 〜ホワイトボード〜

36. 36 © 2012 Warehouse TERRADA
「APIっぽく会話」する意味は…
① 理解のバラ付きを無くす
② プロ同⼠の直接意⾒交換

37. 37 © 2012 Warehouse TERRADA
効果
「サービス分解」で感じた
疑問が実を結ぶ

38. 38 © 2012 Warehouse TERRADA
依頼
シンプルだから誰でも⾊々なアイデアで改善
削除
追加
⼊替え
法務
Sys
倉庫
変更
PR
UX

39. 39 © 2012 Warehouse TERRADA
効果
全員
改善のアイデアを持ち
改善のチャンスが
もつ
Point
迷ったら
バラバラ
API

40. 40 © 2012 Warehouse TERRADA
つくった API の数
100本以上

41. 41 © 2012 Warehouse TERRADA
API をつくる…
Interface をつくる
(異なるもの同⼠の接点をつくり、つなげること)

42. 42 © 2012 Warehouse TERRADA
API のこれから…
① Private / Public
② Originality

43. 43 © 2012 Warehouse TERRADA
ご清聴ありがとうございました
kuramori.yasuharu@terrada.co.jp
https://jp.linkedin.com/in/anjikuramori