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