@baoshu 是不是跟区域有关啊，我是挂在华东区域的

@dcalsky 没有啊，奇了怪了

@zdnyp 好像是这么个意思

紧急提示，我把项目地址更新为：

https://gitee.com/run27017/directed-proxy

定向代理，该命名更符合情境和定位。

最开始我是直接返回数据对象的，如返回单个 user：

```json
{
"name": "Jim",
"age": 18,
...
}
```

返回 user 集合：

```json
[
{ // user 1 },
{ // user 2 },
....
]
```

后来需要返回集合的时候附上一个`total`字段，用于指导客户端的翻页。没办法我只能将集合资源的返回改为：

```json
{
"users": [
....
],
"total": 163
}
```

前端做了很大的改动来适应这里的变化。

这时集合资源成为包装的了，而单个资源没有包装。这样我认为不一致，所以我让单个资源也成为包装的了：

```json
{
"user": {
...
}
}
```

最后，为了统一性，我将请求值也变为包装的了：

```bash
curl -XPUT /user -d '
{
"user": {
...
}
}'
```

所以，如果你认为 API 是否应该对结果包装一层，我的答案始终是：**要**. 而且，不仅仅是返回值，我对请求都会主动地包装一层。

包装对于之后的扩展带来很大的便利。试想一下，如果我一开始就选择包装的方案，那么当我要加入`total`这个字段的时候，影响就很小。

我这里的包装，可能跟楼主说的不是一个意思。对于`{ "code": 200, "message": "", "data": xxx }`这样的格式，我不是太理解。如果接口返回错误，我的格式一般都统一成：

```json
{
"code": "一个字符串代表的错误码"
"message": "错误信息",
"details": {
// 可能用一个对象给出详细的错误描述
}
}
```

这里注意的是，`code`值最好用简短的字符串，而不是数字，更有语义性。

顺便夹带点私货，是我之前写的有关 API 设计的：[聊聊 Web 接口设计和接口行为 ]( https://ruby-china.org/topics/39115)。

@hadixlin 嗯，其实我也一直推崇代码即文档，但一直没有找到适合的方案。

你现在在做的东西是什么？是要造一个轮子吗？我看是 Spring 上的，我本人并不用 Spring.

@hadixlin 模拟 swaggerhub 的，私人文档，支持团队协同。

注册只用输入用户名密码就好了，都没有验证。

swagger 文档我一直在用，我现在还是在用我一年前 写的项目，

http://run27.top/swaggerhuge

@julyclyde 模拟的是自己的，并没有模拟 MailGun 等的。我定义的接口和它们的不一样。

@julyclyde 本来准备要搭建一个邮件系统试一下，后来一想，不对啊，还有短信呢？

@julyclyde 邮件技术是什么？ POP3 ？ STMP ？你的意思是？

@sinv [手动滑稽～]

@mywaiting [手动滑稽~]

@chinaqzxh 难受。可以提 ISSUE.

@airyland 线上的工具已经支持导出 excel 了（菜单“文件-导出”），原生的工具目前还没有。

@lhx2008 推荐一个吧，毕竟这个轮子花了我不少精力。如果有这样的网站那是最好了，毕竟他们的维护能力比我个人强得多。我之前用过一个工具，http://www.convertcsv.com/json-to-csv.htm ，能够支持嵌套不太深的 JSON，但是嵌套太深效果就不好了。由于我们公司用的是 MongoDB，有很多嵌套层次太深的数据，所以才诞生了干脆写一个这么个工具的想法。

至于你说的前端性能限制，我这边还没实测，不知道如何。不过我估计效果也不会太理想。

顺便推广一下我的一个在线 Swagger Doc 编辑网站：

> https://run27.top/swaggerhuge

1. 支持团队私有化（本身就是设计成私有化的）
2. 支持团队协作（仿照 git 的模式，可以多人同时编辑不冲突）
3. 。。。

以前用的是国外的 swaggerhub，但是它的访问速度奇慢，翻墙后的速度也不太能接受。所以就自己写了一个。swaggerhub 的另一个问题是多人编辑不方便，会覆盖掉。最后的缺点就是收费了。

我目前只是在自己的团队内部推荐使用，并没有花力气推广。我觉得用 Swagger 写 API 可能有点小众。

百度云的图片失效了，重新上传个。


@hucheng91 谢谢！还可以吧，虽然我也说不上来哪里好。就是现在还是雏形，Excel 不能转，要写 Builder 还是得花时间的。