APIファースト、そしてTime To First Call削減への道筋

アプリケーション開発では重要度がますます高まるAPI技術と開発プロセス。AIの利用もAPIが前提になり、人間が作ったアプリだけではなくAIによるAPI利用もますます加速します。「APIファースト」はAPIをサービスやビジネスの中心に位置付け、技術だけではなくプロセス、組織を最適化していくアプローチですが、そこでの課題の一つが、「いかにすぐにAPIを通じてサービスを使ってもらい、開発者体験を高めるか」。そして重要な指標がTime To First Call（初回APIコールまでにかかる時間）です。本セッションでは、開発者が現場で目にする具体的な問題と、Time To First Call短縮への道筋をお話しします。さらに、PostmanのAI搭載アシスタントPostbotがどのように開発者を支援し、プロダクト品質の改善や開発ワークフローの効率化を実現できるかをご紹介します。Developers Summit 2024 Kansaiでの発表資料です。

Transcript

1. All rights reserved by Postman Inc API ファースト、そして Time To First Call 削減 への道筋 草薙 昭彦 テクノロジーエバンジェリスト #devsumi
2. テクノロジーエバンジェリスト Postman 株式会社 草薙 昭彦 @postman_japan @nagix
3. @postman_japan API を呼ぶなら curl で十分だ ※ただし熟練者に限る
4. @postman_japan
5. コンピューターの歴史 @postman_japan 1 2 3 4 「API ファーストの世界」より https://www.api-first-world.com/ja/
6. API 利用が急増している背景 @postman_japan モバイル デスクトップ 利用者 インフラストラクチャ モノリス マイクロサービス アーキテクチャ オンプレミス クラウド
7. AI - 新しい API の使い手 eコマース ソーシャル ネットワーク クラウド モバイル IoT AI ユーザー： もはや自然言語で指示するだけ サービス提供者： API をちゃんと作らないと AI に使ってもらえない 時間 @postman_japan
8. 2023 State of the API Report https://www.postman.com/state-of-api/executing-on-apis/#obstacles-to-consuming-apis #1 パートナー連携が早い 87% #2 オンボードが早い 88% #3 より幸せ 78% #4 より良いソフトウェアを作成 78% #5 生産性が高い 85% #6 新製品を早くリリース 78% #7 セキュリティリスクを早く解消 72% API ファーストのメリットは？ @postman_japan あまりそう思わない 強くそう思わない ややそう思う 強くそう思う
9. API ファースト戦略とは？ • API に対する位置づけ、考え方 ◦ API はプロダクト（主要ソフトウェア構成要素、主要ビジネスアセット） ◦ API がビジネスにもたらす価値に焦点を当てる ◦ API 中心：内外サービスを API を通じて活用しビルディングブロックで構築 • API 開発モデル ◦ API を最優先に開発（API を後回しにしない） ◦ コードを書く前に API を設計・構築 • API ファースト採用のために必要な取り組み ◦ API ライフサイクルを理解しライフサイクル全体で取り組む ◦ API の継続的な保守・運用のためのチーム体制を構築する APIFirst Guide https://www.postman.com/api-first/ @postman_japan
10. API ファースト開発モデル • 焦点は API の設計（システムの抽象的な「契約」） • コードを書く前に API を設計・構築し、モック、ドキュメント、テストも作成 • 設計フェーズでフィードバックループを通じて設計内容を洗練化 API-first software development for modern organizations　 https://medium.com/better-practices/api-first-software-development-for-modern-organizations-fdbfba9a66d3 API設計 テスト APIドキュメント 作成 モック作成 実装 コーディング 統合 テスト実行 監視実行 サーバー環境 Dev Stage Prod モック活用 テスト ドキュメント 活用 コードリポジトリ モックを元にレビューや フィードバックを受け 設計内容を洗練させる check-in デプロイ エンドポイント にテスト API開発環境 @postman_japan
11. 2023 State of the API Report https://www.postman.com/state-of-api/executing-on-apis/#obstacles-to-consuming-apis #1 ドキュメント不足 52% #2 API の発見が困難 32% #3 時間がない 28% #4 知識不足 26% #5 予算不足 23% #6 人員不足 22% #7 API の再利用が困難 19% API 利用における障壁 @postman_japan
12. API に関する指標の例 • 運用上の指標 ◦ インフラ関連 ▪ アップタイム ▪ リソース使用率 ▪ エラーレート ◦ アプリ関連 ▪ 単位時間リクエスト数 ▪ 平均・最大レスポンス時間 ▪ 単位時間エラー数 @postman_japan • 採用に関する指標 ◦ ユニーク利用者数 ◦ API 利用増加率、MAU ◦ Time To First Call • 製品としての指標 ◦ 発生収益 ◦ API 当たりのアプリ数 ◦ パートナー数 ◦ リテンション、顧客満足度
13. こんなことないですか • それ、あなたの Web API サービス に起こっているかも • Web ページのロード時間がコンバー ジョンやリテンションに影響するのも 同じ @postman_japan スマホでアプリを検索 ダウンロードしてみた 数回クリックしてみた でもユーザー登録に辿り着く前にやめた なんか覚えのないアプリが・・
14. Time To First Call TTFC どれだけ短時間で API の初回呼び出しができるかを表すメトリクス。API 提供者は TTFC を分析し API を改善し、その短縮を目指す • Web 分析やユーザーフィードバックにより測定 ◦ Web 分析計測：発見時点（Web サイトへの訪問、サインアップなど）から 最初の API 呼び出しまでの時間差 • メトリクス分析からの洞察 ◦ 開発者が閲覧からサインアップまでに費やす時間が長い → Web サイトやドキュメントの品質に起因 する可能性が考えられる ◦ サインアップから最初の API 呼び出しまでの時間が長い → ガイドページの有効性や製品の使いやすさに起因 する可能性が考えられる The Most Important API Metric Is Time to First Call https://blog.postman.com/the-most-important-api-metric-is-time-to-first-call/ @postman_japan
15. なぜ TTFC が重要か？ 開発者の API ジャーニーはファネル • 大多数の開発者は、実際の API のコー ルで「理解」し「納得」する • ジャーニーの早期段階である TTFC を 短縮することで、後段において「わかっ ている」質の良いユーザーの正当な評 価を受けることができる @postman_japan ドキュメント閲覧 サインアップ 最初の API コール 実装 本番利用
16. TTFC の適切な目標は？ • Twilio の例 ◦ 「開発者がサービス利用開始するまでの時間を 5 分以内に」 • Ably の例 ◦ 5 段階でベンチマーク ◦ 〜30分／30分〜1時間／1〜2時間／2〜4時間／4時間〜 • PayPal の例 ◦ 数時間だった TTFC を 1 分に短縮 @postman_japan
17. TTFC を改善するには 利用者をよく理解し、必要な情報をもれなく盛り込む @postman_japan 優れたドキュメント ユースケースや サンプル プロセス上の 障害を排除 早い段階で API コールできる工夫 外部ツールの利用 利用者の抱える課題に対する正しい解決策かどうかを 明確にする 認証情報の取得時に人手の介入の必要を極力なくし 丁寧にガイドする API サンドボックスの提供など API プラットフォーム製品、 ノーコード／ローコード製品
18. API サンドボックスの例 @postman_japan GMO あおぞらネット銀行の API 実験場「sunabar」 https://gmo-aozora.com/baas/sunabar/
19. Postman API プラットフォーム @postman_japan 日本語 UI 対応
20. Postman コレクション = 実行可能 API ドキュメント • コレクション は API リクエストをグループにして整理した、基本となるデータ構造 • コレクションを一言でいうと、実行可能な API ドキュメント コレクション APIリクエスト テスト サンプル APIリクエスト テスト サンプル APIリクエスト テスト サンプル @postman_japan
21. Postman API ネットワーク（ API カタログ） @postman_japan プライベート API ネットワーク パブリック API ネットワーク • チームメンバーに限定 • チーム内の機能重複の排除 • API 知見やノウハウの共有 • チーム内の API 利用動向の把握 • 多くの利用者・開発者に知ってもらう • 利用者の Time To First Call の短縮 • 利用者からのフィードバックと改善
22. freee 様チーム日本で初めてブルーバッジ獲得 https://www.postman.com/freee-public-api @postman_japan
23. @postman_japan Postbot Postman の AI アシスタント 無料でスタート！
24. ドキュメントの生成 @postman_japan
25. Postman Flows: API ビジュアルフローの生成 @postman_japan
26. ダウンロードして無料でスタート！ https://www.postman.com/downloads/ デスクトップアプリ • Windows • Mac • Linux Web アプリ • アカウント登録で同 じ機能をブラウザで も利用できる @postman_japan
27. Postman Japan コミュニティ Discord Discord サーバーを開設しました！ 今後 Postman のプロダクトアップデートやイベン ト情報の配信や、みなさんとの交流の場として活 用していきたいと思います。 https://discord.gg/G4SQWDDqVa @postman_japan
28. Postman Connpass グループ API Night（勉強会）& ワークショップ https://postman.connpass.com/ Postman イベントにぜひご参加ください Postman Japan X アカウント @postman_japan @postman_japan
29. ありがとうございました @postman_japan