研究和规划是任何 API 项目成功的关键步骤。分析设计、开发和部署 API 的各种复杂性，以及与营销和货币化相关的业务实践，有助于降低风险并增加成功的可能性。
Nordic APIs 是关于 API 的领先信息和资源来源之一，从其开发背后的技术到围绕 API 消费的业务。Nordic APIs 拥有全球数千名 API 从业者受众，已成为 API 领域最知名的资源之一。
我很荣幸与 Nordic APIs 主编Bill Doerrfeld 就与 API 项目成功相关的各种话题进行了交流。我们讨论了 API 营销的挑战、API 描述格式在提高 API 可发现性方面的作用、技术营销人员的兴起等等。
您可以在下面阅读我们的完整对话。
OpenAPI 等 API 定义格式在 API 领域的重要性持续增长。我们知道它们如何帮助 API 开发，但您认为 API 定义格式如何帮助 API 营销？
API 描述格式的重要性日益突出，并对整个API 生命周期产生重大影响。它们正在变得更加成熟，并成为许多使用 API 的公司的常识。定义格式也使“设计优先”思维在行业中成为现实，这有助于改善 API 开发和消费体验。围绕描述格式创建辅助工具也有助于其普及。
描述格式有助于使 API 更易于访问，从而更可用、更易于营销。 格式通过文档生成、客户端库和开发工具包等配套工具打开了一个充满可能性的世界，所有这些都有助于 API 的推广和采用。很高兴看到作为一个行业，我们已经将OpenAPI 规范标准化，这使我们所有人都能在 REST API 世界中拥有共同的交流语言。
定义还使 API 可以在目录中移植，从而创建了所有 API 的一站式中心。
当我们谈论 API 营销时，我们经常听到 API 目录。目录的效果如何？开发者真的会使用它们，还是会坚持老式的方式，直接在 Google 上搜索？
目录的重要性正在日益增加。ProgrammableWeb 等网站以获得大量关注而闻名，这使其成为发现 API 的重要途径。我听过一些开发者托管公共 API 的故事，他们将其添加到目录中，并产生了潜在客户。目录实际上是一种潜在客户生成机制，并且已知可以作为增加网络足迹的额外渠道。 一个很好的例子是 APIs.guru，它正在获得关注，并迅速成为 API 的维基百科。
虽然目录对人类很有用，但它们不是机器可读的。这意味着一个广泛的人类友好目录在移植到各种搜索引擎时仍然存在问题。这可能是与 Web API 关联元数据的最大优势，因为它们确实允许搜索算法对其进行爬网。
API 仍然通过人工策展添加到目录中，我希望将来有更多的 API 也能通过各种爬网算法自动索引。
营销何时应成为 API 生命周期中的一个因素？它应该在规划阶段出现吗？还是开发阶段？
答案将取决于组织希望如何处理其 API，以及他们作为一家公司有多开放。如果您是一个大型组织，您可能有内部资源在任何内容公开之前进行大量测试。这些测试的结果将为营销人员提供一些好的见解，以及时间，以确定在 API 公开之前正确的消息传递、渠道策略和采用模型。
对于初创公司，可能没有太多资源进行广泛的 Beta 测试。在这种情况下，明智的做法是让营销人员在 API 规划阶段早期参与对话，以便他们有时间确定最佳营销技术以实现采用目标。
您认为 API 营销面临哪些挑战？
向开发者营销是一件棘手的事情，因为他们往往非常挑剔。他们需要以最快、最简单的方式理解价值。通常，这种简单性会体现在信息传递、登陆页面的用户界面，甚至他们阅读和解释API 文档的方式上。
API 营销在另一方面也很困难，因为涉及到收入周期。您的组织需要一段时间才能从 API 直接找到一些有形、可衡量的影响。这种价值可能以直接收入、品牌知名度或重复业务的形式出现。API 与普通产品之间的一个巨大区别是价值创造的时间线更长。
重要的是要了解 API 是高级集成，并且可以触及公司架构中的许多重要组件。像 CPO、CTO 和 CFO 这样的高级管理人员需要了解 API 可以带来什么价值。虽然这可能看起来空间变得有点企业化，但作为营销人员，我们绝不应该忘记我们真正目标用户——开发者的需求。这就是为什么文档在营销人员的工具库中如此重要，以获取新的 API 消费者。
您会推荐哪些工具来创建好的 API 文档？
我最近写了一篇关于 30 种不同文档工具的综述文章。我喜欢 SmartBear 的Swagger UI；它在该领域非常成熟，许多公司都在使用。我也喜欢 ReDoc，如果您喜欢三栏式文档布局，也可以选择 Slate。
市面上有一些很棒的开发者门户，它们能缩短开发者消费 API 所需的上手时间。
您认为 API 和描述格式等技术的普及是否让营销人员变得更技术化？
不仅仅是营销，每个人都是如此。这是所有行业和职业的趋势。每个人都需要变得更技术化，才能保持相关性，包括营销人员、作家和企业家。有许多不同的人参与并对突破性、颠覆性技术感兴趣，这同样适用于 API。虽然他们的头脑不完全在代码中，但他们仍然必须学习如何将它们应用到他们的日常活动中。
也许未来公司会招聘一个专门的“API 营销人员”职位？
我认为这已经存在了，尽管他们称之为开发者倡导者。不幸的是，在开发者世界中，“营销”这个词听起来不太好（笑）。
我们对 Bill Doerrfeld 的采访是 Swagger 博客专家采访系列的一部分。查看另一篇与 OpenAPI Initiative 的 Darrel Miller 的热门采访。