APIファーストアプローチがZonosの未来を形作る

APIファーストアプローチとは？ 

APIファーストアプローチは、アプリケーションの機能を設計し、コードを書き、プロセスの最後にAPIを追加するコードファーストアプローチと対照的です。

Zonosでは、APIファーストアプローチでソフトウェアを構築するとは、後からAPIを追加するのではなく、APIを中心にソリューションを設計することを意味します。つまりAPIが最優先であり、それ自体が製品です。顧客のニーズに強い焦点を当てて設計し、コードを書く前に明確に文書化・アーキテクチャ設計します。

APIファーストアプローチのメリット 

APIファーストアプローチは、以下のマインドセットの確立に役立ちます：

• APIが顧客にとっての主要なインターフェースであり、公開成果物と見なす。
• コードを書く前に文書化することで、チームやステークホルダーと目的を議論・洗練・共有し、より良い最終製品を作る機会を得る。
• 顧客のニーズに焦点を当て、そのニーズを満たすAPIを最善に設計する方法を理解する。

このマインドセットはAPIと顧客を最優先に置き、Zonosの全員が顧客の成功に責任を持つ基盤を確立する上で重要です。

開発チームが並行して作業できる

APIファーストアプローチには契約の確立が含まれます。組織全体のチームが従うサービス間の契約を作成すると、複数のAPIを同時に作業できます。開発者は次のAPIに進む前にAPI更新のリリースを待つ必要がありません。事前に確立されたAPI定義に基づいて、チームはAPIとAPI依存関係を同時にモックテストできます。

開発コストの削減

APIとコードは多くのプロジェクトで再利用できます。APIファーストアプローチでは、開発チームが新しいアプリケーションを構築する際、一から始める必要がなく、時間とコストを節約できます。APIファースト設計では、コードを書く前に多くの問題を解決できるため、APIをアプリケーションに統合する際の問題を防ぐのに役立ちます。

市場投入速度の向上

API構築プロセスの多くは、API定義ファイルをインポートするツールで自動化できます。コア型、定義、スキーマの生成から始め、それらのファイルでAPIドキュメント、ソフトウェア開発キット（SDK）、モックAPIなどを自動生成できます。自動化はAPIとアプリケーションの開発を大幅に加速します。

APIファーストは、アーキテクチャ全体を再設計せずに新しいサービスやテクノロジーをアプリケーションに追加することも可能にします。Zonosは常に変化する越境SaaS市場で競争力を維持するため、機能を迅速に本番環境に出荷する必要があります。設計の悪いAPIから顧客を移行するより、基盤コードの技術的負債を解消する方が容易です。

優れた開発者体験の確保

API利用者は多くの場合開発者であり、開発者体験（DX）はAPIの成功を左右します。APIファーストアプローチは、設計・文書化・一貫性に優れたAPIは学習と再利用が容易であるため、開発者体験がポジティブであることを保証します。実装速度も向上します。これらのメリットはすべて相互に関連しています！

長期的成功の向上

APIファーストアプローチは迅速なプロトタイピングと反復を可能にし、何が機能し何が機能しないかをより早く学べます。電球を作る前に1,000回失敗したエジソンのように、APIファーストは迅速に失敗し、成功達成方法のより良い理解で前進することを意味します。APIファーストは、APIが信頼性が高く一貫性があり開発者が使いやすいことを保証することで、長期的成功を高めます。

逆算思考はなぜ効果的か？ 

2015年、人気の消費者ブランドのeコマースサイトを再設計する機会がありました。既存システムに関連するさまざまなKPIを評価し、最大の改善余地が明確でした：

• デスクトップのコンバージョン率が基準以下。
• モバイルのコンバージョン率が極めて低い。
• モバイルトラフィックの割合が急速に増加し、12か月以内に総トラフィックの50%を超える見込み。モバイルコンバージョン率が極めて低いため、トラフィックの大部分がモバイルであることは理想的ではありません。

データを踏まえ、ユーザーに最大の価値を創出するのは何でしょうか。明らかでした：サイトのモバイルユーザー体験の問題を修正すること。したがって、サイト再設計にモバイルファーストアプローチを取りました。つまり、設計、アーキテクチャ、APIなどすべてがまずモバイル体験を考慮しました。当時の従来のアプローチ — まずデスクトップ体験に焦点を当て、モバイル体験を後付けで不器用に追加し、コンバージョン率が低い — とは逆でした。モバイルファーストアプローチは初期により多くの労力を必要としました — 簡単な道ではありませんでした。新しいアーキテクチャが必要で、新しいAPIを書く必要があり、すべてのブレークポイントで複数の設計が必要でした。

モバイルファーストアプローチは、モバイルコンバージョン率の大幅な向上をもたらしました。新しいアーキテクチャはデスクトップコンバージョン率でも印象的な改善を生み出しました。このアプローチは、最大のユーザー価値を創出する方法を特定し、最初からその価値提供に全体のアプローチを集中させたため成功しました。最初から正しいマインドセットを作りました。同様に — 逆算しているように感じるかもしれませんが — APIファーストアプローチは、全体的な問題を特定し、それらを修正する基盤を構築する機会を生み出します。

エンジニアリングの責任は？ 

APIファーストマインドセットはZonosを成功に導いてきており、今後も導き続けます。エンジニアリングは不可欠な役割を果たします。常にAPIファーストマインドセットを維持することが私たちの責任です。つまり、「APIで顧客のニーズをどう満たせるか」など、APIへの焦点を保つ質問を常にします。また、機能や機能性に関する質問には常にAPIドキュメントへのリンクで応答します。ドキュメントが存在しない場合は作成し — クロスファンクショナルチームで協力して、Zonosが優れたAPIドキュメントを持つことを保証します。