以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为先的方法允许快速原型设计和迭代，这意味着我们更快地了解什么有效，什么无效。就像爱迪生在创造灯泡之前的1000次失败一样，以API为先意味着我们快速失败，并在更好地理解如何实现成功的基础上向前推进。以API为先通过确保API可靠、一致且易于开发人员使用来提高我们的长期成功。

为什么反向工作是有效的？ 

在2015年，我有机会重新设计一家知名消费品牌的电子商务网站。我评估了与现有系统相关的各种关键绩效指标（KPI），并且在 clear 的地方可以进行最大的改进：

• 桌面转化 rate 不达标。
• 移动转化 rate 极其糟糕。
• 移动流量的百分比迅速增加，并将在接下来的12个月内超过总流量的50%。由于移动转化 rate 极其糟糕，绝大多数移动流量并不理想。

根据数据，什么能为用户创造最大价值？显而易见：修复网站的移动用户体验问题。因此，我采取了移动优先的方法来重新设计网站。这意味着所有的设计、架构、API等首先考虑移动体验。这与当时传统的方法相反，后者首先关注桌面体验，往往将移动体验作为一个笨拙的附加考虑，导致转化率低下。移动优先的方法还需要更多的前期努力——这并不是一条轻松的道路。需要新的架构，需要编写新的API，并且每个断点都需要多个设计。

移动优先的方法导致了移动转化 rate 的显著提高。新的架构也在桌面转化 rate 上取得了令人印象深刻的提升。这种方法之所以成功，是因为它识别了如何创造最大用户价值，并将整个方法的重点放在提供该价值上。它从一开始就创造了正确的心态。同样——尽管这可能感觉像是反向工作——以API为先的方法创造了识别整体问题的机会，然后建立一个基础来纠正这些问题。

工程责任是什么？ 

API优先的思维方式已经并将继续引领Zonos走向成功，而工程在其中扮演着不可或缺的角色。我们有责任始终保持API优先的思维方式。这意味着我们不断提出问题，保持对我们API的关注，例如：“我们的API如何满足客户需求”。这也意味着我们总是用链接到我们的API文档来回应关于功能和特性的提问。如果文档不存在，那么我们就会创建它——在跨职能团队中共同合作，以确保Zonos拥有出色的API文档。