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

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

私が担当しているサービス
2013〜 2014〜

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

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

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

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

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

twitter で検索してみてください…
寺⽥倉庫

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

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

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

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

API 活⽤事例
https://pocket.sumally.comhttp://www.buyma.comhttps://www.air-closet.com/

開発アプローチ
1.  ⾏動
2.  効果

⾏動その①
サービス分解

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

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

「⼊庫」の分解例〜これまでの認識〜
⼊庫

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

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

⾏動その②
APIっぽく会話

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

APIっぽい会話の要素①

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

項⽬説明例
パラメータ⼊⼒項⽬
（会員登録の場合）
⽒名、メルアド
メソッド
（アクションの種類）
登録（POST）
取得（GET）
会員登録
会員情報取得

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

項⽬説明例
リクエスト依頼の前提条件
⼊⼒項⽬の
必須事項
レスポンス
依頼の結果、
相⼿に応えるもの
（会員登録した場合）
会員番号

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

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

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

例２：社内の会話〜ホワイトボード〜

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

効果
「サービス分解」で感じた
疑問が実を結ぶ

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

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

つくった API の数
100本以上

API をつくる…
Interface をつくる
(異なるもの同⼠の接点をつくり、つなげること)

API のこれから…
① Private / Public
② Originality

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

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

Recommended

Recommended

More Related Content

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

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