• 请不要在回答技术问题时复制粘贴 AI 生成的内容
dingyaguang117
V2EX  ›  程序员

有使用 Stoplight 做文档管理的团队吗

  •  
  •   dingyaguang117 ·
    dingyaguang117 · Jan 2, 2022 · 1386 views
    This topic created in 1664 days ago, the information mentioned may be changed or developed.

    准备尝试下 Stoplight ,在初步接触中发现几个问题:

    1. OpenAPI 没有接口目录概念,只有按照 Tag 进行分组。对于复杂项目,原来可能会有二级目录,现在就不太方便迁移。

    2. 编辑器左侧是 Paths(URL)聚合的, 而渲染出来是按照 Method+URL 分开。这个我理解是局限于 OpenAPI 的数据结构定义。但是这样对于编辑和渲染会产生一种不太一致的展示表现,不方便查找。

    不知道大家有没有相同的困惑,是如何解决的呢?另外也有老项目很多接口设计不是那么 Restful 的缘故

    No Comments Yet
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Solana   ·   2660 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 30ms · UTC 14:55 · PVG 22:55 · LAX 07:55 · JFK 10:55
    ♥ Do have faith in what you're doing.