第十一章:結論#

建構一個成功的 API 是一門藝術,涵蓋商業分析、技術架構、軟體開發、合作夥伴關係、內容撰寫、開發者關係、支援和行銷。建構一個好的、受歡迎的 API,需要一整個團隊的努力。

在本書中,我們回顧了:

  • 穩健 API 設計的最佳實踐與理論
  • 逐步的實務使用案例示範
  • 如何圍繞 API 建構和維護開發者生態系

關鍵啟示#

本書最重要的啟示之一是:對 API 本身的設計要深思熟慮,對開發者生態系要體貼周到。


好的 API 的特質#

一個好的 API 應該具備以下特質:

特質相關章節
解決實際的開發者需求或痛點第一章、第八章
具有一致性第七章
穩定可靠第六章
有完整的文件第九章
沒有破壞性變更第七章
有合理的速率限制第六章
遵循標準第二章
可靠且安全第三章
擁有優秀的社群與支援第十章
有範例程式碼第九章
容易理解和使用第四章
有好的 SDK,支援多種語言第六章
容易測試第九章

持續改進#

這些特質不會自然而然地出現,而且如果第一次就做錯了,修復起來通常既困難又昂貴

你應該:

  • 真實使用者驗證 API
  • 向開發者持續索取回饋
  • 變更、政策、速率限制和更新保持透明
  • 成為自己開發者社群的一員

展望未來#

當你為 API 找到產品與市場的契合點(product-market fit),並圍繞它培養出開發者生態系之後,你將見證奇蹟的發生——開發者會利用你的 API 進行創新、賦能令人驚嘆的新解決方案,並建構出你從未想像過的事物。

沒有什麼比建構出數百萬人每天使用、讓生活變得更好的東西更有成就感了。相信我們,我們做到了,你也可以。