关于api:耗时半年Eoapi-正式发布插件广场

41次阅读

共计 2404 个字符,预计需要花费 7 分钟才能阅读完成。

这是咱们的第一篇月报,每个月和每个来之不易的开发者分享产品故事以及产品停顿。

在 5.20 这个极具中国特色的“节日”里,Eoapi 公布了 1.0.0 版,三个程序员掉了半年头发堆出了第一个正式版本。

Eoapi 介绍给大家的过程中,咱们遇到的最多问题是:

你和 Postman 有什么区别?
Postman 呈现的工夫,是八年前,简直是同类型 API 工具的祖师爷。
毋庸置疑它是一款优良的产品,在那个应用 Curl、浏览器、抓包工具调试 API 的年代,这款反对通过界面对 API 发动测试的工具令人眼前一亮。

那咱们为什么还要做 Eoapi 呢?

1. 商业工具不够凋谢

商业工具不够凋谢,除非官网反对,否则很难和其余平台买通。
现实中的用户每天都在应用咱们的产品解决任何问题,而实际上用户每天会和各种不同的工具打交道,并没有足够多的工夫专一在应用你的产品。


△ by Jonathan Holt @ Dribbble

所以足够简略,同时打磨外围性能,定义好产品的边界很重要。
咱们不想做一个 All in one 的工具,如果没法满足用户的所有需要,那就足够凋谢让用户抉择依照他们喜爱的形式应用各个产品。

没有什么能比代码开源更凋谢了!

所以从去年 11 月开始,咱们开始立项、组团队开始做 Eoapi

下方截图是咱们的第一个用户,我在调研时问他:你期待的 API 工具是什么样子?

他答复:心愿各个工具不要做数据孤岛,能连通多个产品。


须要开发者本人写工具连通

如果说代码开源是咱们凋谢的第一步,那第二步就是退出插件零碎了。

如果只是代码开源,想要拓展性能依然比拟艰难,我晓得很多团队会抉择在源代码的根底上二次开发,但当抉择二次开发的那一刻起,可能就和后续的官网更新 say goodbye 了,对用户和官网来说都是一种损失,而插件零碎就是解决这个问题的一个很好的计划。

插件零碎让 开发者群体——一群极具创造力的人以更简略的形式参加共建,扩大性能、复用性能、碰撞更多可能。

2. 团队须要本地部署

商业产品数据个别放在云端,思考到安全性,国内大多数公司会将 API 托管在本人平台,有资源的大公司造轮子,没资源的小团队应用开源工具。

Eoapi 能够单机应用,数据存储到本地,也反对在本人的服务器近程数据源,你齐全能够把数据把握在本人手里。

3. 更晦涩的合作

Postman 性能比拟垂直,单点功能设计很棒,但理论用于团队合作时性能操作逻辑不够连贯,也不够贴合国人开发合作场景。

国外的需要更偏差个体效率,而国内的需要更偏差于管理效率 。如何在满足个体效率的同时贴合国内的管理效率,这是 Eoapi 想要找到的均衡。

咱们不会说 Eoapi 是一款针对中国开发者研发的产品,咱们的用户是所有开发者,不分国界。

我心目中真正好的 API 工具,远不止调试,还能够让开发者:

  • 更快地开发更标准、更稳固的 API
  • 在工具上记录的 API 数据施展更大的价值
  • 合作更加地顺畅

咱们更新了什么?

划重点:

  • Eoapi 上线插件广场
  • Eoapi 支持系统设置
  • 官网文档退出开发者文档
  • 开发者命令行工具 @eoapi/cli 上线
  • 反对 M1 内核 Mac 安装包

本月产品更新的主题是:一个插件的毕生。
插件的【开发】->【调试】->【上传】->【上架】->【装置】->【应用】

插件零碎

1. 插件广场
咱们能够通过插件广场在利用中搜寻、治理插件,目前有官网提供的两个插件:

  • 导出 Swagger OpenAPI 格局插件
  • 将 Eoapi 接口数据同步到 Eolink

能够通过反馈分割插件开发者倡议需要、反馈缺点

2. 开发者文档

开发者文档是开发者体验必不可少的一环,

Eoapi 文档准则:说人话、目标清晰、用词精确、图文并貌、最好有示例

ps:如果发现文档有误或者有改良倡议,文档最下方能够提 Issue 或 Pull request 奉献此文档~

3. 插件代码示例

仓库地址:https://github.com/eolinker/eoapi-extensions

代码示例是理解一个插件文件构造最疾速的形式,目前反对生成的性能模板:

  • 导出插件
  • 将 API 数据一键更新到其余平台

4. 开发者命令行工具

仓库地址:https://github.com/eolinker/eoapi-cli

咱们能够通过命令行疾速生成一个插件模板。
实践上来说,实现一个导出插件只须要:

  • 配置一个入口文件
  • 实现 API 数据转换的函数
    除去函数实现工夫,从配置到上传插件只须要 5 分钟。

API 详情

能够在详情页

  • 导出 API 数据
  • 将 API 推送到其余平台:须要装置相干的插件
    后续打算和各大平台单干,因为产品起步期没有流量(弱弱地),单干推动会比拟艰难,所以先抉择了 Eolink SaaS 产品进行单干,能够间接将 Eoapi 的接口同步到 Eolink 的某个我的项目。

置信随着用户数减少以及官网的致力,通过 API 数据买通的工具 / 平台会越来越多。

目前已知场景:

  • 低代码平台:从 API 文档失去返回值格局,绑定低代码组件的字段
  • API 网关:从 API 文档数据疾速生成网关路由,缩小手动录入的老本
  • API 监控平台
  • Mock 平台,例如 Mock Lab
  • 云服务总线 ESB、CSB

如果有其余场景,欢送反馈,咱们会及时响应(上面有微信群,当然上 github 提 Issue 更好~)

零碎设置

通过零碎设置做一些集体的个性化设置,以及填写插件的所需的配置项。

其余

# 号代表相应的 issue、pull request 编号
  • 插件广场不须要 Node 反对 #36
  • 环境优化 #42 #43
  • 测试历史工夫显示为空 && 测试页滚动条谬误 #22
  • 拖动分组、API 无响应 #32
  • 删除 API 显示失败 #27
  • MacOS 零碎 M1 内核反对

性能预报

6 月围绕 合作性能 国际化 实现性能拓展。

  • 导入插件外围反对 —— 导入 Swagger、Postman、Eolink 等平台数据
  • Mock —— 前端应用 Mock 帮助联调
  • 近程数据源 —— 数据源部署在本人的服务器,多人合作
  • 多语言反对 —— 国际化反对

如果你对咱们的开源我的项目感兴趣,能够来这里找我:
Github:
https://github.com/eolinker/e…

正文完
 0