Stoplight 与 Postman：完美协作

设计并交付更好的API：两款顶级工具的强强联合

对于API工具需求，没有一种“一站式解决方案”。如果有的话，您肯定早已知晓。现实情况是，每个API项目都有不同的需求，这意味着每个API团队都必须找到适合任务的一套工具。幸运的是，精心挑选的工具箱通常比全生命周期解决方案更具成本效益，也更灵活且功能更强大。

Stoplight和Postman常常被视为互斥的API管理工具，但我们最近对客户进行的一项调查显示，许多公司都在结合使用这两种工具，以实现最佳的组合。这种方法是合理的——两款产品都相对轻量且成本低，并且尽管在某些功能上有所重叠，但它们各自在API产品生命周期的不同阶段提供了专业化的功能。Postman是一款业界标准的技术工具，广泛应用于开发和测试阶段以及基本的技术文档编写。Stoplight支持一些相同的功能，但它围绕“API即产品”的原则构建，提供顶级的设计和文档功能，为API消费者带来最佳体验。

我们最近采访了两位既使用Stoplight又使用Postman的客户，了解他们如何在API项目中结合这两种工具。Pete Walton是Sardine的首席销售工程师，Sardine是一家为金融行业客户提供统一API的反欺诈和合规引擎，这些客户以前必须从各种来源收集信息。我们还采访了Akshay Bhalotia，他是一位开发者体验顾问，最近任职于Phyllo，这是一款标准化的API，用于从创作者经济平台提取数据。尽管这两家公司截然不同，但我们发现他们在使用这些工具时有一些共同的模式。

第一阶段：通过Postman赋能技术团队

既使用Stoplight又使用Postman的客户通常采用相同的方法——Postman是内部工具，而Stoplight则让他们能够更有效地满足客户需求。

Postman是一款出色的API开发团队生产力工具——它为技术用户进行了优化，并能高效地满足他们的需求。Sardine的员工是技术熟练的人员，如数据分析师、开发人员和技术销售团队。因此，他们广泛使用Postman进行内部测试，并在初始集成阶段为新客户提供实际操作支持。根据Walton的说法，他们确实会将Postman Collections直接分享给特定用户，主要是那些负责构建自定义请求和集成的企业级客户。对于技术思维导向的用户，无论是内部还是外部，Postman都是一个高效且熟悉的工具。

Phyllo使用Postman的方式略有不同，但指导理念仍然相同。正如Bhalotia所说：“任何曾经与API打交道的开发者都听说过并使用过Postman。”对他来说，使用Postman作为Phyllo的分发渠道几乎是一个必要条件——许多开发者，无论是内部的还是外部的，都会希望能够使用它来探索和测试新的API产品。

第二阶段：通过Stoplight优先考虑消费者

并非所有客户都具备技术熟练度，因此您需要能满足他们需求的工具。Postman非常适合测试API，但在初始设计过程中，它没有专门的支持。而在与API消费者进行集成后的持续支持关系中呢？这些都是Stoplight擅长的领域——设计和文档。

通过设计优先工具构建更好的产品

Walton和Bhalotia都强调了客户需求如何驱动他们的工具和流程选择。Walton多次提到，为API消费者提供直观的用户体验对于吸引和留住用户至关重要。设计优先几乎是Stoplight的一个信条，选择用他们的工具开始您的API设计流程将有助于实现您期望的结果。正如Bhalotia指出的那样：“Stoplight拥有最好的OpenAPI兼容的基于UI的API架构构建器之一，使得在API设计上进行协作和讨论变得非常容易。”如果您重视良好的产品设计，那么使用与这些原则一致的工具是合乎逻辑的。

除了使用Stoplight Studio，这些公司还发现了Stoplight工具帮助他们满足设计需求的其他方式。Phyllo正在开始实施自动化风格指南，作为其对用户体验重视的一部分，帮助提供更一致的API产品，并进一步改善开发者体验。对于Sardine而言，在高度监管的金融科技行业中，严格的访问控制是必需的。他们发现Stoplight的团队功能在确保客户仅能访问他们需要的数据和文档方面非常有用。

提供有效的用户文档

在我们的讨论中，Pete Walton描述了某些客户在看到“过于技术化”的工具时会感到不知所措。即使是经验丰富的开发人员，有时也会觉得API文档过于复杂且难以理解。Sardine和Phyllo都在使用Stoplight提供更“友好”且更容易接近的文档。

Walton和Bhalotia都提到他们非常赞赏在Stoplight文档中包含可用代码示例的便利性。对于Sardine来说，特别重要的是，Stoplight文档可以独立于代码库进行托管。他们需要对代码和数据进行严格控制，但仍允许潜在用户在文档中探索真实的产品功能。Stoplight为他们提供了这种控制权，同时还提供了流畅、直观的用户界面。如前所述，Walton有时会为客户直接提供Postman的访问权限，但“百分之九十九的时间，Sardine的销售团队只是将客户添加到相关的Stoplight团队中”，以便他们获得所需的文档访问权限。

通过组合式商业模式高效构建

COVID-19大流行迫使各类组织迅速调整。许多商业和技术领导者发现了组合式商业模式的价值。简而言之，这意味着将产品的核心产品和功能分解为独立、可配置的部分，随着业务条件的变化，这些部分可以重新部署为新的形式。到了2023年，随着市场条件促使许多公司追求更精简、更高效的运营，这一目标仍然具有重要意义。

如果您认为组合式商业模式并不革命性，那可能是因为对于大多数开发团队来说，这并不是一个新想法。新的是人们越来越认识到这种模式不仅在技术工具上有价值，还可以作为任何行业中构建更好产品和服务的基础。将API视为完整的产品，并让客户需求直接反馈到API设计中，使公司能够更快、更高效地提供价值。

Stoplight和Postman提供了无缝集成的互补功能。每个工具本身都是组合式商业模式的例子，这意味着它们为用户提供了更大的价值。它们也是构建您自己的组合式API项目的坚实基础，因为它们使您的流程更加灵活高效，并让您更专注于用户需求。

精简工具

Stoplight和Postman都是“少即是多”工具包中的工具。为了最大化它们的价值，您需要投入时间来理解您的API开发流程，了解您的API产品在哪些方面需要特殊支持，并评估您的开发团队的知识和优势。您是否确切了解您的工具需求在哪里？当您了解后，您可以选择定制的解决方案，避免在与您的特定需求不匹配的工具上浪费资源。

一般而言，像Stoplight和Postman这样能够轻松与其他系统集成的工具，通常会比臃肿的“一站式”系统更好的选择。Walton强调说，总体价格和价值在选择Stoplight和Postman时是重要的考量因素，而不是选择捆绑功能的竞争对手。作为一个处于充满新挑战和复杂挑战的行业中的创业公司，Sardine优先考虑保持低成本，以便其能够专注于核心产品。组合式企业需要灵活、跨兼容的流程和工具，使他们能够在不削减利润的情况下进行创造和创新。

更敏捷的产品

组合式商业模式还涉及通过API项目所生产的内容，而灵活的工具对此也有帮助。随着您的开发流程变得更加精简，您将处于更好的位置，以快速调整以满足客户需求，这正是这种商业模式的标志。Bhalotia在谈到他选择正确工具的原则时提到了这一点：“对我来说，最重要的两件事是为客户提供的用户体验和我的工程团队的生产力，按此顺序排列。”Postman支持内部生产力，Stoplight为您的API消费者提供出色的用户体验。两者结合在一起，是实现这些目标的绝佳组合。

“更敏捷”意味着变得更加灵活，随时准备快速适应变化。您希望您的API项目准备好迎接挑战，以便在条件变化时，您仍然能够持续提供最佳用户体验。使用模块化、精简的工具，您可以将精力集中在理解和适应客户需求上，并确保您的工具不会妨碍流程和产品中的创新。

更快完成产品

正如Bhalotia所说，Postman是API开发者和消费者的重要工具。然而，并不是所有API都能成为成功的API产品，而这正是组合式商业所需要的。仅依赖一款工具可能不足以实现您的期望结果。Stoplight通过在产品生命周期中将技术资源与用户联系起来，填补了阻碍一个好API成为一个伟大产品的关键空白。

构建耐用而灵活的API产品需要经过深思熟虑的设计、精简的流程和精心选择的工具。这要求您将API视为不仅仅是技术资源，这意味着在设计和开发过程中要时刻考虑用户体验。

一个API产品的完成并不是所有端点都通过测试，或第一个客户成功创建集成时。完成的产品包括文档和支持，以及整合反馈和数据以优化设计并为下一次迭代做好准备的流程。Postman和Stoplight一起组成了一套高效且灵活的工具，支持您整个过程。

文章来源：Stoplight AND: Playing well with Postman