whileFalse
V2EX  ›  问与答

求推荐个简单的 API 接口文档设计工具, Swagger 太特么复杂了

  •  
  •   whileFalse · Feb 18, 2018 · 7053 views
    This topic created in 3010 days ago, the information mentioned may be changed or developed.

    只要能用纯文本存储就好了。放 git 里面自己看的。

    Supplement 1  ·  Feb 18, 2018
    找到一个办法,用 paw 做可视化的设计,然后可以导出 swagger 格式的 json 文件。
    9 replies    2019-12-03 17:43:31 +08:00
    TangMonk
        1
    TangMonk  
       Feb 18, 2018 via Android   ❤️ 1
    就直接 markdown 呗
    Cbdy
        2
    Cbdy  
       Feb 18, 2018 via Android   ❤️ 1
    blueprint
    derek80
        3
    derek80  
       Feb 18, 2018 via Android   ❤️ 1
    swagger 还好啊,我们用 aws API gateway 可以直接导入,配合 terraform 好用的不要不要的。
    wintercoder
        4
    wintercoder  
       Feb 18, 2018   ❤️ 1
    apidoc 就在代码里写注释就好了
    whileFalse
        5
    whileFalse  
    OP
       Feb 18, 2018
    @TangMonk 一开始用 markdown,稍微多写点说明就感觉很乱。
    @derek80 那你们怎么写呢?手写吗?
    @wintercoder 是个办法,不过我想先写 API 文档,设计好了再写代码。
    derek80
        6
    derek80  
       Feb 18, 2018 via Android
    我们用 vscode 直接写。
    WilliamLin
        7
    WilliamLin  
       Feb 18, 2018 via Android
    apizza,用起来简单点
    funing
        8
    funing  
       Aug 29, 2019
    apizza api 接口管理挺简单的
    balabalaguguji
        9
    balabalaguguji  
       Dec 3, 2019
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Solana   ·   3021 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 62ms · UTC 08:02 · PVG 16:02 · LAX 01:02 · JFK 04:02
    ♥ Do have faith in what you're doing.