V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
marginleft
V2EX  ›  程序员

求一个 rest 风格 API 设计工具

  •  
  •   marginleft ·
    100apps · 2015-10-03 09:29:02 +08:00 · 9464 次点击
    这是一个创建于 3345 天前的主题,其中的信息可能已经有所发展或是发生改变。

    前端和后端用 rest 风格 API 通信,同时开工。我们自己手写了一些死数据假 API ,前端调用,后端实现。有没有现成的 API 设计工具?可以方便配置生成接口,这样前端用这个假接口开发,后端按照这个死数据去实现,最好接口测试也自动生成。

    12 条回复    2019-06-12 12:57:55 +08:00
    faceair
        1
    faceair  
       2015-10-03 09:32:27 +08:00
    sparanoid
        2
    sparanoid  
    MOD
       2015-10-03 09:37:20 +08:00 via iPhone   ❤️ 1
    TomDu
        3
    TomDu  
       2015-10-03 09:49:53 +08:00
    OData?
    onlyxuyang
        4
    onlyxuyang  
       2015-10-03 10:24:51 +08:00 via Android
    @sparanoid 这个看起来很厉害的样子 有时间研究研究
    xnotepad
        5
    xnotepad  
       2015-10-03 10:36:01 +08:00
    realityone
        6
    realityone  
       2015-10-03 12:22:15 +08:00 via iPhone
    apiray
    hantsy
        7
    hantsy  
       2015-10-03 13:27:37 +08:00
    @marginleft 基本上不可行。 SOAP 使用 Contract First 方式比较多,结果导致很多人不愿意用。这也是被 REST 替代的原因之一。

    Swagger 可以生成在线 REST API 测试( 2.0 方式也支持从 Contract First 方式先设计),我们一般都是如此,先后端开发,所以 API 都可以通过 Swagger UI 在线测试,你可以将 Swagger 中呈现的数据格式作为约定,供前端使用。

    敏捷的方式也不可能说数据格式完全在早期开始定下不变的。
    hantsy
        8
    hantsy  
       2015-10-03 13:29:30 +08:00
    我的例子都是通过 Swagger UI 来可视化 REST API ,也就是 Code First 方式。
    https://github.com/hantsy/angularjs-springmvc-sample
    https://github.com/hantsy/angularjs-springmvc-sample-boot
    hydyy
        9
    hydyy  
       2015-10-03 14:07:49 +08:00
    rap
    xujialiang
        10
    xujialiang  
       2015-10-03 14:13:48 +08:00
    http://jsonapi.xujialiang.net 我自己实现的。。。。就是为了生成假数据用.在后台还未开发接口时,我自己先行写服务。
    fhefh
        11
    fhefh  
       2015-10-03 17:44:50 +08:00
    mark ~~~ 3QS
    balabalaguguji
        12
    balabalaguguji  
       2019-06-12 12:57:55 +08:00
    有专门写 api 文档的工具,easydoc.xyz
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   2354 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 27ms · UTC 16:10 · PVG 00:10 · LAX 08:10 · JFK 11:10
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.