アプリケーションプログラミングインターフェース（API）は、テクノロジー業界で注目されるキーワードになりました。戦略目標を達成するためにAPIプログラムを開発することの実際的な意味を理解する組織が増えています。このような状況で、APIの価値と利点を、潜在的なユーザーや顧客にとって理解しやすい方法でより良く促進することが重要です。 私は、ジェニファー・"ジェン"・リギンズ氏（eBranding Ninjaのマーケティングコンサルタント兼テックストーリーテラー）と対談し、API実践者の間に存在するカルチャーについて話す機会を得ました。ジェン氏はAPI分野の著名なマーケター兼ブランディングコンサルタントです。APIコミュニティで数少ない正式な技術トレーニングを受けていないストーリーテラーの一人として、彼女はAPI分野に存在するカルチャーに独自の視点を提供し、APIのストーリーを幅広い聴衆に伝えることの重要性について語ります。
APIイノベーションの文化
ジェン氏は、APIへの関心が過去10年間で大きな勢いを増し、私たちの未来を形成する上で主要な役割を果たすだろうと信じています。APIは、APIコミュニティの努力により、APIエコノミーへの投資の利点を啓蒙し、意識を高めることで、一部で主流になりました。APIベンダー、実践者、消費者からなるこのコミュニティは、オープン性とコラボレーションによって推進されており、API分野における重要な発展につながっています。 オープン性、透明性、探求心の融合がイノベーションの文化を生み出しています。これにより、OpenAPI仕様のようなAPI定義フォーマットから、ハイパーメディアやグラフのような新しいアーキテクチャまで、短期間でAPI分野に浸透した新しいテクノロジーの数が増加しました。API実践者の大部分はオープンソースプロジェクトにルーツを持っているため、この一般的なコラボレーション文化はオープンソースコミュニティの反映です。コラボレーションを促進し、より迅速なエンジニアリングを育成するために、SwaggerHubのようなAPI開発プラットフォームは、チームが堅牢なAPIを共同で設計し文書化するのに役立つ機能を提供しています。 「テクノロジー分野では、開発者により多くの力を与え、ソフトウェアプロジェクトでのコラボレーションを増やすという一般的な傾向があります。これはオープンソースコミュニティの基盤であり、APIコミュニティでも同様に見られます」とジェン氏は述べています。 彼女は、APIコミュニティは非常に歓迎的で魅力的であり、メンバーがその過程で学び成長することを可能にしていると述べています。APIの開発と統合には、さまざまなバックグラウンドとスキルセットを持つ人々が混在しており、多様な視点が議論にもたらされます。ジェン氏はまた、APIの認知度が高まるにつれて、コミュニティの地理的範囲も拡大していると観察しました。 「それは非常に仮想的なコミュニティです。これは、テクノロジー自体の性質と、そのルーツがオープンソースコミュニティにあることの両方に起因しています。」 この文化は、API分野での競争の激化により変化する可能性があります。テクノロジー大手によるAPIドキュメントおよび管理ソリューションのリリースへの投資が急増しており、これはAPIコミュニティの代名詞であるオープン性と透明性の一般的な文化に影響を与える可能性があります。
なぜAPIには優れたストーリーテラーが必要なのか
ジェン氏は、API業界におけるマーケティング不足という重要な点を提起しました。マーケティングとは、適切なストーリーを適切な聴衆に伝え、彼らがあなたの製品を使用して目標を達成できるよう支援することです。APIのビジネスモデルが確立された今、APIのストーリーをターゲット市場にどれだけ効果的に伝えているかに注意を払うことが重要です。APIは常に技術的な側面を持っていたため、ほとんどの開発者はAPIをマーケティングする際に、そのAPIのコアテクノロジーに焦点を当て、ビジネス価値に焦点を当てません。 「現在、業界が直面している大きな問題点はコミュニケーションです。基本的に、開発者はまだAPIの宣伝や幅広い聴衆への翻訳が苦手です。API開発者とベンダーは、APIのビジネス価値を潜在顧客に伝え、それが彼らにどのように役立つかを伝える必要があります。」 ジェン氏は続けて、「多くのAPIドキュメントとマーケティングは、APIがユーザーに何を達成するのに役立つかという基本的な要約さえ省略しています。」と述べました。 彼女は、数年前のAPIdaysでのアンドリュー・スワード氏の講演を引用し、そこで彼は聴衆に1分間でお互いのAPIを説明するように求めました。 「人々は、それらを駆動する言語とアーキテクチャについて直接説明し始め、その背後にあるビジネス価値を完全に飛ばしました」とジェン氏は述べています。 組織がまだ苦労している大きな問題の一つは、主要な聴衆を理解することです。APIのターゲットオーディエンスが、APIと統合するために何でもするような技術に精通した開発者だけだった時代は終わりました。APIのオーディエンスは、APIを介して配布されるサービスを使用して特定の問題を解決したいプロダクトマネージャー、テクニカルライター、マーケターに拡大しました。APIの価値と、それがターゲットオーディエンスの課題を解決するのにどのように役立つかというサービスが明確でない場合、その採用に悪影響を及ぼします。APIがビジネスの原動力となった今、APIのターゲットオーディエンスはより大きなセグメントのペルソナを包含しており、APIのストーリーを伝える際にこれらのペルソナに共感することが成功の重要な要素です。 APIインフルエンサーは、APIサービスの価値をビジネスの観点から顧客向けのメッセージに効果的に翻訳するという考え方に議論を誘導しています。人々がビジネス価値を特定すれば、APIの採用とアップセルの問題はよりよく軽減できます。 「優れたマーケティングは、自社および業界内でのより良い擁護者であることから始めなければなりません。そして初めて、APIコミュニティの外で擁護することができます。私たちは、技術分野でAPIの利点を啓蒙し、促進する上で多大な仕事をしてきました。今こそ、このストーリーを世界中に伝える時です」とジェン氏は述べています。 ジェン氏は、APIコミュニティには、世界中に響くストーリーを語る独自のスターが必要だと考えています。キン・レーン（API Evangelist）、ロリンダ・ブランドン、アルノー・ローレ（API Handyman）のような人々は、APIプログラムへの投資の利点を非技術的な聴衆に積極的に推進してきましたが、ジェニファーはもっと必要だと感じています。彼女は、APIエコノミーの利点に関するマインドシェアを増やすために、APIだけでなく、コミュニティ内の私たちがお互いをより良くマーケティングする必要があると述べています。
APIドキュメントはあなたのストーリーの延長線上にある
APIドキュメントは、APIの利用を開始し、APIと正常に統合するために必要なすべてのリソースを消費者に提供することに焦点を当てた、API全体のメッセージの延長線上にあります。ジェン氏は、このメッセージがAPI提供のあらゆる側面に浸透する必要があり、ドキュメントがこのメッセージの不可欠な部分であると信じています。優れたドキュメントは、ターゲットオーディエンス全体に対応するものであり、APIエコノミーにおいてオーディエンスが開発者に限定されないため、ドキュメントの優先順位付けと最適化が重要です。 しかし、APIドキュメントは、API採用の最大のコンバージョンポイントであるにもかかわらず、APIライフサイクルの中で常に優先順位が低いステップでした。これは、ジェン氏が2017年のAPIドキュメントの現状に関するレポートを調査していたときに発見したことです。 関連：最適な開発者体験のためのドキュメント構築に関する無料ライブウェビナー 「数十人のAPIインフルエンサーにインタビューし、APIドキュメントに関する業界レポートを執筆した後に本当に興味深かったのは、ドキュメントにおける人間的な触れ合いの必要性でした。短期間、人々はAPIからSwaggerドキュメントを生成することに満足していましたが、すぐにそれだけでは不十分であることに気づきました。現在、マーケティングプロセスにおける真の人間的な問題に共感できる熟練したテクニカルライターに対する大きな需要があります。」 多くの実践者との対話から、ジェン氏はAPIドキュメントプロセスを開始する最良の方法は、APIの仕様を生成することであり、それが具体的で堅牢なドキュメントの基盤になると信じています。これは、SwaggerやAPI Blueprintなどの人気のあるフレームワークを使用することができます。レガシーベースのAPIの定義を生成する問題は常にありますが、この問題を克服するためのいくつかの優れたソリューションに関する無料リソースをチェックすることができます。この定義を生成することは、決して最終ステップではありません。ドキュメントには常に人間的な触れ合いが必要であり、API採用のあらゆる段階でユーザーを導く包括的な使用マニュアルに進化する必要があります。ドキュメントは製品として扱うことができ、ジェン氏は、顧客が解決しなければならない包括的なシナリオを解決するようにメッセージとAPIドキュメントを調整することが、ユーザー満足度に大きく貢献できることを繰り返します。 「人々はあなたのAPIをGoogleで検索し、APIの価値提案とドキュメントを読み、あなたのAPIを使い始められない場合、他の誰かのAPIに移行するでしょう。」 彼女は、一流のドキュメントを構築するためには、それがAPI開発プロセスの一部である必要があると考えています。ギャレス・ジョーンズ氏（Microsoft Graph APIの主任アーキテクト）は、以前の会話で、APIを使用する際に顧客が直面する可能性のある包括的なシナリオを最初に文書化することから開発プロセスを開始するというこの点を強調しました。このドキュメントまたは仕様を最優先するアプローチにより、組織はこれらのリソースを改善してAPIの使用を増やす方法について、さまざまなパイロット顧客と話し合うことができます。消費者があなたの提供するサービスとより速く統合するのに役立つ別の一流サービスとしてAPIドキュメントを扱うことは、戦略的な優先事項であるべきです。
業界の未来
ジェン氏は、APIが人工知能やIoTなどの多くの新技術を牽引すると信じています。その相互接続性により、APIは数多くの新しいイノベーションのバックボーンとなるでしょう。 「IoT、AI、機械学習、AR（拡張現実）など、すべての新しい輝かしい技術はAPIが基盤となっています。APIを中心に、常にさまざまなイノベーションが進化しています」と彼女は述べました。 APIエコノミーが到来し、新技術がかつてない速さで出現する中、効果的なストーリーテリングの必要性は増すばかりでしょう。 ジェン氏へのインタビューは、API専門家インタビューシリーズの一部です。API専門家と一緒に探求したいテーマがあれば、以下のコメント欄で、または@SwaggerHubまでツイートしてください。