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

[送码] Mac 上超级好用的 API 文档生成工具送兑换码啦

  •  1
     
  •   whitecosm0s · 2020-12-03 14:30:56 +08:00 · 9497 次点击
    这是一个创建于 1240 天前的主题,其中的信息可能已经有所发展或是发生改变。

    RabiAPI 是我自己开发的一个 Java 项目 API 文档生成工具,通过源代码就可以直接生成和导出 API 文档。

    目前售价 60 元 /个,通过兑换码可以免费领取。

    详细介绍和下载地址

    或者在 Mac App Store 中直接兑换

    支持的框架和接口写法

    1. 原生 Java Interface 接口和 Javadoc,所有直接使用 interface 作为接口的 RPC 服务
    2. 使用 @RestController 注解的 Spring MVC 服务
    3. 使用 @Path 注解的 Jax-RS 服务
    4. 使用 @Api 和 @ApiOperation 注解的 Swagger 服务
    5. 使用 @Operation 注解的 OpenAPI 服务

    支持的导出格式

    1. Markdown
    2. Asciidoc
    3. Swagger Json 格式(仅支持 HTTP 接口,仅支持批量导出)
    4. OpenAPI Json 格式(仅支持 HTTP 接口,仅支持批量导出)
    5. 图片格式,把当前接口文档页面导出为 PNG 图片(仅支持单个接口)

    APP 和文档生成效果预览

    Imgur

    Imgur

    img

    img

    正在开发中的接口调试功能

    img

    兑换码 50 个

    • LYYER39MKTNJ
    • EY3PHYX4KKTX
    • EAJX4F797PT4
    • 476447LKFE9Y
    • LPT4YPN6MKAM
    • Y9HAFEK3YTP3
    • J4LRYP6E4H76
    • WEYMF3PHYR37
    • 4RJ393NX74NX
    • 4TL9K4JMKMMA
    • ANAW44RN67M3
    • 79FYWW966TET
    • PW4HWKW3XYJ6
    • YWFKKYKW43Y3
    • EJT7NA7RMA6Y
    • LKJFFE379AYW
    • PXJL4AT6KYNE
    • EJY4YR4F7H4T
    • PF39TPRY4LYP
    • NMP7YH9WPMW6
    • RNPWP4NJRNM6
    • 3RJ3YFN643N7
    • N9ATEEAW6E9P
    • A9TAXXW6X4K4
    • XHYRLW9K7LKT
    • J77FJ3AYYLM6
    • 3JY39KTNA4PM
    • WME3F44LJMEK
    • XJP3KWK7EWFP
    • 777EFWP3E64P
    • FAKTKLAMMHH6
    • 3JHRJHEXMAL6
    • 94XK74KXAARW
    • MNEF9YAHTR49
    • 4H4ELKLEPXTA
    • 74XKKJLHHYRX
    • 9HPJ96N33WJ9
    • FWE79TE796TF
    • LFYHWJYXXWRN
    • WXWKMKT7FR6L
    • NEHHR6KE93JY
    • F9WRM7LTNMAP
    • FKW6TTJPYNLH
    • W3RTJT7FPAM3
    • N9K7HWXM7TPT
    • 67KP39LJLE4A
    • N3PYJ36KXTTJ
    • FKARMFM4PRKW
    • RKEWY4HYN3HW
    • LTYA4HJRN94A

    另外有功能上的建议或需求可以加 QQ 交流群 244365684

    已经兑换了的用户请在评论中回复一下,谢谢

    第 1 条附言  ·  2020-12-03 15:54:35 +08:00
    不方便加群的话也可以直接在 https://github.com/RabiAPI/RabiAPI-Support 的 issue 里面反馈问题
    第 2 条附言  ·  2020-12-03 17:01:47 +08:00
    第二批兑换码~

    XFNJNHKNYPJK
    P4H46LLL34H9
    HHP96ENYRYAM
    KM7MA4HTR4XK
    JMAEJWNXYFJR
    JMPK7469HE7N
    3XRTMHR3WFPW
    WRE3LR43PA64
    YRLTEJJA7J9H
    KFX7E7TL7FN4
    XKJXR6EWAP9E
    YYJ9MNENTNRY
    EJ3LN43PRYKF
    WTXE9YYX3TAH
    YTEAJFKFRHLY
    WR34JATNR73E
    FLLLMWT6FFXP
    XH9LKYLK3NHF
    M6N7YL6YWKJM
    HN9T7ELKMAKL
    76RA3F69JEHJ
    697LAETEE6RL
    MY69AFL346XT
    PPHAFJFKMTK7
    MJLELJY7A99T
    7T43X4TR7M44
    HLY4WT6PKNER
    PAYJ49364AKR
    T9LE4R3X3JLA
    7HTY43KHEMWX
    FXAJWF6H3XHW
    TFTXWLJAN44M
    TMJFE34FP43T
    4RHN73FTHFW6
    EMFFAXAFLHXL
    A9JAPP3NM7NF
    3NPLPKK76ERE
    YNFNRE9XT9XX
    4KH7YFJXAR6P
    MM47JFM6YHXA
    第 3 条附言  ·  2020-12-09 09:01:30 +08:00
    各位久等了,RabiAPI 今天发布了 1.2.3 版本更新,修复包括

    1. Git 无法正常使用的问题,更新应用后请在分支选择栏中点击『授权访问』 并同意
    2. 泛型嵌套递归写法导致的项目导入出错问题
    3. 增加了对于 Spring @ModelAttribute 注解的支持,标注为 FORM 类型参数
    4. 修复导出为图片时没有完整截取的问题
    5. 增大 JVM 堆内存,修复项目过大导致的内存溢出问题(可能)

    新的产品支持页面以放到 https://gitee.com/RabiAPI/RabiAPISupport 国内可以快速访问,喜欢的朋友可以评论,点赞,收藏。

    没有抢到兑换码的朋友可以先加入 QQ 群 244365684,群内会不定期发放产品兑换码。

    50 个产品兑换码

    N4MJT6EW66HP
    KXYA6YM7KMA3
    EK3K77EMWAMY
    TWA4NH77N73L
    YRYXTYTNLA6M
    RPEXW7J3WMMK
    69YRTXPLFMFJ
    33KFP6M4K9XK
    7HN6HTHM933N
    6H7FE3WEN7WN
    RAF4W9KWYTHL
    9A4NLEHWNJAE
    LMTNRTXHLWX3
    4FLM7TNTATHJ
    XK66X3JH6J66
    FPTEKX7PK7F3
    EFNTYJKA7HNJ
    WPTA4LJT6LFE
    FT4E3PJ43N4X
    96EMMHL64EY9
    6PP3XTMFL4PW
    MW4PJF3EJKYR
    NFMF6X64KNMM
    YNMET4LYP69W
    XEAM67Y6R7PJ
    L7TJA7LFFYYT
    RTPHEXLEAH3N
    7XL3KFEAM6AM
    LTEN3K64JPYJ
    HL7EEME4KMPH
    KW9PXHFL3R7R
    XKLPHHHJM6RT
    RXMLME3TRKE7
    6KPNPYW7XYXE
    EMXMMX4K3XEM
    63NTRWP3RRPM
    WKYLYL4TL97J
    634Y3WEYWT4W
    L3YN9JP4TN6W
    TNR7M6Y9XW97
    J7347M4A6YK6
    YHTT3PPYMP46
    YRWEWX6RW73E
    EMJ77RH7NEKW
    PATHNM4YNKTM
    ENXXFTTMYM7W
    37XMP3PLXA9K
    3HEHJPFWEJ9X
    HW6LHELFW7JF
    96Y7T96KJ63H
    第 4 条附言  ·  2020-12-11 18:24:05 +08:00
    第四批兑换码~

    LWWTXLR43TME
    4HHRTHA6T93K
    RYYYYRP649N4
    X6XAF9W7P63M
    KLH4PFEMH6FR
    EL6F93N4YFA7
    AFMMAMJJPXLF
    MHT94XX3HPKE
    WRLKJ4J9664R
    JNW9KWJ4YJKL
    EHANPF4AKYJK
    4E6RJF43XHN4
    7N3LXRK993WX
    9PPAYMJRWLEK
    AATNAAJEWE66
    Y4LJFRANJLJR
    LJXJ46NTE3X7
    XTTE93PT496R
    P9J9JJJJAAYA
    E6T63Y9NXTR4
    PA3TR4JPJRNW
    LFRL3X9A37NJ
    WTXWMMM9MJTW
    LP36K46MHF9M
    6RF79XRT3TYK
    AAJHYERY7YJL
    TWFAKWHFJRR3
    JJX3NFW4JLYM
    4YH9RPFWML3X
    XKXRHJXLJWKA
    NF9FTXXFHLRL
    HM37TMAL7LWP
    RPNA3RA3TK36
    4HKL4YT3HY6A
    AYPM4RR34XFF
    ARJEKX3AT47P
    LLMFK9AFKEPJ
    NAF6J4RWL3A9
    4RK7ELFWWRK4
    KKK77RYA3JXF
    148 条回复    2020-12-20 16:19:09 +08:00
    1  2  
    whitecosm0s
        101
    whitecosm0s  
    OP
       2020-12-09 09:19:21 +08:00
    @ggmood 第三批兑换码已发放
    whitecosm0s
        102
    whitecosm0s  
    OP
       2020-12-09 09:19:42 +08:00
    @MonsterTan 第三批兑换码已发放
    Fizzyi
        103
    Fizzyi  
       2020-12-09 09:31:29 +08:00
    第三批 37XMP3PLXA9K 已用 感谢
    jwautumn
        104
    jwautumn  
       2020-12-09 09:35:13 +08:00
    我特喵的迷迷糊糊的按照顺序进行了购买支付。。。现在正在请求退款中。。。
    deepmindlab
        105
    deepmindlab  
       2020-12-09 09:47:58 +08:00
    @whitecosm0s 谢了 已兑换
    Junn
        106
    Junn  
       2020-12-09 09:52:29 +08:00
    第三批 YRWEWX6RW73E 已使用,感谢~
    deepmindlab
        107
    deepmindlab  
       2020-12-09 10:04:21 +08:00
    @deepmindlab HW6LHELFW7JF 已使用
    whitecosm0s
        108
    whitecosm0s  
    OP
       2020-12-09 10:16:51 +08:00
    @chenlee9876 第三批兑换码已发放
    whitecosm0s
        109
    whitecosm0s  
    OP
       2020-12-09 10:17:35 +08:00
    @queuey 第三批兑换码已发放
    whitecosm0s
        110
    whitecosm0s  
    OP
       2020-12-09 10:18:00 +08:00
    @houzhi 第三批兑换码已发放
    keventseng
        111
    keventseng  
       2020-12-09 13:58:30 +08:00
    XEAM67Y6R7PJ 已用,谢谢~
    outtime
        112
    outtime  
       2020-12-09 15:14:12 +08:00
    ENXXFTTMYM7W 已用~非常感谢
    darrenfang
        113
    darrenfang  
       2020-12-09 17:00:47 +08:00
    YNMET4LYP69W 已用,谢谢!
    houzhi
        114
    houzhi  
       2020-12-09 17:04:48 +08:00
    L7TJA7LFFYYT 已用,感谢
    queuey
        115
    queuey  
       2020-12-09 17:05:08 +08:00
    果然喜欢先用后面的,第一个刚用。N4MJT6EW66HP
    morize
        116
    morize  
       2020-12-09 17:21:45 +08:00
    EK3K77EMWAMY 第三个已用,感谢~
    kinXdle
        117
    kinXdle  
       2020-12-09 21:57:25 +08:00
    XKLPHHHJM6RT
    Recour
        118
    Recour  
       2020-12-09 23:24:02 +08:00
    7XL3KFEAM6AM 已用,感谢。
    jhzhang09
        119
    jhzhang09  
       2020-12-09 23:43:14 +08:00
    J7347M4A6YK6 已使用,谢谢
    thinkdiff
        120
    thinkdiff  
       2020-12-10 10:40:17 +08:00
    HL7EEME4KMPH 已用,谢谢!
    Echoleung
        121
    Echoleung  
       2020-12-10 10:54:10 +08:00
    TNR7M6Y9XW97 已用,感谢
    icount
        122
    icount  
       2020-12-10 12:32:50 +08:00
    KXYA6YM7KMA3 append3 第二个已用,多想
    icount
        123
    icount  
       2020-12-10 12:41:20 +08:00
    多谢
    Tenderness
        124
    Tenderness  
       2020-12-10 13:27:38 +08:00
    TWA4NH77N73L append3 第四个已用 感谢
    log4j
        125
    log4j  
       2020-12-10 14:34:43 +08:00
    6KPNPYW7XYXE 已用 感谢
    Pore
        126
    Pore  
       2020-12-10 15:15:43 +08:00
    以用 RXMLME3TRKE7,谢谢!
    TaiShang
        127
    TaiShang  
       2020-12-10 17:12:34 +08:00
    已用 634Y3WEYWT4W 感谢
    zirawell
        128
    zirawell  
       2020-12-10 18:17:27 +08:00
    YRYXTYTNLA6M 已用,谢谢!
    GarethChu
        129
    GarethChu  
       2020-12-10 22:59:36 +08:00
    EMJ77RH7NEKW 已用,非常感谢!
    red2dog
        130
    red2dog  
       2020-12-11 09:50:54 +08:00
    WPTA4LJT6LFE 已用 感谢楼主
    wlf92
        131
    wlf92  
       2020-12-11 14:14:56 +08:00
    LTEN3K64JPYJ thanks
    loyfo
        132
    loyfo  
       2020-12-11 14:44:05 +08:00
    63NTRWP3RRPM 已用,感谢楼主
    Youko
        133
    Youko  
       2020-12-11 17:30:47 +08:00
    L3YN9JP4TN6W 已用,感谢,先去试试
    xuyihan5150
        134
    xuyihan5150  
       2020-12-11 18:31:18 +08:00
    LLMFK9AFKEPJ 已用,感谢楼主
    guyeu
        135
    guyeu  
       2020-12-12 16:44:18 +08:00
    第三批 LFRL3X9A37NJ 已用,🙏🏻️
    OpenSSH
        136
    OpenSSH  
       2020-12-13 11:50:31 +08:00
    第四批 HM37TMAL7LWP 已用,谢谢 LZ
    Elietio
        137
    Elietio  
       2020-12-13 12:55:49 +08:00
    第四批 4YH9RPFWML3X 已用,多谢
    cpaig
        138
    cpaig  
       2020-12-13 21:59:40 +08:00
    ARJEKX3AT47P 已经使用,感谢🙏
    yanyumihuang
        139
    yanyumihuang  
       2020-12-14 08:34:43 +08:00
    4RK7ELFWWRK4 已用,感谢
    LabanYB
        140
    LabanYB  
       2020-12-14 09:32:31 +08:00
    第四批 WTXWMMM9MJTW 已用,感谢
    easymbol
        141
    easymbol  
       2020-12-14 16:30:16 +08:00
    LWWTXLR43TME 已用
    LennonChin
        142
    LennonChin  
       2020-12-14 18:06:18 +08:00
    感谢,第四批 KLH4PFEMH6FR 已用
    hackpro
        143
    hackpro  
       2020-12-15 17:26:14 +08:00
    啥时候 C++或者 Python 也来一波😄
    whitecosm0s
        144
    whitecosm0s  
    OP
       2020-12-15 18:00:22 +08:00
    @hackpro 国内 Java 用的人多
    AsianChampion
        145
    AsianChampion  
       2020-12-17 15:33:34 +08:00
    使用了一下, 发现 2 个问题:
    1.UI 排版有问题. 在 MBP 13 寸屏幕上, APP 不能缩放大小, 最小显示时只能显示到按钮 "Markd" 这一纵向位置,右边的就显示不出来了, 往左拖动 APP 才会显示右边位置. "回到顶部"按钮也显示不出来. 这 2 个问题在 24 寸外接屏幕上都没有.
    2.我们项目里面有个基础父类 Controller, 然后每个类里面把 公共父类的方法也显示出来了, 这些方法的"请求参数" 和 "返回响应" 都是空的. 我觉得应该把这些方法排除.

    建议:
    导出的数据支持导入 postman,paw 这些工具, 要不然跟 swagger 定位重复了
    whitecosm0s
        146
    whitecosm0s  
    OP
       2020-12-17 16:39:43 +08:00
    @AsianChampion 1. UI 我暂时只考虑了 15 寸和 1080P 这些分辨率,因为公司基本都会配备另外的显示器,就没有测试小屏幕适配,后面会修复这个问题。
    2. 继承这个逻辑是这样的,如果一个 Spring Controller 继承了另一个 Base Controller,那么会把 Base Controller 中的接口合并过去,Base Controller 中存在泛型的话,会填充为实际类型,不知这样的逻辑是否正确?
    3. 导出数据是因为 Postman, Paw 本身就支持 Swagger 2.0 文件的导入,前期暂时没有直接提供,后面会考虑的。
    lixuanyy
        147
    lixuanyy  
       2020-12-17 20:42:10 +08:00
    第四批:**9PPAYMJRWLEK**
    感谢楼主大人
    mobyride
        148
    mobyride  
       2020-12-20 16:19:09 +08:00
    第四批:JJX3NFW4JLYM
    1  2  
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   我们的愿景   ·   实用小工具   ·   2978 人在线   最高记录 6543   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 48ms · UTC 13:34 · PVG 21:34 · LAX 06:34 · JFK 09:34
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.