API管理门户主要管理企业内部及外部的所有API,RestCloud API门户支持通过Java代码中的注解自动扫描生成API文档、通过OpenAPI3.0标准文档导入、JSON格式数据导入等多种方式、导入后形成企业的统一的API清单。用户在API管理门中可以对API接口进行审批、申请调用、检索、评价、关注、分类、测试、设计、导出、发布API等。RestCloud API管理门户与API网关相互配合完成整个API的全生命周期管理。
一、基于应用管理API接口
RestCloud可以从多工程,多应用、多分类、多标签、Class类等多维度来管理API接口,优于swagger ui的仅从Class类或分类来管理接口,当接口数量众多时RestCloud API接口管理平台将体现出极大优势。
二、API接口全局搜索
RestCloud API接口管理平台支持全局的模糊搜索和精确搜索,通过搜索可以快速定位一个API的来源和详细调用信息,供应商、合作伙伴、前后端开发人员可以一键对API进行搜索和查看API的详细文档,并能在线对API进行测试,可以极大的加快API的接入和联调测试效率。
三、API按标签聚合进行管理
RestCloud API管理平台允许一个API打上多个标签,通过标签可以对API进行更多维度的管理和查找。
RestCloud API接口管理平台允许用户根据业务需求直接通过Web界面对API进行设计无需编程人员参与就可以进行设计包括:url格式、输入参数、输出参数、较验规则、错误提示等等信息,一旦接口设计好后端开发人员可以根据自动生成的注解代码实现业务逻辑即可。
四、适用业务场景
1、作为企业统一的API接口治理平台对API进行检索、评价、关注、测试;
2、作为企业所有API开发和调用的评价、接入管理平台,实现前端设计人员与后端API开发人员解藕;
3、实现企业所有API接口的可视化管理,并作为API设计和数据模拟平台;
4、根据业务领域对分散的API进行分类管控和标注;
5、为企业的合作伙伴或软件开发商提供一个统一的API接入和调用的门户;
6、作为企事业单位数据服务共享的服务门户,实现对数据服务的统一管理和检索。
五、Java注解自动扫描生成API文档
基于RestCloud的自定义注解规范可对API进行注解,系统根据注解自动扫描生成API的详细文档,支持非常丰富的API注解说明,支持自定义注解是API接口管理平台的能自动化大量收集开发人员API的关键技术之一,开发人员只需要写完代码和注解即可自动生成API文档,而传统开发方式由于注解不全面在生成API文档后还需要手工补充不完整的API信息。
六、OpenAPI3.0国际标准兼容
RestCloud API管理平台中的所有API文档都可以输出成为国际标准的OpenAPI3.0标准文档并且支持JSON和YAML格式,并且支持按Class类、按应用整体输出。
RestCloud API接口管理平台允许用户根据业务需求直接通过Web界面对API进行设计无需编程人员参与就可以进行设计包括:url格式、输入参数、输出参数、较验规则、错误提示等等信息,一旦接口设计好后端开发人员可以根据自动生成的注解代码实现业务逻辑即可。