APIは50年以上前から存在していますが、技術に対する多くの話題や関心とともに、この10年ほどでようやく主流になりました。 APIを導入することには、公開用と内部用の両方で多くの利点があります。しかし、様々な組織やチームは、成功するAPIへの旅に乗り出す際に、依然として苦労し、問題に直面しています。 最近、私はAPIvistaのCTOであるクリス・ブッセ氏（@busse）と座って、APIについて、そして組織がAPIについてどのように考えるべきかについて話しました。APIvistaは、APIに特化した開発およびマネージドサービス会社で、APIを活用してクライアントが新しいビジネス価値を提供できるよう支援しています。IT業界で20年以上の経験を持つクリスは、企業や組織がAPI戦略にどのように取り組むべきかについて貴重な洞察を提供してくれました。
成功するAPIの構築
クリスによると、成功するAPIは、企業のポートフォリオにおける他の第一級製品と同じ注意と配慮をもって扱われる必要があります。
「APIを利用する開発者に対して、顧客と同じように、真のプロダクトマネジメントの共感を理解し、持つことは、採用される優れたAPIを設計する上で大いに役立ちます。」
APIを扱う際にプロダクトマネジメントの原則と実践を適用することは、APIを第一級製品として扱うための第一歩です。プロダクトマネージャーは最終顧客を理解しています。APIにも同じことが言えます。 APIの最終消費者のニーズを理解し、APIが彼らのソフトウェア開発ライフサイクルにどのように適合するかを学ぶことは、堅牢なAPIを構築するために不可欠です。API開発および展開ライフサイクルのすべての段階で最終消費者のニーズを考慮に入れることは、APIの開発を正しい方向に導くのに役立ちます。 次に、ユーザーエクスペリエンスへの共感があります。APIとその周辺のアーティファクトやサービスを、意図する消費者の学習曲線を短縮する意図を持って設計することは、常に最優先事項であるべきです。エンドユーザーを念頭に置いてAPIを構築することは、デザイン思考アプローチの基盤です。デザイン思考は、最終消費者、ビジネス、テクノロジーの間のバランスを見つけようとします。 APIにも同じことが言え、理想的には、適切に設計されたAPIは、この最適なバランスを見つけます。これは、APIの使用量の増加に伴ってビジネス価値が派生し、駆動され、実装されたテクノロジーにエラーがなく、受け入れられた標準に準拠していることを意味します。 プロダクトマネジメントとユーザーエクスペリエンスの原則の適切なバランスがあれば、最終消費者はAPIを簡単に採用して使用できます。どのような製品と同様に、採用は採用を生みます。 クリスは、これが特にパブリックAPIに当てはまると考えています。私たちは、多くの場合、コミュニティがAPIから多くの価値を得られれば、ドキュメントの構築からクライアントSDKの開発まで、APIの採用に貢献するために協力することを目にします。
市場投入速度は考慮事項か？
リリース日を正確に見積もることが重要です。多くの場合、APIの市場投入速度と設計の一貫性にはトレードオフがあります。市場投入速度は重要ですが、非効率的で不十分に設計されたAPIの初回リリースにつながるべきではありません。 この目的のために、クリスは、APIの開発フェーズ中に、いくつかの初期のターゲット消費者を特定し、彼らからできるだけ多くのフィードバックを得ることを推奨しています。これにより、リリース期限を守りながら、APIの良好な初回リリースが可能になります。ハッカソンの開催からパイロット顧客の特定まで、ユーザーフィードバックを収集する革新的な方法は尽きません。
注意すべき間違い
この戦略でよく発生する間違いの1つは、組織がAPIをこれらの初期顧客のニーズのみに合わせて調整し、APIが市場全体に対応できる共通性を持つことを期待することです。しかし、実際には、これらの共通性がより多くの違いを生み出すことになります。 したがって、これらの初期顧客からのフィードバックに対してオープンエンドな見通しを持つことが推奨されます。具体的なバージョン管理戦略を導入することも、これを克服するのに役立ちます。 クリスによると
「組織は、APIに新しい変更を追加する時期と方法について、確固たる計画を立て、時間をかけてより多くの最終消費者にサービスを提供する必要があります。」
組織が従いたい理想がある場合、市場投入までの時間が大きな負担になることがあります。APIの新しいレベルの標準であるハイパーメディアAPIの例を考えてみましょう。ハイパーメディアベースのAPIを公開することで多くのメリットが得られますが、組織は最終顧客がこれらのAPIを使用できる成熟度と専門知識を確実に持っていることを確認する必要があります。新しい標準を採用することで、公開者は最終顧客にある程度の知識を期待していることを覚えておいてください。 クリスは説明します。
「彼らはソーシャルスペースやデジタルユーザーエクスペリエンススペースで技術的または最先端の製品を持っているかもしれませんが、中には長い道のりを歩んできた人もおり、APIを第一級製品にまで引き上げる道のりの途中にいるかもしれません。」
「デザインファースト」アプローチを採用するタイミング
組織が理想を追求するのに十分な成熟度を持っている場合、デザインファーストは理にかなっています。クリスが説明するように、APIの設計が提案され決定され、APIの開発が開始されたものの、開発中に設計が更新されたケースが多々あります。 これは孤立したケースではなく、様々なチーム間のコミュニケーションが十分に強固でない場合に頻繁に発生する可能性があります。このずれは、チームの作業量を増やすだけでなく、場合によっては、チーム間の多くの不満、敵意、不信感につながる可能性があります。 開発チームがAPIの実装を先行できるようにAPIの設計を提供する場合、開発チームとのオープンなコミュニケーションラインと、多くの信頼が必要です。したがって、OpenAPI仕様（以前はSwagger仕様として知られていた）、RAML、API Blueprintのような記述形式は非常に優れたニーズを満たしますが、「デザインファースト」または「コードファースト」として開発に取り組むには、より多くの検討が必要です。したがって、APIジャーニーを経験し、どのアプローチが開発チームに合っているかを把握することが重要です。紙の上の理想が常に実践で最善であるとは限りません。 クリスはデザインの一貫性の重要性を繰り返し強調しました。APIを構築するアプローチに関係なく、組織が提供する異なる製品やサービスのための異なるAPIは、同じ内部ガイドラインを持つべきです。エンド開発者は、組織が提供するすべてのAPIが同じ組織によって構築されたと感じるべきです。これらのAPIが互いに相互作用しない場合でも、これは当てはまります。 例えば、YouTube、Google+、Google Mapsのような複数の無関係な製品のAPIを持つGoogleのような企業でも、開発者がAPIに簡単に適応できるような、ある種の内部標準に従うことができます。このプレゼンテーションの一貫性は、クリスがすべての顧客に推奨しているものです。
成功の測定
API投資における課題の1つは、ROIが当初は無形である可能性があるという認識です。API投資の成功は、組織がリピートビジネスをどのくらいの頻度で獲得するか、契約更新の頻度、組織の製品やサービスがどのくらいの人気を得るかによって測定できます。これらすべては自然に成長と収益につながり、多くの場合、後になって幹部は、それがAPIを第一級製品として扱うという会社の投資によるものだったと認識します。 もう1つの成功の優れた指標は、ユーザーの採用です。APIの消費者体験には多くの時間を費やす必要があります。クリスと彼のチームが測定するものの1つは、「ハローワールド」までの時間です。これは、APIの最終消費者が成功した呼び出しを行うのにかかる時間です。ドキュメントとコードサンプルが優れているほど、エンドユーザーが認証してAPIを呼び出すのに必要な時間は短くなります。
適切な期待値の設定
組織が公開したAPIを利用するには、顧客側でもコストと労力がかかることを認識することが重要です。これらのAPIは、同様のサービスを公開する他のAPIや製品と顧客のリソースを競合することにもなります。したがって、APIが構築されればユーザーが自動的に利用し始めると期待するのは、適切なアプローチではありません。 他の製品と同様に、APIもターゲットオーディエンスに到達するには時間と労力がかかります。APIの採用には、多くの人が考えているよりも長い時間がかかり、最も成功したAPIでさえ、その人気レベルに達するまでに3〜5年かかりました。採用から、APIのサポートとメンテナンスへのコミットメントまで、APIのさまざまなフェーズには総所有コストがあり、適切な成功を達成するには長い道のりがあります。 クリスの言葉を借りれば、次のとおりです。
「企業はAPIライフサイクルのさまざまな段階にいる可能性があり、同じ勢いでゴールラインに到達することを期待するのは現実的ではありません。」
結局のところ、すべてのAPIは最終消費者のペインポイントを解決しようとしています。価値の帰属をペインポイントと、APIが提供するソリューションに結びつけることが、技術レベルとビジネスレベルの両方で最終的に成功させることになるでしょう。
APIの未来
クリスは、人間が機械と対話するために使用するインターフェースは背景に消え、コンピューティングはどこにでもあり、目に見えないものになると感じています。私たちはすでに、最初のコンピューターの巨大な箱からポケットに入っているiPhoneの7インチディスプレイまで、過去数十年間でインターフェースが大きく進化するのを見てきました。APIについても同じことが言えるかもしれません。エンド開発者が利用できるよう、より優れた興味深いインターフェースが進化するでしょう。
さらに詳しく知りたいですか？
クリス・ブッセは今週、マサチューセッツ州ボストンで開催されるAPI戦略＆実践会議（APIStrat）で発表します。 詳細はこちら。 Twitterでクリス・ブッセをフォローして、API分野に関する彼の考えを共有しましょう。APIvistaについてさらに詳しく知りたい場合は、こちらのウェブサイトをご覧ください。