前言
隨著社會和企業(yè)的數(shù)字化程度越來越高，互聯(lián)軟件的需求呈現(xiàn)出了爆炸式增長。反過來，應(yīng)用程序編程接口（Application Programming Interface，API）已成為現(xiàn)代組織的重要資源，因為它促進了軟件之間的相互連接。但事實證明，有效管理這些API 是一項新挑戰(zhàn)。為了獲取API 的最大價值，我們需要學(xué)習(xí)如何管理API 的設(shè)計、開發(fā)、部署、增長、質(zhì)量，以及安全，同時還需要應(yīng)對上下文、時間和規(guī)模等復(fù)雜因素。
本書的讀者對象
如果你剛開始構(gòu)建API 程序，而且想了解一下后面的工作，或者你已擁有API 但想學(xué)習(xí)一下如何更好地管理它們，則本書非常適合你。
在本書中，我們會嘗試構(gòu)建一個可應(yīng)用于多種上下文的API 管理框架。書中提供的指導(dǎo)不僅可以幫助你管理與世界各地的開發(fā)人員共享的一個API，而且還可以就如何在專門為內(nèi)部開發(fā)人員設(shè)計的微服務(wù)架構(gòu)中構(gòu)建一組復(fù)雜的API 提供建議，以及介于二者之間的一切。
本書的編寫盡可能保持技術(shù)中立。我們提供的建議和分析適用于任何基于API 的架構(gòu)，包括 HTTP CRUD、REST、GraphQL 以及事件驅(qū)動的交互風(fēng)格。
本書適合于任何希望改進API 相關(guān)決策的工作人員。
本書的主要內(nèi)容
本書包含了我們多年來在設(shè)計、開發(fā)和改進 API 方面積累的知識，既囊括了我們自己的知識，也借鑒了他人的經(jīng)驗。我們將所有這些經(jīng)驗提煉到了這本書中。我們確立了有效開發(fā)API 的兩個核心因素：采用產(chǎn)品視角與建立正確類型的團隊。我們還確立了管理該工作的三個基本因素：管治、產(chǎn)品成熟度與格局設(shè)計。
API 管理的這五個要素構(gòu)成了成功構(gòu)建API 管理程序的基礎(chǔ)。在本書中，我們會逐個介紹這些主題，并提供有關(guān)如何根據(jù)組織的大環(huán)境塑造這五個要素的指導(dǎo)。
大綱
本書所討論的管理問題的范圍會隨著章節(jié)的推進而逐步擴大。首先，我們介紹基于決策的管治和API 即產(chǎn)品的基本概念。其次，我們介紹構(gòu)建API 產(chǎn)品必須管理的所有工作。
在介紹完單個API 的管理之后，我們將深入API 隨著時間發(fā)生的變化，以及API 的成熟度帶給這些變更決策的影響。接下來是對執(zhí)行變更工作的團隊和人員的探索。最后，在本書的后半部分，我們將介紹規(guī)模的復(fù)雜性以及管理API 產(chǎn)品格局的挑戰(zhàn)。
下面是每章的內(nèi)容概要：
第1 章介紹API 管理域，并解釋為什么有效管理API 如此困難。
第2 章從基于決策的工作（API 管理的基本概念）的角度探索管治。
第3 章確立API 即產(chǎn)品的觀點，以及為什么該觀點是所有API 戰(zhàn)略的重要組成部分。
第4 章概述API 產(chǎn)品領(lǐng)域的十大基本支柱。這些支柱形成了一組必須加以管理的決策制訂的任務(wù)。
第5 章深入探討API 持續(xù)變更的意義，并介紹采用持續(xù)變更思維的必要性，幫助你了解不同類型的 API 變更（及其影響）。
第6 章介紹API 產(chǎn)品的生命周期框架，并幫助你在API 整個生命周期內(nèi)通過十大支柱管理API。
第7 章討論API 管理系統(tǒng)中人的因素，探索API 團隊在API 產(chǎn)品整個生命周期內(nèi)擔負的常見角色、責任，以及設(shè)計模式。
第8 章介紹API 管理中的規(guī)模問題。介紹八個“V”，即多樣性、術(shù)語、規(guī)模、速度、脆弱性、可見性、版本，以及波動性，這些是當多個API 同時發(fā)生變化時必須注意的問題。
第9 章概述持續(xù)格局設(shè)計方式，可用于持續(xù)、大規(guī)模地管理API 變更。
第10 章將格局視角映射回API 即產(chǎn)品的視角，并說明當周圍的格局發(fā)生變化時，API 工作的變化。
第11 章總結(jié)API 的管理工作，并提出相關(guān)建議，幫助大家為未來做好準備，踏上新征程。
本書不包含的內(nèi)容
API 管理的范圍非常廣，而且在環(huán)境、平臺和協(xié)議方面也存在著大量差異。由于創(chuàng)作的時間和空間有限，我們不可能介紹所有與API 工作相關(guān)的具體實施實踐。本書不是設(shè)計REST API 或選擇安全網(wǎng)關(guān)產(chǎn)品的指南。如果你正在尋找編寫API 代碼或設(shè)計HTTP API 的規(guī)范指南，那么這本書也不適合你。雖然書中討論了具體的實踐示例，但本書的重點不在于實施（有大量書籍、博客和視頻可滿足這方面的需求）。本書解決了一些鮮有人重視的問題，即如何在一個復(fù)雜的、不斷變化的組織系統(tǒng)中有效地管理API 的構(gòu)建工作。
排版約定
本書使用了下述排版約定。
斜體（Italic）
表示新術(shù)語、URL、電子郵件地址、文件名和擴展名。
等寬字體（Constant Width）
表示程序片段，以及正文中出現(xiàn)的變量、函數(shù)名、數(shù)據(jù)庫、數(shù)據(jù)類型、環(huán)境變量、語句和關(guān)鍵字等。
等寬斜體（constant width italic）
表示應(yīng)該由用戶輸入的值或根據(jù)上下文確定的值替換的文本。
O’Reilly 在線學(xué)習(xí)平臺（O’Reilly Online Learning）
近40 年來，O’Reilly Media 致力于提供技術(shù)和商業(yè)培訓(xùn)、知識和卓越見解，來幫助眾多公司取得成功。
我們擁有獨一無二的專家和革新者組成的龐大網(wǎng)絡(luò)，他們通過圖書、文章、會議和我們的在線學(xué)習(xí)平臺分享他們的知識和經(jīng)驗。O’Reilly 的在線學(xué)習(xí)平臺允許你按需訪問現(xiàn)場培訓(xùn)課程、深入的學(xué)習(xí)路徑、交互式編程環(huán)境，以及O’Reilly 和200 多家其他出版商提供的大量文本和視頻資源。有關(guān)的更多信息，請訪問http://oreilly.com。
意見和疑問
請把你對本書的意見和疑問發(fā)給出版社：
美國：
O’Reilly Media, Inc.
1005 Gravenstein Highway North
Sebastopol, CA 95472
中國：
北京市西城區(qū)西直門南大街2號成銘大廈C座807室（100035）
奧萊利技術(shù)咨詢（北京）有限公司
如果你對本書有一些評論或技術(shù)上的建議， 請發(fā)送電子郵件到bookquestions@oreilly.com。
有關(guān)其他圖書、講座、會議、新聞的信息，請訪問我們的網(wǎng)站：http://www.oreilly.com。
我們的Facebook：http://facebook.com/oreilly。
我們的Twitter：http://twitter.com/oreillymedia。
我們的YouTube：http://www.youtube.com/oreillymedia。
致謝
本書得以付梓，我們要感謝很多人給予的幫助。感謝在創(chuàng)作早期大綱和草稿以及編輯的過程中，給予過我們幫助和支持的所有人。首先，感謝我們采訪和咨詢過的所有人，以及參加過研討會的所有人。我們獲得了積極的反饋和的良好建議。其次，還要感謝CA 科技公司的同仁多年來支持我們，并幫助我們舉辦研討會和現(xiàn)場的采訪。特別感謝閱讀我們早期的草稿，并幫助我們完成了本書的所有人。感謝Matt McLarty、James Higginbotham，以及Chris Wood 在百忙之中抽出時間閱讀和審查我們的創(chuàng)作，并指出有待提升的地方。最后，我們非常感謝O’Reilly Media 的團隊。感謝Alicia Young、Justin Billing，以及O’Reilly 全體員工，感謝你們?yōu)閹椭�我們將最初的想法變成眼前的這本書所付出的一切努力。