第一个策略-超级API的秘密II



在第一部分，我们看到了贵公司可能面临的遗留问题和缺乏API战略，但你可把握机会。我们积极地完成了一个令人信服的，雄辩的表达视觉。

现在让我们着手制定一个行动计划。

制定你的指导原则

指导原则是普遍的意图声明，帮助你和你的团队保持重要的头脑。这里有一些有用的提示让你开始。我们发现它们确实有用。

所有的API都是外部的。或者至少，被视为这样。这意味着你的技术标准的各个方面都坚与许可证相符。

将企业架构转化为完全API方向。就像亚马逊，让你做的一切在内部系统通过API来完成。期（period）。这导致了整齐的建筑，也可以让你“吃自己的狗食”(eat your own dog food)，它具有促进再利用，通过客户的眼睛，让你看到你的服务的双重优点，缺点和不足。紧松耦合。

坚持松散耦合的原则是最好的，在大多数情况下，有足够的灵活性，以欣赏紧耦合的意义（即在一个特定的用例要求特定的API）。为了描述这两种方法，新兴的术语是“产品”和“经验”（分别）。

产品开发。确保您的API设计…

…以用户为中心。API的目的是为了让客户更容易做他们想做的事情。他们有一个“工作要做”。当你帮助他们完成（比其他方法更好），他们雇用你。

…协调。每个API就像乐器；它可以在一个伟大的独奏也与API在你的产品范围包括二重奏音乐会等工作，四到完整的管弦乐队，其中可能包括乐器，对不起，API，从其他公司，也是这样。我们这样想。如果客户需要组成一片需要大管，但晨星没有大管，客户端可以从大管专家服务和发挥在晨星仪器。是的，我知道有可能采取比喻太远。

当你绘制你的价值链和分销网络时，把“你的业务作为服务”。你的产品是向消费者提供价值的直接渠道。您的API允许客户和合作伙伴向消费者传递您的价值，并加强您的业务的网络效果。

你的行动计划

所以假设你购买API的旅程，你需要做什么？

给自己找一份服务目录。通过提供宏大的文档，很容易发现和理解您的API。很明显，对吧？如此明显，它往往被忽视。一个易于使用的开发者门户是DX的基础。

设置标准。制定一套坚实的标准并坚持下去。发布它们，像微软一样（晨星也会做得很快，也）。这为你自己的API开发设置了一个条形图，帮助世界了解如何集成你的API。

思考以下：

在发布之前要求API满足的接受标准。也许一个孵化器计划可以帮助您通过开发周期来开发原料药。

设置API文档的接受标准。

你的标准中可能包含的一些东西是：

API作出服务可用性承诺。

服务包括主动能力管理（或手动能力管理政策/过程）。

被部署到适当的标准（主动和主动被动等）

安静的（或您选择），并坚持相关的最佳实践。

提供仪器仪表（如连接系统如Splunk或AppDynamics）。

API开发在组织内协调，即不重复工作。谁需要两个API做几乎一样的事情？

你提供正确的客户支持条款。

服务有故障模式，这是很好的考虑（API如何处理故障，管理能力等）

你的API有折旧政策。

API有一个周到的方法来版本，例如，从消费者的角度思考（例如，避免破坏性的变化，在所有可能的，尤其是对小版本更新）。

它的治理，不是沉重的

最终，你会希望API原理成为文化的一部分。这不会发生没有焦点（和时间），所以你需要一层治理，让你诚实。考虑形成一个团队的智能，风度翩翩，有上进心的人一项职责包括以下：

给人们的第一种方法即API的利益取向带来API从产品和企业结构的命题。

以确保API被设计在“你的公司作为一种服务” - 即语境，每个API完美补充同行。客户喜爱的API，易于组合和消费和提取价值。

确保API按照您的技术标准设计、交付和记录。这可能也是本集团将开发和正式的标准。

这都是关于产品

当你想到这与你的产品策略有什么关系时，这里有一些事情要考虑，从晨星的思维方式：

建立大家爱的API。API的目的是专注于最终用户和开发人员需要，消除复杂性的消费者。我们在产品设计过程中测试、迭代和参与客户。正如我们专注于用户体验的软件设计，我们采取了类似的勤奋和包容性的API设计方法。推荐阅读：为人类构建API和API开发者的经验比以往任何时候都重要。找出你的客户想要完成的工作，让他们通过提供最好的解决方案来雇佣你。

我们认为“晨星是一种服务”。没有API是一个岛（No API is an island），John Donnewrote（或沿着这些线路的东西）。客户通常消耗超过一个晨星API（很可能是Web组件和晨星直接）；他们期望API的设计一致，共同努力，以解决他们的业务需求，以协调的方式。当我们设计我们的API产品命题时，我们把这个广大客户的角度看我们所有的API（没有例外）作为一个单一的命题，而不是设计的API隔离。

内部与外部—— 它们的区别是什么？在向外部客户提供一组API的同时，以完全不同的方式访问相同的数据和服务，这是对偶的价值。创建一套，内部和外部使用的API的好处（在完全相同的方式）有很多：最大化再利用通过集中精力在我们真正自豪和服务单一的一套，这样做，我们不歧视任何情况下（内部的和外部的）。我们“吃我们自己的狗食”，在这样做，我们生动地体验我们的服务，通过我们的客户的眼睛，这是一个巨大的帮助精炼和建设产品，用户爱。

现在，对你而言它结束了。

谢谢你参与这篇文章，我希望你能从你所读到的东西中获得价值。如果你这样做，请分享和接触，如果你想知道更多关于晨星的API范围。