[論文レビュー] Source Data for the Focus Area Maturity Model for API Management

Max Mathijssen, Michiel Overeem+1 more|arXiv (Cornell University)|Jul 21, 2020

Software Engineering Research参考文献 3被引用数 5

ひとこと要約

本論文では、体系的文献レビュー、専門家インタビュー、事例研究を通じて開発された、6つのフォーカス・エリアにまたがる81の実践と20の能力を含む構造的フレームワークであるAPI管理フォーカス・エリア成熟度モデル（API-m-FAMM）を提示する。このモデルにより、組織はレベル1から10までのAPI管理成熟度を評価・向上・ベンチマーク化でき、実践は明確さと実装の容易さを考慮して標準化されている。

ABSTRACT

We define API Management as an activity that enables organizations to design, publish and deploy their APIs for (external) developers to consume. API Management capabilities such as controlling API lifecycles, access and authentication to APIs, monitoring, throttling and analyzing API usage, as well as providing security and documentation. These capabilities are often implemented through an integrated platform. This data set describes the API Management Focus Area Maturity Model (API-m-FAMM). In a structured manner, this model aims to support organizations that expose their API(s) to third-party developers in their API management activities. Through a thorough Systematic Literature Review (SLR), 114 practices and 39 capabilities were collected. Subsequently, these practices and capabilities were categorized into 6 focus areas. Next, the practices and capabilities were analyzed and verified through inter-rater agreement and four validation sessions with all involved researchers. Then, the collection of practices and capabilities was verified by using information gathered from supplemental literature, online blog posts, websites, commercial API management platform documentation and third-party tooling. As a result, the initial body of practices and capabilities was narrowed down to 87 practices and 23 capabilities. These practices are described by a practice code, name, description, conditions for implementation, the role responsible for the practice, and the associated literature in which the practice was originally identified. Capabilities and focus areas are described by a code, description and, optionally, the associated literature in which it was originally identified. Using the API-m-FAMM, organizations may evaluate, improve upon and assess the degree of maturity their business processes regarding the topic of API management have.

研究の動機と目的

• 組織がAPIの実践を改善できるように支援する包括的で、実証的根拠に基づいたAPI管理成熟度モデルを構築すること。
• 外部開発者向けAPI公開および管理に関連する、実行可能で実装可能な実践および能力を特定・検証すること。
• 標準化された、証拠に基づくフレームワークを通じて、実務家および研究者がAPI管理成熟度を評価・ベンチマーク化できるように支援すること。
• 専門家による検証、事例研究、構造的フィードバックループを用いた繰り返しの最適化を通じて、モデルの妥当性と実務的関連性を確保すること。

提案手法

• 学術的およびグレイ・リテラチャーからAPI管理における基礎的実践および能力を同定するため、体系的文献レビュー（SLR）を実施した。
• 実務的関連性と使いやすさに基づいて、初期の実践および能力のセットを検証・精錬する目的で、11件の半構造的専門家インタビューを実施した。
• 研究者および実務家による繰り返しのディスカッション会議を通じて、実践の分類、記述、成熟度レベルの割り当てについて合意に達した。
• Google Drawingsを用いたカード・ソーティング技術を適用し、フォーカス・エリアおよび成熟度レベルにまたがるモデルの構成要素を構造化・再編集した。
• 商用ソフトウェア製品における5件の事例研究を通じて、モデルの実世界への適用可能性を評価し、実装のギャップを同定した。
• 最終的なモデル（v1.0）は、曖昧な実践の削除、記述の明確化、一貫した文法的構造（例：動詞＋名詞形式）への用語の整合化を通じて精錬された。

実験結果

リサーチクエスチョン

• RQ1 外部開発者にAPIを公開する組織における、効果的なAPI管理を特徴づける主要な実践および能力は何か？
• RQ2 SLR、専門家インタビュー、事例研究を含む混合研究法を用いて、API管理成熟度モデルを体系的に開発・検証する方法は何か？
• RQ3 実務家専門家がAPI管理実践の関連性および成熟度レベルの割り当てについてどの程度合意に達するか？
• RQ4 実務上の実用性と現実世界の実装課題への整合性を確保するため、モデルをどのように繰り返し精錬できるか？

主な発見

• 最終的なAPI-m-FAMMは、6つのフォーカス・エリアに整理された81の検証済み実践と20の能力を含み、各実践は1から10までの成熟度レベルに割り当てられている。
• 専門家からのフィードバックを通じた精錬の結果、既存の実践（例：「トランスポート層暗号化の実装」）と重複するため、「機密データの露出を防止する」実践は削除された。
• 「リクエストレート制限を実施する」実践は、エラーレート制限を含めるよう強化され、本番環境で観察された実際の実装パターンを反映した。
• 「リソース使用状況を監視する」の記述は、非メトリック近似を含めるように拡張され、明確さと実務的適用性が向上した。
• 「予測的スケーリングを実装する」実践の記述は、手動実装を除外するよう更新され、業界の自動化期待に一致するようになった。
• 最終的なモデルは、6つのソフトウェア製品における事例研究を通じて検証され、実務的関連性が確認されるとともに、記述および範囲に関する実行可能な精錬が同定された。