1 © 2012 Warehouse TERRADA
API デザイン
〜ノンプログラマーがチームをつくり
 API 開発するプロセス〜
寺⽥倉庫 株式会社
minikura チーム・サブリーダー
藏森 安治
2 © 2012 Warehouse TERRADA
私が担当しているサービス
2013〜 2014〜
3 © 2012 Warehouse TERRADA
APIデザイン〜ノンプログラマーがチームをつくりAPI 開発するプロセス〜
1.  ご紹介
1.  ⾃⼰紹介
2.  寺⽥倉庫
3.  minikrua
4.  minikura API
2.  API 開発アプローチ
1.  ⾏動
2.  効果
3.  API のこれから
4 © 2012 Warehouse TERRADA
⾃⼰紹介
藏森 安治
kuramori.yasuharu@terrada.co.jp
https://jp.linkedin.com/in/anjikuramori
プロダクトマネージャー(2016〜)
システムディレクター(2015〜)
クリエイティブディレクター(2014〜)
5 © 2012 Warehouse TERRADA
⼀⾒「超不利」な状況…
① システムの専⾨職でない
② 会社やチームの IT に対する理解も少ない
③ 当時⼊社してまだ1年くらい
6 © 2012 Warehouse TERRADA
寺⽥倉庫(1950〜)
事業内容:不動産業・保管保存業
http://www.terrada.co.jp/
7 © 2012 Warehouse TERRADA
寺⽥倉庫(twitter 検索より)
“天王洲に希少な画材揃える「ピグモン」
店舗デザインは隈研吾”
          fashionsnap.com
“スタイリストが選ぶレンタルサービス
「エアークローゼット」事業拡⼤へ
 10億円弱調達”
fashionsnap.com
“寺⽥倉庫、コレクター向け
楽器専⽤保管サービスを開始”
           産経ニュース
 “オランダ デン・ハーグ発、
  先端アートの祭典が東京で開催”
Adver Times
“デヴィッド・ボウイ回顧展
『DAVID BOWIE is』1⽉から
寺⽥倉庫で開催“      CINRA.NET
8 © 2012 Warehouse TERRADA
twitter で検索してみてください…
寺⽥倉庫
9 © 2012 Warehouse TERRADAhttps://minikura.com
Webで申し込むプライベート倉庫
①つめて ②おくって ③あずけて ④チェック
10 © 2012 Warehouse TERRADA
Webで申し込むプライベート倉庫
https://minikura.com
11 © 2012 Warehouse TERRADA
Web × 倉庫 × 物流の API
minikura のすべての
機能が使える!
https://minikura.com/lineup/api.html
12 © 2012 Warehouse TERRADA
モノのハブステーション構想
From minikura
 to Somewhere...
Tokyo
Fukuoka
Okinawa
13 © 2012 Warehouse TERRADA
API 活⽤事例
https://pocket.sumally.comhttp://www.buyma.comhttps://www.air-closet.com/
14 © 2012 Warehouse TERRADA
開発アプローチ
1.  ⾏動
2.  効果
15 © 2012 Warehouse TERRADA
⾏動その①
サービス分解
16 © 2012 Warehouse TERRADA
「サービスの分解」とは…
「流れ」で認識されているサービスを
「点」にして曖昧さをなくすこと
サービス・依頼
要素
責任
条件
条件 要素
責任要素
条件
17 © 2012 Warehouse TERRADA
実際にやったことは…
①  担当質問
②  倉庫出張
③  現場作業
Point
新⼈に
やらせる
18 © 2012 Warehouse TERRADA
「⼊庫」の分解例〜これまでの認識〜
⼊庫
19 © 2012 Warehouse TERRADA
「⼊庫」の分解例 〜分解後〜
⼿続き
ログ
アウト
お知らせ⼊庫依頼カレンダーボックスログイン
責 任 法務・システム倉庫法務・PR・システム
条 件 ID・PW BOX ID 住所・⽇時 依頼ID
確 認 本⼈認識 依頼意志 依頼確認
20 © 2012 Warehouse TERRADA
「サービス分解」する意味は…
① サービス理解
② チーム交流の下地
21 © 2012 Warehouse TERRADA
⾏動その②
APIっぽく会話
22 © 2012 Warehouse TERRADA
APIっぽい会話の要素①
項⽬ 説明 例
API
依頼や
アクションの単位
会員登録
ログイン
23 © 2012 Warehouse TERRADA
APIっぽい会話の要素①
24 © 2012 Warehouse TERRADA
APIっぽい会話の要素②
項⽬ 説明 例
パラメータ ⼊⼒項⽬
(会員登録の場合)
⽒名、メルアド
メソッド
(アクションの種類)
登録(POST)
取得(GET)
会員登録
会員情報取得
25 © 2012 Warehouse TERRADA
APIっぽい会話の要素②
26 © 2012 Warehouse TERRADA
APIっぽい会話の要素②
項⽬ 説明 例
パラメータ ⼊⼒項⽬
(会員登録の場合)
⽒名、メルアド
メソッド
(アクションの種類)
登録(POST)
取得(GET)
会員登録
会員情報取得
27 © 2012 Warehouse TERRADA
APIっぽい会話の要素②
28 © 2012 Warehouse TERRADA
APIっぽい会話の要素③
項⽬ 説明 例
リクエスト 依頼の前提条件
⼊⼒項⽬の
必須事項
レスポンス
依頼の結果、
相⼿に応えるもの
(会員登録した場合)
会員番号
29 © 2012 Warehouse TERRADA
APIっぽい会話の要素③
30 © 2012 Warehouse TERRADA
APIっぽい会話の要素③
項⽬ 説明 例
リクエスト 依頼の前提条件
⼊⼒項⽬の
必須事項
レスポンス
依頼の結果、
相⼿に応えるもの
(会員登録した場合)
会員番号
31 © 2012 Warehouse TERRADA
APIっぽい会話の要素③
32 © 2012 Warehouse TERRADA
例2:社内の会話 〜登場⼈物〜
藏森
クリエイティブ
30代男性
⿊⽊
法務
20代⼥性
⻑⽥
システム
40代男性
浅⾒
倉庫
30代男性
33 © 2012 Warehouse TERRADA
例2:社内の会話 〜会話〜
法務
minikura の会員登録って
必須パラメータ多くない?
でも‥システム上ではメルアドと
パスワードだけでOKですよ
Sys
法務
あ!配送業者と、債権チームは
電話番号使ってるみたいです
契約する上で、⽒名・住所
は必須なんです!
34 © 2012 Warehouse TERRADA
例2:社内の会話 〜会話〜
後⽇…
法務
会員登録の時に
すべてのパラメータは必要?
んー…契約始まる前にすべて
揃えば問題ないです
倉庫
会員番号とボックスIDが
あれば作業できますー!
35 © 2012 Warehouse TERRADA
例2:社内の会話 〜ホワイトボード〜
36 © 2012 Warehouse TERRADA
「APIっぽく会話」する意味は…
① 理解のバラ付きを無くす
② プロ同⼠の直接意⾒交換
37 © 2012 Warehouse TERRADA
効果
「サービス分解」で感じた
疑問が実を結ぶ
38 © 2012 Warehouse TERRADA
依頼
シンプルだから誰でも⾊々なアイデアで改善
削除
追加
⼊替え
法務
Sys
倉庫
変更
PR
UX
39 © 2012 Warehouse TERRADA
効果
全員
改善のアイデアを持ち
改善のチャンスが
もつ
Point
迷ったら
バラバラ
API
40 © 2012 Warehouse TERRADA
つくった API の数
100本以上
41 © 2012 Warehouse TERRADA
API をつくる…
Interface をつくる
(異なるもの同⼠の接点をつくり、つなげること)
42 © 2012 Warehouse TERRADA
API のこれから…
① Private / Public
② Originality
43 © 2012 Warehouse TERRADA
ご清聴ありがとうございました
kuramori.yasuharu@terrada.co.jp
https://jp.linkedin.com/in/anjikuramori

API デザイン 〜ノンプログラマーがチームをつくり API 開発するプロセス〜

  • 1.
    1 © 2012Warehouse TERRADA API デザイン 〜ノンプログラマーがチームをつくり  API 開発するプロセス〜 寺⽥倉庫 株式会社 minikura チーム・サブリーダー 藏森 安治
  • 2.
    2 © 2012Warehouse TERRADA 私が担当しているサービス 2013〜 2014〜
  • 3.
    3 © 2012Warehouse TERRADA APIデザイン〜ノンプログラマーがチームをつくりAPI 開発するプロセス〜 1.  ご紹介 1.  ⾃⼰紹介 2.  寺⽥倉庫 3.  minikrua 4.  minikura API 2.  API 開発アプローチ 1.  ⾏動 2.  効果 3.  API のこれから
  • 4.
    4 © 2012Warehouse TERRADA ⾃⼰紹介 藏森 安治 kuramori.yasuharu@terrada.co.jp https://jp.linkedin.com/in/anjikuramori プロダクトマネージャー(2016〜) システムディレクター(2015〜) クリエイティブディレクター(2014〜)
  • 5.
    5 © 2012Warehouse TERRADA ⼀⾒「超不利」な状況… ① システムの専⾨職でない ② 会社やチームの IT に対する理解も少ない ③ 当時⼊社してまだ1年くらい
  • 6.
    6 © 2012Warehouse TERRADA 寺⽥倉庫(1950〜) 事業内容:不動産業・保管保存業 http://www.terrada.co.jp/
  • 7.
    7 © 2012Warehouse TERRADA 寺⽥倉庫(twitter 検索より) “天王洲に希少な画材揃える「ピグモン」 店舗デザインは隈研吾”           fashionsnap.com “スタイリストが選ぶレンタルサービス 「エアークローゼット」事業拡⼤へ  10億円弱調達” fashionsnap.com “寺⽥倉庫、コレクター向け 楽器専⽤保管サービスを開始”            産経ニュース  “オランダ デン・ハーグ発、   先端アートの祭典が東京で開催” Adver Times “デヴィッド・ボウイ回顧展 『DAVID BOWIE is』1⽉から 寺⽥倉庫で開催“      CINRA.NET
  • 8.
    8 © 2012Warehouse TERRADA twitter で検索してみてください… 寺⽥倉庫
  • 9.
    9 © 2012Warehouse TERRADAhttps://minikura.com Webで申し込むプライベート倉庫 ①つめて ②おくって ③あずけて ④チェック
  • 10.
    10 © 2012Warehouse TERRADA Webで申し込むプライベート倉庫 https://minikura.com
  • 11.
    11 © 2012Warehouse TERRADA Web × 倉庫 × 物流の API minikura のすべての 機能が使える! https://minikura.com/lineup/api.html
  • 12.
    12 © 2012Warehouse TERRADA モノのハブステーション構想 From minikura  to Somewhere... Tokyo Fukuoka Okinawa
  • 13.
    13 © 2012Warehouse TERRADA API 活⽤事例 https://pocket.sumally.comhttp://www.buyma.comhttps://www.air-closet.com/
  • 14.
    14 © 2012Warehouse TERRADA 開発アプローチ 1.  ⾏動 2.  効果
  • 15.
    15 © 2012Warehouse TERRADA ⾏動その① サービス分解
  • 16.
    16 © 2012Warehouse TERRADA 「サービスの分解」とは… 「流れ」で認識されているサービスを 「点」にして曖昧さをなくすこと サービス・依頼 要素 責任 条件 条件 要素 責任要素 条件
  • 17.
    17 © 2012Warehouse TERRADA 実際にやったことは… ①  担当質問 ②  倉庫出張 ③  現場作業 Point 新⼈に やらせる
  • 18.
    18 © 2012Warehouse TERRADA 「⼊庫」の分解例〜これまでの認識〜 ⼊庫
  • 19.
    19 © 2012Warehouse TERRADA 「⼊庫」の分解例 〜分解後〜 ⼿続き ログ アウト お知らせ⼊庫依頼カレンダーボックスログイン 責 任 法務・システム倉庫法務・PR・システム 条 件 ID・PW BOX ID 住所・⽇時 依頼ID 確 認 本⼈認識 依頼意志 依頼確認
  • 20.
    20 © 2012Warehouse TERRADA 「サービス分解」する意味は… ① サービス理解 ② チーム交流の下地
  • 21.
    21 © 2012Warehouse TERRADA ⾏動その② APIっぽく会話
  • 22.
    22 © 2012Warehouse TERRADA APIっぽい会話の要素① 項⽬ 説明 例 API 依頼や アクションの単位 会員登録 ログイン
  • 23.
    23 © 2012Warehouse TERRADA APIっぽい会話の要素①
  • 24.
    24 © 2012Warehouse TERRADA APIっぽい会話の要素② 項⽬ 説明 例 パラメータ ⼊⼒項⽬ (会員登録の場合) ⽒名、メルアド メソッド (アクションの種類) 登録(POST) 取得(GET) 会員登録 会員情報取得
  • 25.
    25 © 2012Warehouse TERRADA APIっぽい会話の要素②
  • 26.
    26 © 2012Warehouse TERRADA APIっぽい会話の要素② 項⽬ 説明 例 パラメータ ⼊⼒項⽬ (会員登録の場合) ⽒名、メルアド メソッド (アクションの種類) 登録(POST) 取得(GET) 会員登録 会員情報取得
  • 27.
    27 © 2012Warehouse TERRADA APIっぽい会話の要素②
  • 28.
    28 © 2012Warehouse TERRADA APIっぽい会話の要素③ 項⽬ 説明 例 リクエスト 依頼の前提条件 ⼊⼒項⽬の 必須事項 レスポンス 依頼の結果、 相⼿に応えるもの (会員登録した場合) 会員番号
  • 29.
    29 © 2012Warehouse TERRADA APIっぽい会話の要素③
  • 30.
    30 © 2012Warehouse TERRADA APIっぽい会話の要素③ 項⽬ 説明 例 リクエスト 依頼の前提条件 ⼊⼒項⽬の 必須事項 レスポンス 依頼の結果、 相⼿に応えるもの (会員登録した場合) 会員番号
  • 31.
    31 © 2012Warehouse TERRADA APIっぽい会話の要素③
  • 32.
    32 © 2012Warehouse TERRADA 例2:社内の会話 〜登場⼈物〜 藏森 クリエイティブ 30代男性 ⿊⽊ 法務 20代⼥性 ⻑⽥ システム 40代男性 浅⾒ 倉庫 30代男性
  • 33.
    33 © 2012Warehouse TERRADA 例2:社内の会話 〜会話〜 法務 minikura の会員登録って 必須パラメータ多くない? でも‥システム上ではメルアドと パスワードだけでOKですよ Sys 法務 あ!配送業者と、債権チームは 電話番号使ってるみたいです 契約する上で、⽒名・住所 は必須なんです!
  • 34.
    34 © 2012Warehouse TERRADA 例2:社内の会話 〜会話〜 後⽇… 法務 会員登録の時に すべてのパラメータは必要? んー…契約始まる前にすべて 揃えば問題ないです 倉庫 会員番号とボックスIDが あれば作業できますー!
  • 35.
    35 © 2012Warehouse TERRADA 例2:社内の会話 〜ホワイトボード〜
  • 36.
    36 © 2012Warehouse TERRADA 「APIっぽく会話」する意味は… ① 理解のバラ付きを無くす ② プロ同⼠の直接意⾒交換
  • 37.
    37 © 2012Warehouse TERRADA 効果 「サービス分解」で感じた 疑問が実を結ぶ
  • 38.
    38 © 2012Warehouse TERRADA 依頼 シンプルだから誰でも⾊々なアイデアで改善 削除 追加 ⼊替え 法務 Sys 倉庫 変更 PR UX
  • 39.
    39 © 2012Warehouse TERRADA 効果 全員 改善のアイデアを持ち 改善のチャンスが もつ Point 迷ったら バラバラ API
  • 40.
    40 © 2012Warehouse TERRADA つくった API の数 100本以上
  • 41.
    41 © 2012Warehouse TERRADA API をつくる… Interface をつくる (異なるもの同⼠の接点をつくり、つなげること)
  • 42.
    42 © 2012Warehouse TERRADA API のこれから… ① Private / Public ② Originality
  • 43.
    43 © 2012Warehouse TERRADA ご清聴ありがとうございました kuramori.yasuharu@terrada.co.jp https://jp.linkedin.com/in/anjikuramori