Orion-API-ManagerAPI 文档管理器

联合创作 · 2023-10-02 04:31

Orion-API-Manager(以下简称: OrionAM)是一个 API 文档管理器,为后端开发人员提供API管理,也为前端人员提供友好容易查看与测试的UI; 系统集成了权限适合在一个机构中不同的团队使用,支持导入或显示OpenAPI(Swagger)等接口文档...

使用文档

https://mirren.gitee.io/orion-api-manager-docs

一些解答

  • 问:为什么要做这么一个东西?
  • 答:因为大多前后端分离的公司基本都跟本人公司一样,要求先有接口文档然后再进行编码;
  • 问:这个东西可以做什么?可以像Swagger之类的生成API吗?
  • 答:OrionAM不能像Swagger一样为代码生成API,但是支持导入Swagger之类的API,OrionAM是用来可视化创建API或查看API的;
  • 问:市面上已经有接口文档管理器了为什么还要出OrionAM,
  • 答:在本人的公司,我写的另外一个接口文档管理器已经用了多年,前后端的同事们都已经习惯了,所以将其升级优化并进行的开源;愿景是让跟我们有类似需求的程序员可以有多一个选择,使大家的编码生涯简单一点方便一点;最主要的目的是要融合本人开发的另外一个API网关形成一套完整的体系

项目演示截图

项目列表

API分组管理

API详情

暂无服务器可以来做演示,更多的信息你可以观看使用文档中的视频

项目的结构

  • 项目的后台采用了大部分人熟悉的SpringBoot2.3编写(其实本人已经几年没用Spring套装了,这几年都是用Vert.x)
  • 存储默认使用Sqlite 3数据库,支持更换为其他数据库(数据库操作使用MyBatis)
  • 客户端使用Vue加Element-UI

客户端原码

Server: https://github.com/MirrenTools/Orion-Api-Manager-Server

Client: https://github.com/MirrenTools/Orion-API-Manager-Client

项目如何运行

  • 运行环境要求:开发环境为java 1.8.0_121,理论上java1.8以上都可以运行,如果没有java运行环境,可以看使用说明里面的免JDK教程
  • 项目可以在releases(发行版)里面下载已经打包好的也可以自己打包项目
  • 执行 mvn clean package 进行项目打包
  • 执行完毕后 进入target/Orion目录,该目录包含了Client-UI(展示接口文档的UI),Server-UI(管理接口的UI),config(存放接口文档的Sqlite,配置信息与用户信息),Orion-API-Manager.jar
  • 在Orion目录中执行java -jar Orion-API-Manager.jar 或直接运行start.bat(windows)start.sh(unix)启动Orion服务,端口号默认为8686
  • 启动Orion服务后在浏览器访问http://服务地址:端口号
  • 默认超级管理员登录账号为X-root,登录密码为helloOrionAM,超级管理员账号在config/user.json中管理

使用说明

  • 第一步 启动Orion-API-Manager.jar(start.bat / start.sh)
  • 第二步 访问http://服务地址:端口号
  • 第三步 创建用户
  • 第四步 创建项目
  • 第五步 在API管理中创建分组与接口
  • 第六步 分享或在Client中查看
浏览 1
点赞
评论
收藏
分享

手机扫一扫分享

编辑 分享
举报
评论
图片
表情
推荐
点赞
评论
收藏
分享

手机扫一扫分享

编辑 分享
举报