研究和规划是任何 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 目录。目录有多有效？开发人员真的使用它们吗，还是他们坚持使用老式的方法，只是在谷歌上搜索东西？
目录越来越重要。像 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.