上周，Twitter 为其流行的 API 项目推出了新的愿景，承诺为开发者提供更“统一”的 API 平台，以利用 Twitter 的公共 API 构建应用程序。 在公司博客上的一篇名为构建 Twitter API 平台的未来 的文章中，Twitter 预览了一些重大变化，包括 更统一的 API 平台：自从公司在 2014 年收购了社交数据提供商 Gnip 以来，Twitter 承认其开发者社区在某种程度上已经分裂。 虽然其大部分开发者群继续使用 Twitter 的标准 REST 和实时流式 API，但越来越多的公司付费访问 Gnip 的企业级 API。 Twitter 解释说：“今年晚些时候，我们将推出一种新的开发者体验，它将标准 REST 和流式 API 的免费和便捷访问与 Gnip 的企业级能力和可靠性相结合。我们的目标是创建一个集成的 Twitter API 平台，为所有人服务，从测试新想法的个人开发者到 Twitter 最大的企业合作伙伴。” 新的访问层级：在统一其平台的同时，Twitter 还将根据其多样化的开发者群体的需求推出新的访问层级。这将包括用于测试想法和构建新产品的免费访问层级；以及具有增强功能和速率限制的付费和企业访问，以帮助组织扩展其想法。 新的数据和互动 API：Twitter 预览了新的 API，这些 API 将帮助企业更好地利用其平台上的大量用户数据。 正如 Twitter 解释的那样：“企业依靠这些公共数据来了解要构建哪些产品、如何营销它们、他们的客户是谁，以及人们对他们的产品和服务的看法。我们将推出新的 API，以帮助开发者构建可以为企业解锁新见解的产品。” 他们还预览了新的 API，这将帮助开发者构建专注于利用 Twitter 的数据来改进客户服务和自动化的应用程序。 未来的公共路线图：Twitter 1200 多字的公告中最值得注意的部分是，该公司首次发布了截至 2018 年初的 API 项目的公共路线图。 这包括已于 2017 年交付的新产品的更新，以及将在今年剩余时间推出的新产品和功能的概述。
这个最新的公告对您意味着什么？
如果您是一名依赖 Twitter 公共 API 来构建和扩展应用程序的开发者，那么最新的公告为该平台的未来提供了很多值得期待的东西。但是，API 提供商也可以从 Twitter 的最新公告中学习一些重要的经验教训，以构建自己成功的 API 项目。以下是一些需要考虑的要点
1. 确定您的项目存在的原因
在开始介绍其 API 平台的新内容之前，Twitter 概述了其 API 项目的目的以及它存在的根本原因：“通过我们的开发者生态系统的帮助，我们的 API 平台使我们能够服务用例并鼓励创新，从而为 Twitter 上的每个人带来更好的体验。” 虽然这似乎是显而易见的第一步，但许多组织在没有明确的愿景的情况下就仓促地开展 API 项目。 虽然您的组织有很多理由投资构建 API，该项目的成功将取决于了解其目的以及向您试图吸引的人提供价值。 您是否试图在较小的范围内建立合作伙伴关系？您想吸引成千上万的开发者，并在您的平台上开启新的创新机会吗？ 在开始之前，对您的项目有一个清晰的愿景。
2. 考虑开发者体验
Twitter 最近的公告是当今 API 经济中开发者体验重要性的一个明确示例。 Twitter 本身 已经承认他们并没有总是为在其平台上构建应用程序的开发者提供最佳体验，并且已经采取措施改善与应用程序开发者的关系。 它将分裂的 API 项目统一到一个平台，并具有不同的访问层级，这是一个很好的例子，说明组织应如何根据其受众的需求调整其 API 项目。 出色的开发者体验从了解使用您的 API 的不同受众开始。 然后，您可以规划他们将如何使用您的 API 以及他们在 API 生命周期中需要什么。 以 Twitter 为例，为开发者提供免费的访问层级来测试新想法并开始构建新应用程序，这为他们从一开始就提供出色的开发者体验提供了一个很好的切入点。
3. 清晰有效地沟通
API 应与您的团队交付的任何软件或应用程序一样，受到一流的待遇。 这意味着，正如您希望清晰地传达您的核心产品的变化一样，您也希望与您的 API 最终用户清晰地沟通。 并非每次更新都需要冗长的博客文章或向您的用户群进行公开宣传。 但是，您应该有一个流程来让您的最终用户了解会影响他们如何使用您的 API 的更改。 这时，API 管理工具就可以派上用场，它可以快速访问使用过您的 API 的用户列表。 这也是拥有 API 生命周期管理解决方案也非常重要的地方，它可以处理 API 生命周期中从规划、设计、部署到弃用的所有阶段。
4. 通过出色的文档支持您的项目
出色的开发者体验始于出色的 API 文档。 在 Twitter 在其平台上推出的更改背后，有对开发者有用的文档来了解如何使用 Twitter 的服务。 API 文档是成功使用 API 并与之集成所需的信息。 这将以技术写作、代码示例和示例的形式呈现，以便更好地理解如何使用 API。 一个强大的 API 文档工具（如 SwaggerHub）可以帮助您实现这一目标，它为您的团队提供了一个用于设计和记录 API 的中心平台，具有文档的实时可视化呈现、零设置的完全托管文档以及具有分支、差异和合并的受控工作流。 无论您如何管理 API 文档，请确保您的最终用户可以轻松访问他们在与您的 API 协作时取得成功所需的信息。我们很高兴看到 Twitter 的 API 项目的未来。有关在当今 API 经济中构建 API 项目的更多提示，请查看我们的最新电子书：如何针对当今的 API 经济优化您的 Swagger 工作流。