All rights reserved by Postman Inc API ファースト、そして Time To First Call 削減 への道筋 草薙 昭彦 テクノロジーエバンジェリスト #devsumi

テクノロジーエバンジェリスト Postman 株式会社 草薙 昭彦 @postman_japan @nagix

@postman_japan API を呼ぶなら curl で十分だ ※ただし熟練者に限る

@postman_japan

コンピューターの歴史 @postman_japan 1 2 3 4 「API ファーストの世界」より https://www.api-first-world.com/ja/

API 利用が急増している背景 @postman_japan モバイル デスクトップ 利用者 インフラストラクチャ モノリス マイクロサービス アーキテクチャ オンプレミス クラウド

AI - 新しい API の使い手 eコマース ソーシャル ネットワーク クラウド モバイル IoT AI ユーザー： もはや自然言語で指示するだけ サービス提供者： API をちゃんと作らないと AI に使ってもらえない 時間 @postman_japan

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 あまりそう思わない 強くそう思わない ややそう思う 強くそう思う

API ファースト戦略とは？ ● API に対する位置づけ、考え方 ○ API はプロダクト（主要ソフトウェア構成要素、主要ビジネスアセット） ○ API がビジネスにもたらす価値に焦点を当てる ○ API 中心：内外サービスを API を通じて活用しビルディングブロックで構築 ● API 開発モデル ○ API を最優先に開発（API を後回しにしない） ○ コードを書く前に API を設計・構築 ● API ファースト採用のために必要な取り組み ○ API ライフサイクルを理解しライフサイクル全体で取り組む ○ API の継続的な保守・運用のためのチーム体制を構築する APIFirst Guide https://www.postman.com/api-first/ @postman_japan

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

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

API に関する指標の例 ● 運用上の指標 ○ インフラ関連 ■ アップタイム ■ リソース使用率 ■ エラーレート ○ アプリ関連 ■ 単位時間リクエスト数 ■ 平均・最大レスポンス時間 ■ 単位時間エラー数 @postman_japan ● 採用に関する指標 ○ ユニーク利用者数 ○ API 利用増加率、MAU ○ Time To First Call ● 製品としての指標 ○ 発生収益 ○ API 当たりのアプリ数 ○ パートナー数 ○ リテンション、顧客満足度

こんなことないですか ● それ、あなたの Web API サービス に起こっているかも ● Web ページのロード時間がコンバー ジョンやリテンションに影響するのも 同じ @postman_japan スマホでアプリを検索 ダウンロードしてみた 数回クリックしてみた でもユーザー登録に辿り着く前にやめた なんか覚えのないアプリが・・

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

なぜ TTFC が重要か？ 開発者の API ジャーニーはファネル ● 大多数の開発者は、実際の API のコー ルで「理解」し「納得」する ● ジャーニーの早期段階である TTFC を 短縮することで、後段において「わかっ ている」質の良いユーザーの正当な評 価を受けることができる @postman_japan ドキュメント閲覧 サインアップ 最初の API コール 実装 本番利用

TTFC の適切な目標は？ ● Twilio の例 ○ 「開発者がサービス利用開始するまでの時間を 5 分以内に」 ● Ably の例 ○ 5 段階でベンチマーク ○ 〜30分／30分〜1時間／1〜2時間／2〜4時間／4時間〜 ● PayPal の例 ○ 数時間だった TTFC を 1 分に短縮 @postman_japan

TTFC を改善するには 利用者をよく理解し、必要な情報をもれなく盛り込む @postman_japan 優れたドキュメント ユースケースや サンプル プロセス上の 障害を排除 早い段階で API コールできる工夫 外部ツールの利用 利用者の抱える課題に対する正しい解決策かどうかを 明確にする 認証情報の取得時に人手の介入の必要を極力なくし 丁寧にガイドする API サンドボックスの提供など API プラットフォーム製品、 ノーコード／ローコード製品

API サンドボックスの例 @postman_japan GMO あおぞらネット銀行の API 実験場「sunabar」 https://gmo-aozora.com/baas/sunabar/

Postman API プラットフォーム @postman_japan 日本語 UI 対応

Postman コレクション = 実行可能 API ドキュメント ● コレクション は API リクエストをグループにして整理した、基本となるデータ構造 ● コレクションを一言でいうと、実行可能な API ドキュメント コレクション APIリクエスト テスト サンプル APIリクエスト テスト サンプル APIリクエスト テスト サンプル @postman_japan

Postman API ネットワーク（ API カタログ） @postman_japan プライベート API ネットワーク パブリック API ネットワーク ● チームメンバーに限定 ● チーム内の機能重複の排除 ● API 知見やノウハウの共有 ● チーム内の API 利用動向の把握 ● 多くの利用者・開発者に知ってもらう ● 利用者の Time To First Call の短縮 ● 利用者からのフィードバックと改善

freee 様チーム日本で初めてブルーバッジ獲得 https://www.postman.com/freee-public-api @postman_japan

@postman_japan Postbot Postman の AI アシスタント 無料でスタート！

ドキュメントの生成 @postman_japan

Postman Flows: API ビジュアルフローの生成 @postman_japan

ダウンロードして無料でスタート！ https://www.postman.com/downloads/ デスクトップアプリ ● Windows ● Mac ● Linux Web アプリ ● アカウント登録で同 じ機能をブラウザで も利用できる @postman_japan

Postman Japan コミュニティ Discord Discord サーバーを開設しました！ 今後 Postman のプロダクトアップデートやイベン ト情報の配信や、みなさんとの交流の場として活 用していきたいと思います。 https://discord.gg/G4SQWDDqVa @postman_japan

Postman Connpass グループ API Night（勉強会）& ワークショップ https://postman.connpass.com/ Postman イベントにぜひご参加ください Postman Japan X アカウント @postman_japan @postman_japan

ありがとうございました @postman_japan