Successfully reported this slideshow.
We use your LinkedIn profile and activity data to personalize ads and to show you more relevant ads. You can change your ad preferences anytime.

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

663 views

Published on

API専任のプロダクトマネージャーをつける企業はまだ少ないですが、注目され始めています。認知される、簡単に試せる、使い始める、愛され継続する、、などなど API を育てるにはやることが沢山あります。専任のPMになったらまずは何をするか。私はまず認知向上のために、ドキュメントに手を入れました。
Sansan Product Manager Eriko Obe
2018-07-03 @Cybozu in Tokyo

Published in: Technology
  • Be the first to comment

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

  1. 1. オープンAPI ドキュメント制作の裏側 APIの担当PMになったら 2018.07.03 Sansan株式会社 プロダクトマネージャー 尾部絵里子
  2. 2. CONTENTS 自己紹介 -わたしと Sansan API - 制作の裏側 一緒にもりあげませんか? 1 2 3
  3. 3. 自己紹介 1 わたしと Sansan API
  4. 4. 尾部絵里子 プロダクトマネージャー PMコミュニティー はじめました! プロダクトマネージャーカフェで検索
  5. 5. API PM Lv. 2 エンジニア経験なし。 楽天APIでお気に入りリスト作った 「うちのアレSOAPでできてるねん」 「え、まじか」がわかるようになった
  6. 6. この方々に入門した お世話になっております 🙏 この辺を読んだ
  7. 7. 今日、皆さんと仲良くなって セッサタクマしたい
  8. 8. 名刺を元にした 正確な「人物 と人脈」情報 おもに SFA、MA、帳票、 はがき印刷など マスターデータとして利用 Sansan の API
  9. 9. ほかにも、、、
  10. 10. BI に組み込んで使ったり Sansan + CData + Power BI CData 杉本さんありがとうございます😊 連携パートナーサービスを 使ってもらったり Morning Girl by 杉本さん http://kageura.hatenadiary.jp/entry/sansanconnect
  11. 11. APIドキュメントサイト 制作の裏側 2
  12. 12. 今風で拡散させやすく なりました GOAL
  13. 13. 昭和風 PDF 昭 和 で メ ン ゴ ぴ ー で ー え ふ だ う ん ろ ー ど 今風ドキュメント
  14. 14. 試すハードル下げた こだわり1
  15. 15. 契約 ログイン 奥深い階層 昭和PDF DL Web で Doc 見る トライアル アカウント ハードル高すぎ 謎のドキュメント隠し ユーザ・パートナー・SIer 簡単に試せる
  16. 16. 何を言ってるかわかる こだわり2
  17. 17. ライターさんは 界隈で記事書いてる方にお願い ユーザとSIer が Doc 見て 共通言語を使えるように
  18. 18. Go Global ! こだわり3
  19. 19. Global の プラクティス データに国境はない! という気概 😎 Developer’s Document EN
  20. 20. 光速一撃 API Blueprint + Aglio
  21. 21. API Blueprint形式で マークダウンを書き ジェネレータ(Aglio)で html を吐き出す Aglio API Blueprint
  22. 22. カスタマイズ Sansan テンプレ
  23. 23. Aglio のデフォルト デザイン CSSだけ手を入れ Sansan風に
  24. 24. 変えてよかったこと
  25. 25. 営業系のメンバーが 外部の方に 積極的に案内したくなる リンクを送りあえるので 問い合わせ対応など 会話しやすい
  26. 26. API Blueprintはナウくない 残念なお知らせ
  27. 27. 時代は Swagger ・Swagger ・API Blueprint
  28. 28. GUIでAPIの設計が できる Swagger Editor ついでに ドキュメントを 自動生成できる Swagger UI クライアント・ サーバのコードが 生成できる サンプルコードを取得 できる・モックサーバ を立てれる、 且つ言語も選べる Swagger Codegen Swagger Swagger’s demo
  29. 29. 一緒に頑張ろ 3
  30. 30. 一緒にもりあげませんか?
  31. 31. 各社APIを使ったハッカソン たとえば、各社APIを使ったアプリ開発とか
  32. 32. ごちゃまぜ勉強会 API提供者、エンドユーザ、開発者など、 ごちゃまぜ情報交換勉強会 「こんなのにつないでみました」 「こんなツールつかってます」 SYSTEM INTEGRATOR USERS
  33. 33. 最後に宣伝
  34. 34. 企業に眠るすべての顧客データを 名刺データベースを用いて統合化できる Sansanの拡張ソリューション Sansan Customer Intelligence Sansan Customer Intelligence プロダクトマネージャー 清水隆介 (くまさん、Tableau兄さん)

×