オープンAPIドキュメント制作の裏側_APIプロダクトマネージャー勉強会#1

オープンAPI
ドキュメント制作の裏側
APIの担当PMになったら
2018.07.03
Sansan株式会社
プロダクトマネージャー尾部絵里子

CONTENTS
自己紹介 -わたしと Sansan API -
制作の裏側
一緒にもりあげませんか？
1
2
3

自己紹介
1
わたしと Sansan API

尾部絵里子
プロダクトマネージャー
PMコミュニティー
はじめました！
プロダクトマネージャーカフェで検索

API PM Lv. 2
エンジニア経験なし。
楽天APIでお気に入りリスト作った
「うちのアレSOAPでできてるねん」
「え、まじか」がわかるようになった

この方々に入門した
お世話になっております 🙏
この辺を読んだ

今日、皆さんと仲良くなって
セッサタクマしたい

名刺を元にした
正確な「人物と人脈」情報
おもに SFA、MA、帳票、
はがき印刷など
マスターデータとして利用
Sansan の API

BI に組み込んで使ったり
Sansan + CData + Power BI
CData 杉本さんありがとうございます😊
連携パートナーサービスを
使ってもらったり
Morning Girl by 杉本さん
http://kageura.hatenadiary.jp/entry/sansanconnect

APIドキュメントサイト
制作の裏側
２

今風で拡散させやすく
なりました
GOAL

昭和風 PDF
昭
和
で
メ
ン
ゴ
ぴ
ー
で
ー
え
ふ
だ
う
ん
ろ
ー
ど
今風ドキュメント

試すハードル下げた
こだわり1

契約
ログイン
奥深い階層
昭和PDF DL
Web で Doc 見る
トライアル
アカウント
ハードル高すぎ
謎のドキュメント隠し
ユーザ・パートナー・SIer
簡単に試せる

何を言ってるかわかる
こだわり2

ライターさんは
界隈で記事書いてる方にお願い
ユーザとSIer が Doc 見て
共通言語を使えるように

Global の
プラクティス
データに国境はない！
という気概 😎
Developer’s Document EN

光速一撃
API Blueprint ＋ Aglio

API Blueprint形式で
マークダウンを書き
ジェネレータ(Aglio)で
html を吐き出す
Aglio
API Blueprint

カスタマイズ
Sansan テンプレ

Aglio のデフォルト
デザイン
CSSだけ手を入れ
Sansan風に

営業系のメンバーが
外部の方に
積極的に案内したくなる
リンクを送りあえるので
問い合わせ対応など
会話しやすい

API Blueprintはナウくない
残念なお知らせ

時代は Swagger
・Swagger
・API Blueprint

GUIでAPIの設計が
できる
Swagger Editor
ついでに
ドキュメントを
自動生成できる
Swagger UI
クライアント・
サーバのコードが
生成できる
サンプルコードを取得
できる・モックサーバ
を立てれる、
且つ言語も選べる
Swagger Codegen
Swagger Swagger’s demo

一緒にもりあげませんか？

各社APIを使ったハッカソン
たとえば、各社APIを使ったアプリ開発とか

ごちゃまぜ勉強会
API提供者、エンドユーザ、開発者など、
ごちゃまぜ情報交換勉強会
「こんなのにつないでみました」
「こんなツールつかってます」
SYSTEM
INTEGRATOR
USERS

企業に眠るすべての顧客データを
名刺データベースを用いて統合化できる
Sansanの拡張ソリューション
Sansan Customer Intelligence
Sansan Customer Intelligence
プロダクトマネージャー
清水隆介
(くまさん、Tableau兄さん）

オープンAPIドキュメント制作の裏側_APIプロダクトマネージャー勉強会#1

Recommended

Recommended

More Related Content

Similar to オープンAPIドキュメント制作の裏側_APIプロダクトマネージャー勉強会#1

Similar to オープンAPIドキュメント制作の裏側_APIプロダクトマネージャー勉強会#1 (7)

オープンAPIドキュメント制作の裏側_APIプロダクトマネージャー勉強会#1

Editor's Notes