求一个 rest 风格 API 设计工具

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

faceair

2015-10-03 09:32:27 +08:00

https://github.com/typicode/json-server

sparanoid

2015-10-03 09:37:20 +08:00

http://swagger.io

TomDu

2015-10-03 09:49:53 +08:00

OData?

onlyxuyang

2015-10-03 10:24:51 +08:00

@sparanoid 这个看起来很厉害的样子有时间研究研究

xnotepad

2015-10-03 10:36:01 +08:00

https://github.com/caixw/apidoc

realityone

2015-10-03 12:22:15 +08:00

apiray

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

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

2015-10-03 14:07:49 +08:00

rap

xujialiang

2015-10-03 14:13:48 +08:00

http://jsonapi.xujialiang.net 我自己实现的。。。。就是为了生成假数据用.在后台还未开发接口时，我自己先行写服务。

fhefh

2015-10-03 17:44:50 +08:00

mark ~~~ 3QS

balabalaguguji

2019-06-12 12:57:55 +08:00

有专门写 api 文档的工具，easydoc.xyz

这是一个专为移动设备优化的页面（即为了让你能够在 Google 搜索结果里秒开这个页面），如果你希望参与 V2EX 社区的讨论，你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://tanronggui.xyz/t/225345

V2EX 是创意工作者们的社区，是一个分享自己正在做的有趣事物、交流想法，可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.