此外,由于 API 可以直接或間接推動創收,提供 API 的部門可以從成本中心轉變為潛在的利潤中心。換句話說,API 成為一流的商業公民,而非企業對集成的常見看法中的“不可避免的罪惡”。簡而言之,API 本身成為產品,因此需要與其他業務產品相同水平的設計思維、持續關注和發展。

以 API 為主導的架構

API 被比作門,用以闡明其在提供對企業信息資產和業務能力的訪問中的作用。然而,門的類型、材料和尺寸各異,API 也可分為不同類型。

某些 API 在構建時專注于特定用例和應用程序,因此可高度專業化,并根據其服務目的進行定制。這類 API 的用途單一,難以在其構建的上下文之外重用。

用于指代這些單一用途 API 的常用術語是體驗 API,因其主要支持人類直接交互的應用程序(如移動應用程序和 Web 應用程序)。然而,并非所有需要專用 API 的應用程序都需與人類交互。例如,在工業 2.0 中,API 可用于支持現代工業線,或在農業領域,API 通過無人機掃描大面積土地的土壤狀況,實現實時數據獲取和發送。

另一些 API 則專為重用而構建,這類 API 更加通用,不綁定于特定用例,因此適用于多種場景。下圖展示了多種應用程序如何使用通用 API 來滿足不同的用例需求。

了解不同類型的 API 是構建 API 主導解決方案的基礎,強大的架構必須深入理解相關業務領域及所需功能。在企業級 API 的背景下,API 主導架構應解決以下核心問題:

后續部分將介紹一種自頂向下的方法來闡述 API 主導架構,首先從概念上定義架構的核心構建塊及其目的,接著詳細描述實現這些目的所需的功能,最后說明這些功能如何作為一個模塊化平臺緊密結合在一起。

概念架構視圖

以 API 為主導的概念視圖定義了架構的主要構建塊及其目的和職責。如圖 3 所示,概念性 API 主導架構由四個主要構建塊和消費應用程序組成。水平塊代表核心運行時功能,這些功能是實現 API 的基礎;垂直塊則代表生命周期支持、管理、運營和分析的重要支撐能力。

消費應用程序指能夠調用和使用 API 的任何計算機程序。這些應用程序的類型多樣,從傳統的商業現成應用程序(如商務系統)到網絡應用程序、移動應用程序、可穿戴設備,甚至更復雜的設備,如無人機和智能汽車。

API Exposure 構建塊負責安全可靠地公開對 API 端點的訪問。

服務是提供明確定義和有限功能的軟件單元,這些功能被稱為業務能力,因其對業務的重要性而得名。服務的功能可映射到業務流程,需實現業務邏輯、數據轉換、驗證、業務規則和編排等。服務通過 API 端點公開其功能,這些端點并不直接訪問,而是通過 API 公開層進行中介。

管理和運營塊包含支持 API 端到端生命周期管理的功能,包括 API 設計和模擬、策略實施、部署、升級、運行時操作,以及分析、棄用和更新。以開發人員為中心的功能(如 API 頁面、開發人員門戶和應用程序密鑰管理)也是該構建塊的一部分。這些構建塊在 API 貨幣化時起到輔助作用,負責收集根據使用情況計費所需的重要指標。

最后,身份和訪問塊支持用戶、角色和訪問管理功能。從生命周期和運營的角度,該塊使不同用戶(如 API 產品所有者、管理員、設計者和開發人員)能夠無縫登錄到 API 管理控制臺和/或開發人員門戶,并根據角色限制對不同區域的訪問。此塊還通過生成和執行令牌(如 OAuth 2.0、OpenID 和 SAML)來支持身份驗證和授權策略。

概括

本文全面概述了 API 主導的架構,明確指出不存在單一的 API,而是至少有兩種主要類型的 API:單一用途的 API 專注于在特定環境中提供定制功能,以支持特定且廣為人知的數字體驗;多用途的 API 則是一種更通用的功能,旨在解決多種用例(其中許多在構思 API 時可能尚未確定)。

文章接著將 API 比作門,通向信息和功能,并指出這些門(API)可以通過一組 API Exposure 功能進行訪問,確保對這些資產的快速、安全和可靠的訪問。

原文鏈接:What Is API-Led — An Architectural Approach

上一篇:

如何編寫代碼文檔:示例、類型、最佳實踐和工具

下一篇:

API優先的開發方法
#你可能也喜歡這些API文章!

我們有何不同?

API服務商零注冊

多API并行試用

數據驅動選型,提升決策效率

查看全部API→
??

熱門場景實測,選對API

#AI文本生成大模型API

對比大模型API的內容創意新穎性、情感共鳴力、商業轉化潛力

25個渠道
一鍵對比試用API 限時免費

#AI深度推理大模型API

對比大模型API的邏輯推理準確性、分析深度、可視化建議合理性

10個渠道
一鍵對比試用API 限時免費