rap很好可是很卡,有没有类似的开源(不要钱)的
需求:
管理api接口,模拟数据
管理数据字典,方便查询数据库
软件说明文档(支持mackrdown格式)
允许部署到自己的平台上(最好是node,java,php版本都有)
支持数据123需求中的数据导入导出(重要!!!)
……………………………………………………………………………………
跪求大神推荐
rap很好可是很卡,有没有类似的开源(不要钱)的
需求:
管理api接口,模拟数据
管理数据字典,方便查询数据库
软件说明文档(支持mackrdown格式)
允许部署到自己的平台上(最好是node,java,php版本都有)
支持数据123需求中的数据导入导出(重要!!!)
……………………………………………………………………………………
跪求大神推荐
国外的话Swagger(Swagger – The World's Most Popular Framework for APIs.),
目前国内做得最好的是EOAPI(EOAPI - 业内领先的接口管理平台)。
EOAPI一直比较低调,相对于其他做噱头的产品,它就更加专注用户体验和功能性的提升,因此我也比较喜欢它。
EOAPI有线上版本和开源版本,基于PHP。
附上EOAPI的一些简介(来自EOAPI的官网):
接口管理
无论你是个人开发者、创业团队还是成熟企业,eoapi将满足你的所有接口管理需求。
不再需要为每个项目搭建独立的接口管理平台和编写离线的接口文档,一切的项目接口管理都将在云端进行。
项目协作
传统的word、excel以及自建wiki等文档工具,均无法摆脱编写繁琐、阅读困难、维护麻烦等缺点。
eoapi能够让你注册后便开始协作,其规范化的文档、清晰的分类以及友好的阅读界面,让文档更新和协作不再痛苦。
在线测试
传统如DHC以及postman等测试工具已无法满足接口管理工作,并且无法提供性能测试报告。
eoapi则将代替传统测试工具,无须翻墙和安装,只需网页轻轻一点即可得知完整的接口测试信息。
EOAPI个人开源版本(EOAPI - 业内领先的接口管理平台):
CrapApi开源接口管理系统演示地址
CrapApi:一个由angularjs+bootstrap+springMVC搭建的高性能的免费开源的API接口、文档管理系统(应用接口管理系统)
GitHub源码地址:https://github.com/EhsanTang/...
码云源码地址:http://git.oschina.net/CrapAp...
主要功能:api接口管理、数据字典管理、接口数据模拟、接口文档管理(支持markdown、kindereditor等编辑器)、支持本地部署或在线使用、支持通过建表语句导入数据字典...
其他功能:项目管理、用户管理、模块管理、接口管理、接口版本管理、接口拷贝、接口文档pdf下载、接口mock、模块加密访问、
接口在线调试、数据字典管理、数据字典加密访问多管理员、多权限、多角色管理、自定义菜单、自定义网站样式、文档留言、
错误码管理、接口排序、DOC、PDF、TEXT、EXCEL等资源管理、支持版本号控制、文档内容检索、操作日志记录、
根据日志恢复数据、markdown编辑器、kindeditor编辑器、angularjs编辑器、Lucene搜索、项目成员管理...
站点使用地址:http://api2.crap.cn
效果图:
可以试试 NEI 接口管理平台,官网地址:https://nei.netease.com。
对于现代 Web 产品来说,API 的重要性不言而喻,相信前后端工程师都深有体会。
关于 API 的开发流程,笔者咨询过一些朋友,也在面试的过程中问过一些候选人,抱随意的态度较多:口头约定、邮件约定、通过即时聊天工具发送,也有编写较详细的 Word 文档的。大家都被这么一个问题困绕着:想了解 API 的完整参数及含义,除了看源码之外别无他法。如果是自己编写的代码,短期内还能回想起来,如果是别人编写的代码,那可能看了源码也还是一知半解。
再说一个在开发时的常见现象。API 中的 ID 字段,对类型“不敏感”的后端工程师,可能一会儿返回 number 类型,一会儿返回 string 类型。而前端工程师,都喜欢用“===”来判断,对类型有严格的要求。对于 number 类型,如果超过一定的位数,在浏览器端又会有溢出的问题。就这么一个类型不一致的问题,不知道浪费了全世界工程师的多少青春岁月。
所以,我们迫切需要这么一个产品:
方便地管理项目中的所有 API
API 文档清晰直观并且方便查看
有自动化 API 测试工具,方便开发和测试工程师进行回归测试
有方便地生成规范的 API 的功能,比如 RESTful API
对于前端工程师来说,还有一个必不可少的功能:API 模拟容器(响应数据是根据 API 定义 MOCK 出来的),以便在后端没有开发好接口之前就能进行页面开发。这个 API 模拟容器对代码没有侵入性,即前端编写的代码,上线时不需要进行任何处理。
就笔者的观察,能满足以上需求的工具在整个业界(包括国外)都还很少见。
NEI 是网易杭研前端技术部推出的一款产品,旨在帮助项目团队更好的管理 API 接口。NEI 是杭研前端团队多年的技术沉淀,是很多位资深工程师的丰富经验总结,之前一直只有网易内部用户才能使用,今年 9 月初正式对外部用户开放。
下面大致地介绍一下 NEI。
NEI 按项目来管理所有资源,资源的创建和维护可由团队成员协作完成,目前它已经提供了以下功能:
项目管理:动态、团队管理、权限管理、项目文档等
页面管理:项目中的页面定义
异步接口:即本文所说的 API,可以定义请求头、请求数据、发送规则、响应头、响应结果、接收规则等
接口测试和用例管理:方便回归测试和生成测试代码
数据模型:NEI 中最强大的功能之一,对应数据库中的实体对象
页面模板:NEI 配套的构建工具会根据定义生成模板文件
规则函数:自定义 MOCK 数据,NEI 也预置了常见的规则函数
业务分组:按照业务对项目资源进行细分,方便管理
工程规范:本身可以当作脚手架,也可以和 NEI 项目结合,集成项目中的 API 和数据模型
消息中心:保证重要的操作能及时通知到相关负责人
下面是几篇介绍文章:
NEI 基本概念介绍
使用 NEI 进行前后端并行开发
老项目迁移到 NEI 上的说明
NEI 工程规范介绍
一步一步教你如何愉快地生成 JavaBean 文件
以上所有文章都放在 Github 仓库的 doc 目录下:NEI 配套构建工具。
如果 NEI 能解决您遇到的一些麻烦事儿,那就赶紧去试试吧。
最后,也欢迎大家在使用的过程中给我们提建议和意见:
需求提议地址:nei-toolkit
NEI QQ 交流群号:453281988
目前 NEI 已经托管在网易云上,在此也非常感谢网易云提供的优质服务。
10 回答11.7k 阅读
2 回答3.2k 阅读✓ 已解决
8 回答6.5k 阅读
4 回答2.2k 阅读✓ 已解决
3 回答1.2k 阅读✓ 已解决
2 回答2.5k 阅读✓ 已解决
4 回答690 阅读✓ 已解决
可以试试swagger-ui。