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とアプリケーションの開発を大幅に加速します。

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

良好な開発者体験を確保

APIの消費者は最も多くの場合開発者であり、開発者体験（DX）はAPIの成功を左右します。APIファーストアプローチは、よく設計され、文書化され、一貫性のあるAPIが学びやすく再利用しやすいため、開発者体験がポジティブであることを保証します。これにより、実装のスピードも向上します。これらの利点はすべて相互に関連しています！

長期的な成功を高める

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

なぜ逆算が効果的なのか？ 

2015年、私は人気の消費者ブランドのeコマースサイトを再設計する機会を得ました。既存のシステムに関連するさまざまな主要業績評価指標（KPI）を評価し、最も大きな改善が可能な点はclearであることがわかりました：

• デスクトップのコンバージョンrateは標準以下でした。
• モバイルのコンバージョンrateはひどいものでした。
• モバイルトラフィックの割合は急速に増加しており、次の12か月以内に総トラフィックの50％を超える見込みでした。ひどいモバイルコンバージョンrateのため、モバイルトラフィックのほとんどは理想的ではありませんでした。

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

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

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

APIファーストの考え方は、Zonos の成功を導いており、今後もそうであり続けます。エンジニアリングはその重要な役割を果たしています。私たちの責任は、常にAPIファーストの考え方を維持することです。これは、私たちが常にAPIに焦点を当てる質問をし続けることを意味します。例えば、“私たちのAPIは顧客のニーズをどのように満たすことができるか」という質問です。また、機能や機能性に関する質問には、常にAPIドキュメントへのリンクを添えて回答します。ドキュメントが存在しない場合は、それを作成します—Zonos の優れたAPIドキュメントを確保するために、クロスファンクショナルチームで協力して作業します。