香港带宽_服务器搭建svn_免费1年

小七 2019年10月25日 21:23 141 0

当我还是个孩子的时候，在学校，我的英语教材叫"你会说英语吗？"（以帕蒂和萨姆为主角！）。那时，行业大数据分析，我们都知道英语是全世界都在说的语言，这使全球的交流更加轻松。API用户、API开发人员和API平台使用相同的语言，就他们的工作达成一致，这不是很好吗？Swagger，现在称为OpenAPI，是一种被广泛采用的标记语言，web云服务器，它在描述api方面做得非常好。如果你谈论RAML，你会发现很多RAML-to-Swagger工具，这样你就可以翻译你的API规范了？在api的世界中，对api的描述是必不可少的：没有像SOA世界中那样的"企业存储库"。因此，API的描述（包括文档）必须非常好。API的描述实际上包括三个方面：–文档：任何想要使用API的开发人员都可以阅读和理解编写良好的API描述。它还可以集成到各种ui中，例如门户，以便发布。–实现：API描述是实际实现API的开发人员的指南，开发人员完全知道自己的API应该做什么，–开发人员和API提供商之间的合同：即使API尚未实现，API用户（例如开发人员）和API开发人员都已就通用模型达成一致，并且可以开始并行工作。如果合同发生变更，双方都应参与并达成一致。

SAP API管理中的OpenAPI随着8月份Hana云平台上最新发布的SAP API管理，我们引入了"API设计器"功能。通过此功能，您可以基于现有的OpenAPI文件创建API代理。如果您已经实现了API，并且希望通过HCP API管理以安全和定制的方式将其公开给合作伙伴或开发人员，那么这将非常有用。如果您刚开始使用api，并且需要首先实现它们，那么遵循"设计优先"的方法也是一个非常好的主意。这意味着您首先定义API的外观，以及完成后的功能。

本博客将指导您使用HCP的API设计器。

前提条件为了继续这个例子，大数据如何处理，您最好对HCP的API管理服务有一些基本的了解。您的HCP租户也需要启用此服务。

步骤1首先，我们需要一个API描述。我已经编写了一个简单的金融服务API描述，允许API用户获取和创建银行分行。

请注意，该描述已经非常可读。你可以抽出一些时间来回顾一下描述，以了解它的内容。基本上，我描述了两种资源：–分支：用于获取所有分支，或仅获取指定半径的分支（可选）–branchs/{uuid}：用于仅返回一个由其唯一标识符标识的特定分支

步骤2现在我们已经定义了API描述，是时候基于该描述创建代理了。

登录到您的Hana云平台驾驶舱。打开API管理服务。单击第三个图标访问API代理。

单击名为"在API设计器中创建"的新按钮。

API设计器打开，带有预定义的API描述框架。

因为我们已经有了API的描述，大多数情况下应该是这样，我们将不开始编辑描述。只需将左侧完整的YAML替换为我在上面发布的描述即可。

请注意，右侧的错误已经消失，因为OpenAPI描述是完整和正确的。现在，您可以在左侧导航OpenAPI文件，并看到您的更改立即反映在右侧。如果您出现任何错误，该错误将实时突出显示（例如，请注意OpenAPI描述中的缩进）。

要从API设计器中创建API代理，请在"文件"菜单中选择"保存"：

您现在可以指定将在SAP API管理中创建的API代理的名称。例如，将其命名为"FinServDemoAPI"，服务器和云服务器，点击"保存"按钮并导航回API代理列表。