Upgrade to Pro — share decks privately, control downloads, hide ads and more …

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

草薙昭彦
September 18, 2024

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での発表資料です。

草薙昭彦

September 18, 2024
Tweet

More Decks by 草薙昭彦

Other Decks in Technology

Transcript

  1. All rights reserved by Postman Inc API ファースト、そして Time To

    First Call 削減 への道筋 草薙 昭彦 テクノロジーエバンジェリスト #devsumi
  2. AI - 新しい API の使い手 eコマース ソーシャル ネットワーク クラウド モバイル

    IoT AI ユーザー: もはや自然言語で指示するだけ サービス提供者: API をちゃんと作らないと AI に使ってもらえない 時間 @postman_japan
  3. 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 あまりそう思わない 強くそう思わない ややそう思う 強くそう思う
  4. API ファースト戦略とは? • API に対する位置づけ、考え方 ◦ API はプロダクト(主要ソフトウェア構成要素、主要ビジネスアセット) ◦ API

    がビジネスにもたらす価値に焦点を当てる ◦ API 中心:内外サービスを API を通じて活用しビルディングブロックで構築 • API 開発モデル ◦ API を最優先に開発(API を後回しにしない) ◦ コードを書く前に API を設計・構築 • API ファースト採用のために必要な取り組み ◦ API ライフサイクルを理解しライフサイクル全体で取り組む ◦ API の継続的な保守・運用のためのチーム体制を構築する APIFirst Guide https://www.postman.com/api-first/ @postman_japan
  5. 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
  6. 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
  7. API に関する指標の例 • 運用上の指標 ◦ インフラ関連 ▪ アップタイム ▪ リソース使用率

    ▪ エラーレート ◦ アプリ関連 ▪ 単位時間リクエスト数 ▪ 平均・最大レスポンス時間 ▪ 単位時間エラー数 @postman_japan • 採用に関する指標 ◦ ユニーク利用者数 ◦ API 利用増加率、MAU ◦ Time To First Call • 製品としての指標 ◦ 発生収益 ◦ API 当たりのアプリ数 ◦ パートナー数 ◦ リテンション、顧客満足度
  8. こんなことないですか • それ、あなたの Web API サービス に起こっているかも • Web ページのロード時間がコンバー

    ジョンやリテンションに影響するのも 同じ @postman_japan スマホでアプリを検索 ダウンロードしてみた 数回クリックしてみた でもユーザー登録に辿り着く前にやめた なんか覚えのないアプリが・・
  9. 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
  10. なぜ TTFC が重要か? 開発者の API ジャーニーはファネル • 大多数の開発者は、実際の API のコー

    ルで「理解」し「納得」する • ジャーニーの早期段階である TTFC を 短縮することで、後段において「わかっ ている」質の良いユーザーの正当な評 価を受けることができる @postman_japan ドキュメント閲覧 サインアップ 最初の API コール 実装 本番利用
  11. TTFC の適切な目標は? • Twilio の例 ◦ 「開発者がサービス利用開始するまでの時間を 5 分以内に」 •

    Ably の例 ◦ 5 段階でベンチマーク ◦ 〜30分/30分〜1時間/1〜2時間/2〜4時間/4時間〜 • PayPal の例 ◦ 数時間だった TTFC を 1 分に短縮 @postman_japan
  12. TTFC を改善するには 利用者をよく理解し、必要な情報をもれなく盛り込む @postman_japan 優れたドキュメント ユースケースや サンプル プロセス上の 障害を排除 早い段階で

    API コールできる工夫 外部ツールの利用 利用者の抱える課題に対する正しい解決策かどうかを 明確にする 認証情報の取得時に人手の介入の必要を極力なくし 丁寧にガイドする API サンドボックスの提供など API プラットフォーム製品、 ノーコード/ローコード製品
  13. Postman コレクション = 実行可能 API ドキュメント • コレクション は API

    リクエストをグループにして整理した、基本となるデータ構造 • コレクションを一言でいうと、実行可能な API ドキュメント コレクション APIリクエスト テスト サンプル APIリクエスト テスト サンプル APIリクエスト テスト サンプル @postman_japan
  14. Postman API ネットワーク( API カタログ) @postman_japan プライベート API ネットワーク パブリック

    API ネットワーク • チームメンバーに限定 • チーム内の機能重複の排除 • API 知見やノウハウの共有 • チーム内の API 利用動向の把握 • 多くの利用者・開発者に知ってもらう • 利用者の Time To First Call の短縮 • 利用者からのフィードバックと改善
  15. ダウンロードして無料でスタート! https://www.postman.com/downloads/ デスクトップアプリ • Windows • Mac • Linux Web

    アプリ • アカウント登録で同 じ機能をブラウザで も利用できる @postman_japan