Skip to main content

第一步:创建项目

平台是通过项目对API进行统一的管理。因此在注册API到平台之前,需要先创建项目(项目可以对应一个实际的应用系统,也可以对应某个业务部门)。

您可以直接创建一个空项目。为了方便使用者,平台还提供了4种常见的快捷方式,通过快捷方式的方式创建项目可以提前在项目中注册相应类型的后端及API。大多数情况下,我们会选择第一种【代理已有的API】:

代理api

类型描述
代理已有API(最常用)将已存在的 HTTP API 以透传的方式注册至项目中
SOAP服务基于WSDL,以透传或REST转换的方式注册 SOAP API
编排应用将集成管理中的编排应用作为后端
D2A应用将D2A应用作为后端

创建项目时模板会引导您填写必要的信息

  • *项目名称:项目标识,同租户下不能重名。支持在项目列表中对项目名称进行修改。
  • *项目路径:它是API访问URL中的重要组成部分,用于在网关路由中区分不同项目。
  • *默认路由路径:随项目创建的默认路由的路径。请尽量不要用`/`当做的路由路径。因为 **在同一个项目中的路由路径不能重复或存在包含关系**,如果使用`/`作为路由路径,这样无论创建什么样的路由都会认为是它的子集,而提示:**“当前路径和已有路径存在包含关系”。**
  • 项目描述:方便其他管理员快速了解项目的创建意图。
  • *后端地址:随项目创建的默认代理的后端地址。后端地址不是完整的后端API请求URL,而应该是前缀部分,在客户端调用平台发布后的API时,和API路径拼接后代理给后端。

项目路径

API发布后的调用URL构成为:http(s)://host/(环境路径)/门户路径/项目路径/路由路径/API路径

选择环境和访问类型

为该项目选择未来可以部署的环境以及允许的协议类型(HTTP/HTTPS)。 添加证书

恭喜您! 此时已经完成了第一个项目的创建。