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 文檔。