这个 pc 客户端忙了两三个月，终于推出公测版，能配得上“高颜值”这个标签吗

[star7th]

前言

runapi 是一个接口开发测试工具（功能上类似 postman ），搭配我们开源的服务端，可免费私有部署到企业内网（文末会附上免费私有部署教程链接）。

runapi 在之前就已经有了一个版本，但是被用户说不够好看，不够“高颜值” 。于是果断把重写计划安排到日程，目标是： 高颜值，巨幅度提升用户体验。

忙了两三个月，终于推出公测版，希望能配得上“高颜值”标签。

预览图

下载和部署链接

runapi 3.0.0 版公测下载： https://www.showdoc.com.cn/runapi/10152635649730221

runapi 旧版： https://www.showdoc.com.cn/runapi/30291

如果你要免费私有部署到企业内网，则需要先部署我们开源的 showdoc 服务端： https://github.com/star7th/showdoc

如果你不要求私有部署，则直接注册客户端即可使用。

公测已经结束，正式发版了。不用再通过专门的公测链接去下载。直接下载正式版就行
https://www.showdoc.com.cn/runapi

[dashupc]

“高颜值” 。看看 ，是干啥用的， 有没有官网介绍

[awesomes]

个人认为这种工具就应该做成 web 的，参考 https://hoppscotch.io/（只不过这个工具的存储体验做得不好）

[star7th]

@dashupc

runapi 是一个跟 postman 差不多的接口开发测试工具。考虑到 postman 在开发者群体的高度知名度，所以我就没特别介绍了。文末有一些链接，你可以点进去分别了解更多。

[Pantheoon]

和 postman 的区别是啥?

[star7th]

@awesomes 做成 web 的话，也需要用户特定安装浏览器扩展，目前并没有明显比客户端方便。先看看吧，后面要开放也行，因为都是 web 技术栈开发的。

[Charod]

+1, 的确网页会更方便

[star7th]

@Pantheoon

最大的亮点是自动生成 api 文档到 showdoc https://github.com/star7th/showdoc

runapi 其实一开始是作为 showdoc 文档工具的附属存在的。近期开始想把 runapi 独立品牌宣传。

[xiaoz]

支持大佬，在用 showdoc ，之前安装了 runapi 界面确实有点。我试试新的客户端。

[christin]

本来想安装体验一下的，但是想了想 webstorm 自带的接口调试工具就行

[mydebug]

apifox 不好用吗

[star7th]

@mydebug

runapi 是可以免费部署到企业内网的。跟 apifox 不一样。相当多的企业对数据比较敏感。

[bigbigpark]

可否支持从 apifox 导入数据

[star7th]

@bigbigpark

你从它那里导出 openapi 格式的 json 文件，再导入 runapi

[XGF]

原来是 showdoc 团队啊，支持一下

[qiubaowei]

一直在用
还和贵方技术邮件沟通过 bug 不知道公测版有没有修复
至少看起来 “花里胡哨”（这里是褒义词 好看的意思）

[tanoak]

支持文件下载吗，post 请求

[star7th]

@tanoak

支持的。在 运行调试 按钮 的下载，有 运行并下载文件的。

[star7th]

@tanoak

支持的。在 运行调试 按钮 的下拉菜单，有 运行并下载文件的。

[iblessyou]

apipost apifox eoapi insomnia(post cat)
每看到一个类似新工具都会试试
想找一个轻巧离线的工具好难
postman 也渐渐膨胀了（物理）
然后依然用我的 7 版本的 postman
忍受着升级的小红点
最上川

[rekulas]

墙裂支持，runapi 确实不错一直在用
不过说实话我也倾向于做成 web 扩展的要方便很多（特别可以配合调试非常方便），客户端确实没那么方便
另外老版本有一些 bug 和不完善之处不知道修复没有，相对于 ui 来说，功能性更重要
请求失败、请求异常标识不是很明显
请求中标识不明显，有时候点击了然后没任何反应
有时候失误请求了大文件或 bin 会卡死，建议做点限制
偶尔会出现程序异常，无法发起请求，重启程序也不行，只能重启电脑（目前只遇到一次）

[star7th]

@rekulas

新版里，请求接口的时候， 响应卡 那里会出现个 loading

[rekulas]

刚测了下，上面的问题已经得到了优化
另外做 web 扩展貌似存在个问题，web 上因为权限的原因某些 header 似乎无法覆盖（即使是扩展级别），那就需要做成 wasm ，可能也没那么方便

[rekulas]

再提个建议
参见第二张图，参数部分和响应部分的底色跟背景色完全一致，辨识度不够高也不够美观建议做点区分
另外新版打开标签比老版本慢不少

[jin7]

支持测试 websocket 吗? @star7th

[star7th]

@rekulas

标签打开的机制不一样了。现在新建标签，是同步新建接口的。以前是异步新建接口的，会存在接口跟 tab 不一致的情况

[star7th]

@jin7

暂时不支持。后面看一下是否需求添加

[jin7]

@star7th 可以参考 apipost

[caqiko]

是 electron 吗？

[star7th]

@caqiko
是的

[userm]

生成的接口文档里面我看没有显示 Content-Type 不是太方便。

[guguji5]

一直在用 apifox

[star7th]

@userm

后面考虑加一下

[wyx119911]

一直用 Talend API Tester 浏览器插件，因为可以自动携带页面的 cookie ，不用自己手动导入。op 这个插件有什么好方法携带 cookie 吗

[star7th]

@wyx119911

runapi 的 cookie 是需要自己手动填写的。

[JustSong]

登录界面左边的 padding 是不是太大了啊

[star7th]

@JustSong

好像是我后来为了兼容小屏幕而调整了一点宽度。不过问题不大。

[fan123199]

可以 append 一下旧版的对比图，效果就出来了~ 我去看了下旧版的，确实有比较大的提升。不过离高颜值应该还有很多细节要优化

[ShuWei]

MacOS 试了下，op 绝对是对“颜值”有什么误解

[star7th]

@ShuWei 愿闻其详

[star7th]

@ShuWei

如果能用一个同类工具来类比一下 runapi 的 UI 缺陷在哪更好，我也蛮好奇

[ShuWei]

@star7th 哎呀，为了你这句话，我又重新装了一遍，其他就不说了，光这字体，就够看吐的

[star7th]

@ShuWei

字体倒没什么问题，是设计师推荐的圆润字体，我也觉得蛮好看的。就你截图而言，我感觉是我没设置好大小和图标，有点不统一。
但不论怎么说，这个字体绝对不丑。你如果坚持觉得丑，那没啥好讲了。

[ShuWei]

@star7th 你内心很强大，这么丑的字体，居然可以硬说不丑，实在不行，用系统默认字体吧，你们家这设计师可以开除了

[star7th]

@ShuWei

我更相信专业设计师的建议。因为人家有很多好看的设计作品。这是人家的风格，人家觉得对于这种 UI 风格的客户端，使用圆润字体更好看。如果你不是专业设计师，没有很多设计作品，我觉得还是需要敬畏一下专业人士的建议。同时，其他用户也没怎么反应过字体难看的问题。这套字体在设计师的多个客户端作品已经通过了市场验证。

[star7th]

@ShuWei

我觉得你可以有你独特的审美，你可以说你不习惯这种风格。但是我觉得你缺乏对 专业设计的尊重。人家这套风格已经经过多个作品的市场验证了的

[vitovan]

@ShuWei #43 我也觉得字体丑。

但是我更介意的是中英文之间没有空格（在 V2EX 发帖都会自动加上空格 /t/873359 ），而且：

- runapi 而不是 RunAPI
- markdown 而不是 Markdown

然而挑毛病谁都会，这套设计和实现还是很难得的。

[star7th]

@vitovan

这种菜单式的按钮，中英文间加空格就没必要了吧。对于正文，才比较合适。

另外对于字体，我再次跟设计师确认了。他的建议是，不用管个别的看法，如果按每个人的看法都改一遍，就没有自己的产品主见了。
如果说是很专业的建议，或者很多的用户反馈，才是值得斟酌的建议。

我自己是同意设计师的观念的。对于风格，你不能单纯拿个放大镜来找细节字体的问题，要看整体的呈现效果。大概率是设计师觉得这个字体在这种 UI 风格下的整体的呈现效果更好

[wqq096737ink]

开源吗？不开源的话更喜欢用公司成熟的产品。在工具上瞎折腾就是浪费时间

[star7th]

@wqq096737ink

客户端本身不开源，但可以离线使用。同时 服务端开源。 你如果搭建服务端在企业内网，配合离线的客户端，就可以免费私有部署使用。

[crazyweeds]

业余选手来评价了，你的主页面明显想走性冷淡风格，但是 tag 之类的颜色，太突兀了。。感觉是不是可以增加一个透明度试试看效果？

[sechi]

@star7th #47 纯路人，平心而论，这 UI 确实是有些问题。上面的字直接被截掉了一些。这个“添”字也有些和其他的字格格不入。

[sechi]

@crazyweeds 同意，标签的颜色太重了

[star7th]

@crazyweeds
@sechi

这个我感觉还好吧。因为整体是性冷谈风格，所以才需要一些色彩提一下色吧。不过这只是我的猜测，设计师本意是如何，我没去问。但是我觉得这个还好。

[star7th]

@sechi

被截取掉可能是一些高度设置值不对，我晚点看看。它不是字体本身的效果。

[vitovan]

@star7th #47 所以做设计比较难，高端大气上档次，每个人的口味又不一样。

辛苦设计师了。

[Bingchunmoli]

目前在用 eolinker ，感觉这个也是 web 套壳技术，例如 apifox 和 apipost 两个不是 dpi 适配有问题就是太卡

[star7th]

@Bingchunmoli

你可以试试 runapi ，比上一代性能优化很多，基本没听过用户反馈过新客户端卡。

[orclo]

我是设计师，我不喜欢换字体，尤其是这种多平台的产品，中文字体字体包都不小，用系统自带的效果其实都还行，工具类型的产品清晰直观就够了，每个系统字体都是经过亿万级别的检验，第三方字体不能够保证出现一些奇怪的基线或者缺失字体问题。

[star7th]

@orclo
你说的是有道理的。目前来看，反馈字体的用户也没特别多，主要是 v 站的几个对产品特别挑剔的人说的。而且这几个挑剔的人，大概率也不是 runapi 的用户。在 runapi 用户群里，反馈字体的还真很少，所以我觉得这个问题还是可以先忽略不计吧。
相比反馈字体类型，反馈字体大小的反而多一点。我现在在新版已经把字体设置大一点了。

[rekulas]

再反馈个网页端的 bug markdown 里面输入"，显示会变成中文例如“
另外之前还遇到一些字符不显示,不算非常怪异的字符比较普通的那种，不过忘了是哪些了
在其他正常的开闭源 markdown 编辑器里面显示是正常的

[star7th]

@rekulas

网页版 showdoc 的编辑器是几年前的一个开源编辑器，原作者已经停止维护了。我自己搞的是魔改版。后面看要不要换掉编辑器吧

[rekulas]

@star7th 原来如此，我一直以为你就是原作者