开源 API 管理工具 v1.8.0 发布,数据上云,API 团队协作

大家好,时隔一个月,我们又又又发布啦,本月的主题是:团队协作

在开发模式是前后端协作的团队里,分享 API 文档信息会是前后端对接过程中重要的一环,我想在这次月报分享下我们工具推荐的开发流程。

知乎上有一个热门问题:后端人员先开发后给文档合理吗?

我认为不合理,换位思考了下在这种开发模式下的前端人员,对接的过程应该蛮痛苦,前端开发的能力和经验决定后续改动代码的痛苦程度。

涉及到多人共同协作完成一件事的时候,不应该把设计任务只交给其中的某一个人,应该先交流和沟通,将设计的流程前置,并用文档记录设计的过程和结果。

就像开发人员总会吐槽产品文档没写清楚一样,前端人员也会吐槽后端不给文档或者写不清楚,这个问题可以通过引入一个能协作设计并展示清晰的 API 信息的工具(明示 Eoapi)解决。

你可以考虑在 Eoapi 尝试采用以下简易的协作流程:

  • 设计接口原型,写接口文档;
  • 前后端同步写代码,根据文档对接;
  • 在对接过程中获得的信息优化接口原型,重复过程。

更直观一些,两种协作流程的对比如图:

其实工作都是这些工作,但将设计的过程提前可以减少很多协作问题。

朋友们,相信我,想通过不写文档节省的时间最终都会在对接扯皮过程中还给我们;而且人多力量大嘛,不同的人有不同的角度,观点碰撞可以让设计更好更全面。

当然,决定在设计过程中投入多少时间和精力是需要根据团队的情况调配的,团队很有默契不用约定也能设计一致,那文档什么时候写就不太重要了,适合自己团队的流程就是最好的。

空间是什么?

我们在这个版本引入了空间的概念,一个空间一般是一个团队,我们可以往空间里添加队友:

加入后就可以一起愉快地共享 API 和环境等空间内数据啦~

想起在月初的时候,有用户恳(wei)请(xie)我们一定一定一定不要做登录的功能,我理解他的核心的诉求其实是打开就能用,别整那么多花里胡哨的。

作为 Eoapi 的产品和开发我想说:放心吧,如果你用不上云端的功能,那就没有登录的必要,在本地空间内尽情使用吧~

如何使用

在服务端运行下面命令使用 Docker 一键启动。

git clone https://github.com/eolinker/eoapi-remote-server
cd eoapi-remote-server
docker-compose up -d --build

在客户端中配置云服务地址点击连接后就可以将数据上传到云端啦。

配置这一块我们设计得十分简单,隐藏了很多配置细节,界面提示可以指引你快速上手新功能。例如初始化时可以让你选择将本地的数据同步到云端。

后续计划

Web 部署

目前我们都是通过桌面端使用的,有的用户会觉得部署和更新不太方便。

所以我们接下来会推出 Web 版本,方便大家打开浏览器就能使用(我个人更喜欢 Web 应用)~其实桌面端有桌面端的好处,方便找,加载快,不需要部署,萝卜青菜各有所爱。

API 分享

正在开发中,相信很快就能在 v1.9.0 和大家见面啦。

使用很简单,一键就可以通过分享链接快速将 API 分享给相关的人员。原型图浅看一下:

获得 GVP

除了新版本发布,还有一个好消息!本月我们的开源项目终于也获得了 Gitee 官方的认可荣获 Gitee 年度最有价值的开源项目称号——GVP,谢谢官方的认可!谢谢各位用户的支持!

努力提升用户体验是我们做开源项目的初心,尽管我们的项目在 Gitee 上传代码不久,但为了让所有用户能有较好的下载体验,我们会在后续任何一个新版本发布的第一时间同步 Gitee

我们会努力做好项目,也希望我们的项目能继续得到你们的大力支持!关于项目,如果你有任何的疑问或者建议,老规矩,记得去 Github 或者 Gitee 上提 Issue ,我们会第一时间处理。

在线 Demo:https://www.eoapi.io/?utm_sou...

在线文档:https://docs.eoapi.io/?utm_so...

Github:https://github.com/eolinker/e...

Gitee:https://gitee.com/eolink_admi...

我叫 Postcat,我是一款开源 API 工具,我更轻量,同时可拓展!我可以简化你的 API 开发工作,让你更快...

275 声望
12 粉丝
0 条评论
推荐阅读
IDEA 插件上新! 生成接口文档就是这么快!
当有接口对接需求的时候,开发终于不用再担心 API 文档难写了,也不用再一个个接口文档重新写!安装这个 IDEA 插件,可以一步将文档导入到 Postcat。

Postcat2阅读 141评论 1

封面图
3 分钟上手,不用再找 Chatgpt 资源了,这里全都有
最近无论是打开社交网站,还是朋友圈,就连中午吃个饭都能听到大家都在聊 Chatgpt,仿佛如果这一刻你不懂这是个啥玩意儿,你就会觉得自己完全搭不上他们的话...

Postcat4阅读 772评论 5

封面图
Apache APISIX 2.12.0 版本发布,新功能更适配新一年!
继 2.11.0 版本发布之后,Apache APISIX 也在即将到来的新春佳节,为大家带来 2022 年第一个带有新功能的版本。在此也算携手新版本给大家拜个早年了!

API7_技术团队1阅读 1.2k

封面图
ChatGPT 插件上线!亲测,更加便捷!
ChatGPT 正火的时候,还有很多人都在忙着搜教程,大家想亲自体验原汁原味的 ChatGPTt,可搜到的资源要不是很难用,或者无法科学上网,挺折腾的,现在终于不用那么麻烦了。

Postcat2阅读 286评论 4

1024 开源首发 | SQL 审核工具 SQLE
在 2017 、2018 年和 2019 年的 10 月 24 日,爱可生开源社区出品了 MySQL 分布式中间件 DBLE 、数据复制产品 DTLE 和全局事务框架 TXLE 。时隔两年,这三款产品在社区积累了更多的设计经验和用户反馈,有更多的...

爱可生云数据库阅读 3.1k

又又又一个小更新,主题插件上线!这个开源 api 管理工具更好用!
近日 Postcat 终于上新了用户期待已久的 12 款【主题插件】!喵喵我啊,想着这下再也没有哪位用户老爷会吐槽 我们 Postcat 的主题过于简洁吧!

Postcat2阅读 224

别再说 AI 了,这个 API 管理工具悄悄开源了,快来看看
说到开源的 API 管理工具,大家可能很容易想到 Postman 的妹妹 Postwoman,如果你也喜欢开源产品,那接下来这个工具你可不能错过~

气势凌人的柿子2阅读 347

我叫 Postcat,我是一款开源 API 工具,我更轻量,同时可拓展!我可以简化你的 API 开发工作,让你更快...

275 声望
12 粉丝
宣传栏