API 優先策略如何塑造 Zonos 的未來

什麼是 API 優先策略？ 

API 優先策略與程式碼優先策略形成鮮明對比，後者是團隊先從設計應用程式的功能開始，編寫程式碼，然後在流程結束時添加 API。

在 Zonos，使用 API 優先策略構建軟體意味著圍繞 API 設計解決方案，而不是編寫應用程式然後稍後添加 API。這意味著我們的 API 是最重要的且本身就是產品；我們以對客戶需求的深切關注來設計它們，並在編寫任何程式碼之前明確地記錄和構建它們。

API 優先策略的好處 

API 優先策略有助於建立以下心態：

• 我們理解我們的 API 是客戶的主要介面，因此將其視為我們的公開可交付成果。
• 在編寫程式碼之前進行文檔編製，使我們有機會推理、討論、完善並與團隊和利益相關者溝通我們的目標，以創建更好的最終產品。
• 當我們關注客戶的需求時，我們理解如何最好地設計滿足這些需求的 API。

這種心態將我們的 API 和客戶放在首位，對於建立 Zonos 中每個人都對客戶成功負責的基礎至關重要。

開發團隊可以並行工作

API 優先策略涉及建立協議。在組織內建立由團隊遵循的服務間協議允許那些團隊同時處理多個 API。開發人員不必等待 API 更新發布後才能進行下一個 API。團隊可以根據預先建立的 API 定義同時模擬測試 API 和 API 依賴項。

降低開發成本

API 和程式碼可以在許多不同的專案中重複使用。在 API 優先策略下，如果開發團隊想要構建新應用程式，他們不需要從頭開始，從而節省時間和成本。API 優先設計還允許在編寫任何程式碼之前解決大多數問題，這有助於防止在整合 API 與應用程式時出現問題。

提高上市速度

使用工具匯入 API 定義檔案可以自動化構建 API 的大部分流程。我們從產生核心類型、定義和架構開始；使用這些檔案，可以自動產生 API 工具，例如 API 文檔、軟體開發工具包 (SDK) 和模擬 API。自動化大大加快了 API 和應用程式的開發速度。

API 優先還使得無需重新構建整個系統就可以向應用程式添加新服務和技術。Zonos 必須快速向生產環境推出功能，以在不斷變化的跨境 SaaS 市場中保持競爭力。在底層程式碼中消除技術債務比將客戶遷移離開設計不良的 API 要容易得多。

確保良好的開發者體驗

API 消費者通常是開發人員，開發者體驗 (DX) 可以決定 API 成功的成敗。API 優先策略確保開發者體驗是正面的，因為設計良好、文檔齊全、一致的 API 更容易學習和重複使用。這也會增加實現的速度。這些好處都是相互關聯的！

增加長期成功

API 優先策略允許快速原型製作和迭代，這意味著我們更快地了解什麼行得通，什麼不行。就像愛迪生在發明燈泡之前進行了 1,000 次失敗的嘗試一樣，API 優先意味著我們失敗得快，並帶著對如何實現成功的更好理解而前進。API 優先通過確保 API 可靠、一致且易於開發人員使用來增加我們的長期成功。

為什麼反向工作有效？ 

在 2015 年，我有機會重新設計一個受歡迎消費品牌的電子商務網站。我評估了與現有系統相關的各種關鍵績效指標 (KPI)，很明顯可以在哪裡進行最大改進：

• 桌面轉換率不達標。
• 行動轉換率糟糕透頂。
• 行動流量的百分比快速增長，將在未來 12 個月內超過總流量的 50%。由於行動轉換率糟糕，大部分行動流量是不理想的。

根據數據，什麼將為使用者創造最大價值？很明顯：修復網站行動使用者體驗的問題。因此，我採取了行動優先的方法來重新設計網站。這意味著所有設計、架構、API 等首先考慮行動體驗。這與當時的傳統方法相反，後者首先關注桌面體驗，通常將行動體驗作為一個笨拙的附加功能，轉換率較低。行動優先策略也需要更多的前期工作——這不是簡單的路。需要新的架構，需要編寫新的 API，每個斷點都需要多個設計。

行動優先策略導致行動轉換率大幅增加。新架構也在桌面轉換率上取得了令人印象深刻的成果。該方法之所以成功，是因為它確定了如何創造最大使用者價值，並將整個方法集中在提供該價值上。它從一開始就創造了正確的心態。同樣——儘管感覺像是反向工作——API 優先策略創造了機會來識別總體性問題，然後構建基礎來糾正這些問題。

工程責任是什麼？ 

API 優先的心態已經並將繼續引領 Zonos 走向成功，工程在其中發揮著不可或缺的作用。我們的責任是始終保持 API 優先的心態。這意味著我們不斷提出問題，將重點放在我們的 API 上，例如：「我們的 API 如何能夠滿足客戶的需求？」這也意味著我們總是以指向我們 API 文檔的連結來回應有關功能的問題。如果文檔不存在，那麼我們會創建它——與跨職能團隊合作，以確保 Zonos 擁有出色的 API 文檔。