API格局在不斷發(fā)展，一些協(xié)議越來(lái)越受歡迎，而另一些則逐漸衰落。Postman 最新的 API 現(xiàn)狀報(bào)告(https://www.postman.com/state-of-api/api-global-growth/) 基于對(duì) 40,000 多名開(kāi)發(fā)人員的調(diào)查，提供了這些轉(zhuǎn)變的快照，并揭示了哪些 API 協(xié)議目前最受關(guān)注和采用。在本文中，我們將詳細(xì)探討這些 API 協(xié)議，分析它們?yōu)楹我鹑绱舜蟮呐d趣，并深入探討每個(gè)協(xié)議的主要優(yōu)勢(shì)和局限性。

Restful

代表態(tài)轉(zhuǎn)移（REST）仍然是Web API最受歡迎的建筑風(fēng)格。盡管其在調(diào)查受訪者中的使用率略有下降——在過(guò)去兩年中從92%降至86%——但其簡(jiǎn)單性、可擴(kuò)展性和與Web服務(wù)的易集成性鞏固了其在頂部的地位。 具象狀態(tài)傳輸 （REST） 仍然是 Web API 最流行的架構(gòu)風(fēng)格。盡管它在受訪者中的使用率略有下降（在過(guò)去兩年中從 92% 下降到 86%），但它的簡(jiǎn)單性、可擴(kuò)展性以及與 Web 服務(wù)的易集成鞏固了它的領(lǐng)先地位。

REST的好處REST 的優(yōu)勢(shì)

• 簡(jiǎn)單和標(biāo)準(zhǔn)化：通過(guò)利用標(biāo)準(zhǔn)HTTP方法，REST能夠?yàn)橐呀?jīng)精通HTTP的開(kāi)發(fā)人員提供直接采用。這種簡(jiǎn)單性促進(jìn)了快速學(xué)習(xí)和整合。 簡(jiǎn)單性和標(biāo)準(zhǔn)化：通過(guò)利用標(biāo)準(zhǔn)的HTTP方法，REST使已經(jīng)精通HTTP的開(kāi)發(fā)人員能夠直接采用。這種簡(jiǎn)單性促進(jìn)了快速學(xué)習(xí)和集成。
• 可擴(kuò)展性：REST的無(wú)狀態(tài)性質(zhì)確保服務(wù)器不需要在請(qǐng)求之間存儲(chǔ)會(huì)話(huà)數(shù)據(jù)。這通過(guò)添加沒(méi)有共享服務(wù)器狀態(tài)的實(shí)例來(lái)促進(jìn)水平擴(kuò)展。 可擴(kuò)展性：REST的無(wú)狀態(tài)特性確保服務(wù)器不需要在請(qǐng)求之間存儲(chǔ)會(huì)話(huà)數(shù)據(jù)。這通過(guò)添加沒(méi)有共享服務(wù)器狀態(tài)的實(shí)例來(lái)促進(jìn)水平擴(kuò)展。
• 性能：無(wú)狀態(tài)和可緩存響應(yīng)產(chǎn)生更快的執(zhí)行和更少的請(qǐng)求。 性能：無(wú)狀態(tài)和可緩存響應(yīng)可加快執(zhí)行速度并減少請(qǐng)求數(shù)。
• 模塊化：RESTful服務(wù)可以作為模塊化組件開(kāi)發(fā)。這種本地化功能可以實(shí)現(xiàn)獨(dú)立更新并提高可維護(hù)性。 模塊化：RESTful服務(wù)可以作為模塊化組件進(jìn)行開(kāi)發(fā)。這種本地化功能可實(shí)現(xiàn)獨(dú)立更新并提高可維護(hù)性。
• 平臺(tái)無(wú)關(guān)：平臺(tái)無(wú)關(guān)的HTTP支持允許不同客戶(hù)使用。由此產(chǎn)生的互操作性促進(jìn)了跨系統(tǒng)的API集成。 與平臺(tái)無(wú)關(guān)：與平臺(tái)無(wú)關(guān)的 HTTP 支持允許不同的客戶(hù)端使用。由此產(chǎn)生的互操作性促進(jìn)了跨系統(tǒng)的 API 集成。
• 成熟的工具和社區(qū)支持：REST的長(zhǎng)壽導(dǎo)致了工具、庫(kù)、最佳實(shí)踐、故障排除指導(dǎo)和社區(qū)資源的廣泛擴(kuò)散。 成熟的工具和社區(qū)支持：REST 的長(zhǎng)期存在導(dǎo)致了工具、庫(kù)、最佳實(shí)踐、故障排除指南和社區(qū)資源的廣泛擴(kuò)散。

REST的挑戰(zhàn)REST的挑戰(zhàn)

• 過(guò)度獲取和不足：REST存在過(guò)度獲取或不足數(shù)據(jù)的風(fēng)險(xiǎn)，因?yàn)榭蛻?hù)端可能只需要一部分資源。這種缺點(diǎn)可能會(huì)導(dǎo)致性能問(wèn)題和浪費(fèi)帶寬。 過(guò)度獲取和獲取不足：REST 存在過(guò)度獲取或未獲取數(shù)據(jù)的風(fēng)險(xiǎn)，因?yàn)榭蛻?hù)端可能只需要一部分資源。此缺點(diǎn)可能會(huì)導(dǎo)致性能問(wèn)題并浪費(fèi)帶寬。
• 聊天界面：檢索相關(guān)數(shù)據(jù)可能需要多個(gè)請(qǐng)求，這會(huì)增加延遲。隨著應(yīng)用程序的擴(kuò)展，這種呼叫瀑布變得特別有問(wèn)題。 聊天界面：檢索相關(guān)數(shù)據(jù)可能需要多個(gè)請(qǐng)求，這會(huì)增加延遲。隨著應(yīng)用程序規(guī)模的擴(kuò)展，這種調(diào)用瀑布式變得尤其成問(wèn)題。
• 版本挑戰(zhàn)：創(chuàng)建新版本的REST API可能很麻煩，特別是當(dāng)數(shù)據(jù)結(jié)構(gòu)或服務(wù)功能發(fā)生變化時(shí)。這通常會(huì)導(dǎo)致向后兼容性問(wèn)題。 版本控制挑戰(zhàn)：創(chuàng)建 REST API 的新版本可能很麻煩，尤其是在數(shù)據(jù)結(jié)構(gòu)或服務(wù)功能發(fā)生更改時(shí)。這通常會(huì)導(dǎo)致向后兼容性問(wèn)題。
• 無(wú)狀態(tài)開(kāi)銷(xiāo)：雖然無(wú)狀態(tài)支持可擴(kuò)展性，但也意味著每個(gè)請(qǐng)求都必須提供所有必要的上下文。這一要求可能會(huì)帶來(lái)開(kāi)銷(xiāo)，特別是當(dāng)客戶(hù)必須發(fā)送大量重復(fù)數(shù)據(jù)時(shí)。 無(wú)狀態(tài)開(kāi)銷(xiāo)：雖然無(wú)狀態(tài)支持可伸縮性，但這也意味著必須為每個(gè)請(qǐng)求提供所有必要的上下文。此要求可能會(huì)帶來(lái)開(kāi)銷(xiāo)，尤其是當(dāng)客戶(hù)端必須發(fā)送大量重復(fù)數(shù)據(jù)時(shí)。
• 缺乏實(shí)時(shí)功能：REST沒(méi)有針對(duì)聊天或?qū)崟r(shí)提要等實(shí)時(shí)應(yīng)用程序進(jìn)行優(yōu)化。WebSockets和服務(wù)器發(fā)送的事件通常更適合此類(lèi)用例。 缺乏實(shí)時(shí)功能：REST 未針對(duì)實(shí)時(shí)應(yīng)用（如聊天或?qū)崟r(shí)提要）進(jìn)行優(yōu)化。WebSocket 和服務(wù)器發(fā)送的事件通常更適合此類(lèi)用例。

WebhooksWebhook

Webhook是由源應(yīng)用程序中的事件觸發(fā)的用戶(hù)定義的HTTP回調(diào)。當(dāng)事件發(fā)生時(shí)，源應(yīng)用程序向目標(biāo)應(yīng)用程序指定的URI發(fā)送HTTP請(qǐng)求（通常是POST），這可以在不重復(fù)輪詢(xún)的情況下實(shí)現(xiàn)近實(shí)時(shí)的基于事件的通信。Webhook越來(lái)越受歡迎，36%的開(kāi)發(fā)人員使用它們?cè)诓煌到y(tǒng)之間創(chuàng)建無(wú)縫集成。 Webhook 是用戶(hù)定義的 HTTP 回調(diào)，由源應(yīng)用程序中的事件觸發(fā)。當(dāng)事件發(fā)生時(shí)，源應(yīng)用程序會(huì)向目標(biāo)應(yīng)用程序指定的 URI 發(fā)送 HTTP 請(qǐng)求（通常為 POST），從而實(shí)現(xiàn)近乎實(shí)時(shí)的基于事件的通信，而無(wú)需重復(fù)輪詢(xún)。Webhook 正變得越來(lái)越流行，36% 的開(kāi)發(fā)人員使用它們?cè)诓煌到y(tǒng)之間創(chuàng)建無(wú)縫集成。

例如，如果您想在博客文章上有新評(píng)論時(shí)收到通知，而不是反復(fù)詢(xún)問(wèn)（投票）服務(wù)器“有新評(píng)論嗎？”，服務(wù)器會(huì)在發(fā)布新評(píng)論時(shí)（通過(guò)網(wǎng)絡(luò)鉤子）通知您。 例如，如果你想在每次博客文章上有新評(píng)論時(shí)都收到通知，而不是反復(fù)詢(xún)問(wèn)（輪詢(xún)）服務(wù)器，“有沒(méi)有新評(píng)論？”，服務(wù)器會(huì)在發(fā)布新評(píng)論時(shí)通知你（通過(guò) webhook）。

網(wǎng)絡(luò)鉤子的好處Webhook 的優(yōu)勢(shì)

• 實(shí)時(shí)通信：Webhook可實(shí)現(xiàn)實(shí)時(shí)數(shù)據(jù)傳輸。事件觸發(fā)時(shí)會(huì)發(fā)送相應(yīng)的數(shù)據(jù)，確保系統(tǒng)之間的最新同步。 實(shí)時(shí)通信：Webhook 支持實(shí)時(shí)數(shù)據(jù)傳輸。當(dāng)事件被觸發(fā)時(shí)，會(huì)發(fā)送相應(yīng)的數(shù)據(jù)，確保系統(tǒng)之間的最新同步。
• 效率：Webhook消除了資源密集型輪詢(xún)，節(jié)省了計(jì)算能力和帶寬。 效率：Webhook 消除了資源密集型輪詢(xún)，節(jié)省了算力和帶寬。
• 靈活性：Webhooks可以配置為響應(yīng)特定事件，允許您自定義一個(gè)應(yīng)用程序中的哪些操作或觸發(fā)器將向另一個(gè)應(yīng)用程序發(fā)送數(shù)據(jù)。 靈活性：Webhook 可以配置為響應(yīng)特定事件，允許您自定義一個(gè)應(yīng)用程序中的哪些操作或觸發(fā)器將數(shù)據(jù)發(fā)送到另一個(gè)應(yīng)用程序。
• 簡(jiǎn)化集成：HTTP方法使大多數(shù)應(yīng)用程序易于使用。 簡(jiǎn)化的集成：HTTP 方法使大多數(shù)應(yīng)用程序能夠輕松使用。
• 支持解耦架構(gòu)：由于網(wǎng)絡(luò)鉤子基于事件運(yùn)行，它們自然支持事件驅(qū)動(dòng)或解耦架構(gòu)，增強(qiáng)了模塊化和可擴(kuò)展性。 支持解耦架構(gòu)：由于 Webhook 基于事件運(yùn)行，因此它們自然支持事件驅(qū)動(dòng)或解耦架構(gòu)，從而增強(qiáng)了模塊化和可擴(kuò)展性。

網(wǎng)絡(luò)鉤子的挑戰(zhàn)Webhook 的挑戰(zhàn)

• 錯(cuò)誤處理：如果網(wǎng)絡(luò)鉤子接收端停機(jī)或處理回調(diào)時(shí)出現(xiàn)錯(cuò)誤，則存在數(shù)據(jù)丟失的風(fēng)險(xiǎn)。使用網(wǎng)絡(luò)鉤子的系統(tǒng)必須具有強(qiáng)大的錯(cuò)誤處理機(jī)制，包括重試或日志。 錯(cuò)誤處理：如果 Webhook 的接收端關(guān)閉或在處理回調(diào)時(shí)出現(xiàn)錯(cuò)誤，則存在數(shù)據(jù)丟失的風(fēng)險(xiǎn)。使用 Webhook 的系統(tǒng)必須具有可靠的錯(cuò)誤處理機(jī)制，包括重試或日志。
• 安全問(wèn)題：網(wǎng)絡(luò)鉤子通過(guò)互聯(lián)網(wǎng)傳輸數(shù)據(jù)，使它們?nèi)菀资艿綌r截或惡意攻擊。API安全措施，如使用HTTPS和有效負(fù)載簽名，是必不可少的。 安全問(wèn)題：Webhook 通過(guò) Internet 傳輸數(shù)據(jù)，使其容易受到攔截或惡意攻擊。API 安全措施（例如使用 HTTPS 和有效負(fù)載簽名）至關(guān)重要。
• 管理多個(gè)網(wǎng)絡(luò)鉤子：管理和監(jiān)控網(wǎng)絡(luò)鉤子可能很復(fù)雜，特別是隨著應(yīng)用程序的發(fā)展并開(kāi)始依賴(lài)多個(gè)網(wǎng)絡(luò)鉤子。確保所有網(wǎng)絡(luò)鉤子正常運(yùn)行并跟蹤各種端點(diǎn)需要勤奮。 管理多個(gè) Webhook：管理和監(jiān)視 Webhook 可能很復(fù)雜，尤其是當(dāng)應(yīng)用程序增長(zhǎng)并開(kāi)始依賴(lài)多個(gè) Webhook 時(shí)。確保所有 Webhook 正常運(yùn)行并跟蹤各種端點(diǎn)需要勤奮。
• 潛在的過(guò)載：大量并發(fā)回調(diào)可能會(huì)使接收應(yīng)用程序不堪重負(fù)，但速率限制或批處理可能有助于管理激增。 潛在的過(guò)載：大量并發(fā)回調(diào)可能會(huì)使接收應(yīng)用程序不堪重負(fù)，但速率限制或批處理可能有助于管理激增。

GraphQL

GraphQL是一種API的查詢(xún)語(yǔ)言，也是使用您為數(shù)據(jù)定義的類(lèi)型系統(tǒng)執(zhí)行查詢(xún)的服務(wù)器端運(yùn)行時(shí)。GraphQL由Facebook于2012年開(kāi)發(fā)，并于2015年作為開(kāi)源項(xiàng)目發(fā)布，為傳統(tǒng)的REST API提供了一個(gè)更靈活、更高效的替代品。GraphQL在開(kāi)發(fā)人員中的采用率增長(zhǎng)了29%，這表明其在當(dāng)今API環(huán)境中的重要性。 GraphQL 是一種用于 API 的查詢(xún)語(yǔ)言，也是一種服務(wù)器端運(yùn)行時(shí)，用于使用您為數(shù)據(jù)定義的類(lèi)型系統(tǒng)執(zhí)行查詢(xún)。GraphQL 由 Facebook 于 2012 年開(kāi)發(fā)，并于 2015 年作為開(kāi)源項(xiàng)目發(fā)布，為傳統(tǒng)的 REST API 提供了更靈活、更高效的替代方案。GraphQL 在開(kāi)發(fā)人員中的采用率高達(dá) 29%，這表明它在當(dāng)今 API 環(huán)境中的重要性。

與REST不同，您必須點(diǎn)擊多個(gè)API端點(diǎn)才能獲取相關(guān)數(shù)據(jù)，GraphQL允許您在單個(gè)查詢(xún)中獲得所需的所有數(shù)據(jù)。這對(duì)前端開(kāi)發(fā)人員特別有用，因?yàn)樗顾麄兡軌蚋玫乜刂茢?shù)據(jù)檢索過(guò)程，并允許他們創(chuàng)建更動(dòng)態(tài)和響應(yīng)靈敏的用戶(hù)界面。 與 REST 不同，在 REST 中，您必須點(diǎn)擊多個(gè) API 端點(diǎn)才能獲取相關(guān)數(shù)據(jù)，而 GraphQL 允許您在單個(gè)查詢(xún)中獲取所需的所有數(shù)據(jù)。這對(duì)前端開(kāi)發(fā)人員特別有用，因?yàn)樗顾麄兡軌蚋玫乜刂茢?shù)據(jù)檢索過(guò)程，并允許他們創(chuàng)建更動(dòng)態(tài)和響應(yīng)更靈敏的用戶(hù)界面。

GraphQL的好處GraphQL 的優(yōu)勢(shì)

• 強(qiáng)類(lèi)型模式：GraphQL API具有強(qiáng)類(lèi)型模式，允許開(kāi)發(fā)人員確切知道哪些數(shù)據(jù)和類(lèi)型可供查詢(xún)。 強(qiáng)類(lèi)型架構(gòu)：GraphQL API 具有強(qiáng)類(lèi)型架構(gòu)，使開(kāi)發(fā)人員能夠確切地知道哪些數(shù)據(jù)和類(lèi)型可供查詢(xún)。
• 精確的數(shù)據(jù)檢索：客戶(hù)可以請(qǐng)求他們需要的精確數(shù)據(jù)，這解決了過(guò)度獲取和獲取不足的問(wèn)題，進(jìn)而提高性能并降低成本。 精準(zhǔn)數(shù)據(jù)檢索：客戶(hù)可以請(qǐng)求所需的精準(zhǔn)數(shù)據(jù)，解決了超取和欠取的問(wèn)題，進(jìn)而提高了性能，降低了成本。
• 查詢(xún)復(fù)雜性和多個(gè)資源：GraphQL支持在一個(gè)請(qǐng)求中查詢(xún)多種數(shù)據(jù)類(lèi)型，這減少了復(fù)雜、相互關(guān)聯(lián)的數(shù)據(jù)的網(wǎng)絡(luò)請(qǐng)求數(shù)量。 查詢(xún)復(fù)雜度和多種資源：GraphQL 支持在一次請(qǐng)求中查詢(xún)多種數(shù)據(jù)類(lèi)型，從而減少了對(duì)復(fù)雜、相互關(guān)聯(lián)的數(shù)據(jù)的網(wǎng)絡(luò)請(qǐng)求數(shù)量。
• 訂閱實(shí)時(shí)更新：GraphQL通過(guò)訂閱實(shí)現(xiàn)實(shí)時(shí)同步，使客戶(hù)端實(shí)時(shí)更新。 訂閱實(shí)時(shí)更新：GraphQL 支持通過(guò)訂閱進(jìn)行實(shí)時(shí)同步，從而使客戶(hù)端實(shí)時(shí)更新。
• 內(nèi)?。?/strong>GraphQL的自我記錄模式使通過(guò)內(nèi)省更容易開(kāi)發(fā)。 內(nèi)省：GraphQL 的自文檔模式通過(guò)內(nèi)省實(shí)現(xiàn)更輕松的開(kāi)發(fā)。