应用程序调用路径和 MindSphere Gateway

应用程序的调用路径

对 MindSphere API 的任何访问都必须使用 MindSphere Gateway。根据您开发的是具有浏览器客户端的 Web 应用程序还是纯后端应用程序,对 API 的访问将有所不同,《开发人员文档》中介绍了相关信息。

Web 应用程序浏览器客户端可以

  • 调用 MindSphere API。这些调用必须指向以下架构的 URL:

    <web-app-host>/api/<api-name>[-<api-provider>]/v<major>/<endpoint>

  • 调用您自己的应用程序 API。这些调用必须指向以下架构的 URL:

    https://<tenant>-<webapp>[-<provider>].<region>.mindsphere-in.cn/[<path>]

您的原生移动应用程序可以

  • 通过认证服务器签发的服务凭证访问令牌来调用 MindSphere API 和您自己的应用程序 API。这些调用必须指向以下架构的 URL:

    https://gateway.<region>.mindsphere-in.cn/api/<api-name>[-<api-provider>]/v<major>/<endpoint>

MindSphere 后端应用程序可以

  • 使用从授权服务器获取的服务凭证访问令牌调用 MindSphere API。这些调用必须指向以下架构的 URL:

    https://gateway.<region>.mindsphere-in.cn/api/<api-name>[-<api-provider>]/v<major>/<endpoint>

  • 使用从浏览器客户端调用获取的访问令牌调用您自己的其它后端应用程序。

MindSphere Gateway 的可用性

为了使应用程序在 MindSphere Gateway 中可用,必须使用以下命名约定。

从 Web 应用程序客户端调用时需遵循以下架构:

https://<tenant>-<webapp>[-<provider>].<region>.mindsphere-in.cn/[<path>]

将路由到采用如下形式的内部 URL

https://<application>-<tenant-id>.apps.cn1.mindsphere-in.cn

Cloud Foundry

为了使应用程序可以从 Web 应用程序客户端调用,需要创建一个基于 Cloud Foundry 的应用程序,将其命名为 <application>-<tenant-name>,其中 <tenant-name> 为租户名称(即,MindAccess Developer 帐户或 MindAccess Operator 帐户的 URL,具体视情况而定),<application> 为 Web 应用程序客户端调用中要用作路径参数的名称。