V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
爱意满满的作品展示区。
star7th
V2EX  ›  分享创造

可能是国内颜值很低很低很低很低很低的接口调试工具

  •  
  •   star7th · 2023-06-30 09:09:49 +08:00 · 3936 次点击
    这是一个创建于 545 天前的主题,其中的信息可能已经有所发展或是发生改变。

    前言

    标题中提到的“颜值低”是因为在之前的帖子( https://www.v2ex.com/t/952265?p=3 )中,我对自己的产品的颜值过于自信,结果被很多人吐槽。所以这次我想委婉一些,降低颜值期望。

    发帖的主要原因是,我发现很多用户并不知道 showdoc 实际上还有一个独立的客户端工具 runapi ,我想专门开一个帖子分享一下。

    尤其是当我听到一些老用户说他们觉得 showdoc 没有调试接口的功能而放弃使用时,我觉得非常可惜。因为和“一开始就放弃 showdoc”的用户不同,那些想要调试接口的老用户其实并不难争取到。最令人遗憾的不是一开始就放弃,而是错过了本可以做到的。

    我想可能是我的宣传不够到位,产品引导不够好,文章宣传也不够,导致很多人不知道可以使用 runapi 来调试接口,并且自动生成文档到 showdoc 。

    产品思考

    postman 可以说是接口调试工具的鼻祖和天花板了。目前大部分后端程序员都知道 postman ,这为 runapi 的市场教育做了铺垫,我不需要太仔细介绍 runapi 的功能,就说它是类似 postman 的接口调试工具就可以了。 runapi 跟其他竞品(如 postman 、apifox 、apipost 等)最大的不同之处在于它与 showdoc 的联动。在调试完接口后,runapi 可以直接将生成的文档上传到 showdoc 中。对于后端程序员来说,这非常方便——只需要开发完接口,上传到测试环境,然后将生成的 showdoc 接口文档直接分享给前端对接人员即可。 这两个工具分别解决了接口调试和 IT 团队文档的场景,协同效率非常高。许多 showdoc 用户都非常喜欢这一点。 但这也客观上限制了 runapi 的使用范围,它基本上只在 showdoc 用户群体中使用,好像只是 showdoc 的一个辅助工具,而不像 postman 等独立运作的品牌。我不确定是否要将 runapi 独立运营,但就目前而言,似乎还无法摆脱 showdoc 。所以在宣传 runapi 时,往往会同时宣传 showdoc 。

    官方介绍

    下面就贴一份比较官方口吻的宣传文吧。

    runapi 是一个以接口为核心的开发测试工具(功能上类似 postman ), 包含接口测试/自动流程测试/Mock 数据/项目协作等功能。

    它和 showdoc( https://www.showdoc.com.cn/help )相辅相成:showdoc 以文档为核心,侧重文档编写和知识资料沉淀。而 runapi 则以接口为核心,包含接口测试、管理、Mock 数据、自动化流程测试等一系列功能。同时它将自动生成文档到 showdoc ,无须再手动编写文档,释放生产力;共用 showdoc 的团队管理机制,很好地实现接口的自动化和多人协作。相信使用 showdoc + runapi 这两个工具组合,能够极大地提高 IT 团队的效率。

    下载地址:

    https://www.showdoc.com.cn/runapi

    截图

    第 1 条附言  ·  2023-06-30 09:48:28 +08:00
    因为 V 站没有删除帖子的功能,所以这个帖子我设置了下沉。然后换个标题了再发。

    我不理解为什么还有新用户看到此帖子
    update
        1
    update  
       2023-06-30 09:21:20 +08:00   ❤️ 3
    真没劲
    randm
        2
    randm  
       2023-06-30 09:22:42 +08:00
    这是找到密码了吧。自吹刷一波,再自贬刷一波。
    allenzhangSB
        3
    allenzhangSB  
       2023-06-30 09:25:25 +08:00
    没完了是吧
    star7th
        4
    star7th  
    OP
       2023-06-30 09:26:42 +08:00
    @randm

    标题什么的,是有点想吸引关注的意思。
    我这个帖子也是在好好分享产品以及对产品的思考吧,就内容而言,还是很符合 分享创造 的主题的
    jixule
        5
    jixule  
       2023-06-30 09:31:43 +08:00
    第一句话就让人不想看下去
    seeyourface
        6
    seeyourface  
       2023-06-30 09:34:03 +08:00
    太长不看
    mohulai
        7
    mohulai  
       2023-06-30 09:34:12 +08:00   ❤️ 2
    怎么老是你,我以为是有人看了你的贴子所以弄个新帖唱反调,点进来索然无味
    star7th
        8
    star7th  
    OP
       2023-06-30 09:34:25 +08:00
    @allenzhangSB @jixule @randm @update

    行吧,你们既然看不惯那我就先 下沉 本帖子了。趁着还没人关注,我换标题再发
    ttwxdly
        9
    ttwxdly  
       2023-06-30 09:35:13 +08:00
    还是习惯用 postman
    star7th
        10
    star7th  
    OP
       2023-06-30 09:35:25 +08:00
    @seeyourface
    @mohulai

    我就先 下沉 本帖子了,趁着还没人关注,我换标题再发,就中规中规的 标题
    star7th
        11
    star7th  
    OP
       2023-06-30 09:37:20 +08:00
    我才发现 v 站要半个小时后才能发第二篇帖子,哎
    mohulai
        12
    mohulai  
       2023-06-30 09:40:40 +08:00   ❤️ 1
    @star7th 也许本来东西还行,但是被你两次发帖败光路人缘了,有点可惜,又有点自作自受。
    yatoooon
        13
    yatoooon  
       2023-06-30 09:41:40 +08:00
    这样的人开发出来的东西,真让人感到不舒服......
    star7th
        14
    star7th  
    OP
       2023-06-30 09:42:09 +08:00
    @yatoooon

    我不是下沉本帖子了吗,为什么你还能看到的
    wushigejiajia01
        15
    wushigejiajia01  
       2023-06-30 09:43:46 +08:00
    V 站 我发现个有意思的现象,
    来发推广的,
    如果就正常普通推荐的,大多无人问津(当然如果非常有亮点的另说)
    如果标题就开始搞事的,那大伙儿一点都不客气,会搞的推荐人要么不回贴了,要么就是激情对线了

    哈哈
    star7th
        16
    star7th  
    OP
       2023-06-30 09:45:29 +08:00
    @wushigejiajia01

    我不是下沉帖子了吗,为啥还能被人能看到。我不理解啊
    oneKnow
        17
    oneKnow  
       2023-06-30 09:46:38 +08:00
    你小子是真油盐不进啊,下次标题可以取“可能是国内情商最低的接口调试工具”
    wushigejiajia01
        18
    wushigejiajia01  
       2023-06-30 09:46:46 +08:00
    @star7th 没用过这个功能,不是很清楚
    star7th
        19
    star7th  
    OP
       2023-06-30 09:53:25 +08:00
    @oneKnow

    我设置了下沉帖子了的!打算换个标题再发,我不知道为啥还会出现在时间线。
    kuaner
        20
    kuaner  
       2023-06-30 09:56:49 +08:00   ❤️ 1
    showdoc 的老用户了,不知道评论区为什么这么大的恶意
    star7th
        21
    star7th  
    OP
       2023-06-30 09:59:50 +08:00
    @kuaner

    谢谢支持。

    那些恶意大的人,不会成为 showdoc 用户的。

    但我确实担心他们乱带节奏,把节奏带歪了。所以我下沉本帖子了。

    能看到应该是缓存,应该晚点就消失在时间线了。
    Pipecraft
        22
    Pipecraft  
       2023-06-30 10:02:12 +08:00
    @kuaner #20 大家都讨厌标题党
    c2const
        23
    c2const  
       2023-06-30 10:07:58 +08:00
    不好用
    fregie
        24
    fregie  
       2023-06-30 10:08:11 +08:00
    本来以为你是谦虚一下,没想到真这么难看,哈哈哈
    cat9life
        25
    cat9life  
       2023-06-30 10:09:50 +08:00   ❤️ 8
    我推荐几个标题给 OP 😀

    震惊! showdoc 中原来还暗藏着这个神器
    国货之光,比 postman 牛 10 万倍的工具
    颜值忽高忽低的开源文档搭配这个工具,马斯克直呼内行
    divilbs
        26
    divilbs  
       2023-06-30 10:12:22 +08:00
    @cat9life 笑死
    huanruiz
        27
    huanruiz  
       2023-06-30 10:16:13 +08:00
    挺好的, 网友恶意太深了
    28Sv0ngQfIE7Yloe
        28
    28Sv0ngQfIE7Yloe  
       2023-06-30 10:33:21 +08:00
    起名“我觉得我做的还可以的 xxxx”
    star7th
        29
    star7th  
    OP
       2023-06-30 10:40:03 +08:00
    @cat9life

    这标题把我逗笑了。不过还真不敢用。
    star7th
        30
    star7th  
    OP
       2023-06-30 10:41:05 +08:00
    @huanruiz

    谢谢支持。
    这个帖子应该会慢慢沉底了。确实不想收到那么多恶意。
    Arguments
        31
    Arguments  
       2023-06-30 10:53:43 +08:00 via iPhone
    刷到两次了🤦‍♂️,真的是,好好起个标题那么难吗?要不就是颜值最高,要不就是颜值很低,好好起个标题介绍一下自己的软件,如果真的好用,大家也会用下去帮你宣传,怎么上来就是标题党,真的没心情看下去
    shayebushi
        32
    shayebushi  
       2023-06-30 10:55:30 +08:00 via Android
    打眼一看,还以为是 notion
    star7th
        33
    star7th  
    OP
       2023-06-30 10:55:53 +08:00
    @Arguments

    你在看一下评论,我已经把帖子 下沉了 。然后,我也试图 好好起个标题 https://www.v2ex.com/t/952896 这都有人吐槽。干脆移动到无人问津的推广贴,然后不发了
    zzzzhan
        34
    zzzzhan  
       2023-06-30 11:08:11 +08:00
    @star7th #33 别人明明吐槽的是你没完没了的发帖,而不是你新帖的标题
    well775397252
        35
    well775397252  
       2023-06-30 11:14:49 +08:00
    没完了是吧
    star7th
        36
    star7th  
    OP
       2023-06-30 11:17:32 +08:00
    @zzzzhan

    我不知道别人吐槽的是这个点。我以为设置下沉就是沉到底了,在时间线看不到了。
    star7th
        37
    star7th  
    OP
       2023-06-30 11:18:13 +08:00
    @well775397252

    你看一下评论,我已经把帖子 下沉 了 。
    pan020037
        38
    pan020037  
       2023-06-30 11:26:23 +08:00
    你不回复帖子,自然就下沉了,一直回复就会顶上去
    BwNVlwSq
        39
    BwNVlwSq  
       2023-06-30 11:42:46 +08:00
    真的挺丑的,能不能请个人好好设计一下呢?
    Ashore
        40
    Ashore  
       2023-06-30 12:00:39 +08:00
    现在在最热里面还能看到你的贴子
    phpdever
        41
    phpdever  
       2023-06-30 12:03:30 +08:00
    第一次看到这个产品。我不知道产品亮点是什么?标题是想突出产品亮点颜值低,从而吸引用户使用吗?

    但你这个产品也不是刚需。如果是刚需,就像 91 xx 一样,即使满屏幕都是广告,颜值非常低,也有大量的日活。

    所以我依然会选择使用 postman 。
    felmoon
        42
    felmoon  
       2023-06-30 14:38:50 +08:00
    产品我在用 但是 OP 有点存在感太强了
    littleBink
        43
    littleBink  
       2023-06-30 15:37:39 +08:00
    @star7th #16 都上热门咯
    littleBink
        44
    littleBink  
       2023-06-30 15:39:23 +08:00
    你这个标题不可能收到好的回复,一看就是前几天被骂了在阴阳怪气
    456789
        45
    456789  
       2023-06-30 15:55:16 +08:00
    尤老板翻版?
    xqiang
        46
    xqiang  
       2023-06-30 16:41:39 +08:00
    试用了下,提个小需求,导出的时候,能导出一个单页面的 word 文档,为什么 markdown 却是导出一个压缩包。能否支持一下导出一个单页面的 markdown
    star7th
        47
    star7th  
    OP
       2023-06-30 16:49:12 +08:00
    @xqiang

    之前是觉得这个需求很少。因为交给人查看(比如说合作方公司),用 word 更合适。很少直接交付 MD 文件。需要导出 MD 文件的场景,很多都是用户自己打算用其他工具二次编辑或者查看的。这种动手能力强的用户,进 showdoc 编辑框复制一下文本过去应该就好。如果做导出单页 MD 的话,也不是不能看,是我不知道这个需求如何。下次考虑加上去吧。
    star7th
        48
    star7th  
    OP
       2023-06-30 16:52:28 +08:00
    @phpdever

    个人使用跟团队使用是不一样场景的。runapi 和 showdoc 基本都是为团队考虑。因为它方便团队权限管理分配,多人编辑。个人使用 postman 是不错,但是团队的话,首先它收费,其次国际网络不好。所以国内小团队的市场对免费的国内类似工具还是有需求的。
    xqiang
        49
    xqiang  
       2023-07-03 12:41:37 +08:00
    @star7th #47 这个取决于不同的合作方吧,有些客户还是要 MD 格式的。而且毕竟 word 是二进制文件,不好维护在代码仓库里
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   4512 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 30ms · UTC 10:06 · PVG 18:06 · LAX 02:06 · JFK 05:06
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.