restful 风格项目，返回值 json 该如何设计 ？

Question

一般来说restful风格的返回值该如何 ？ 有哪些基本 key ？
比如类似 ：

{
    status : "",
    metadata:{
        
    },
    content:{
    []
    },
    error:"",
    success:""
}

如何设计，才能使在 web客户端方便而且统一的获取，不然每个地方的格式都不一样的话就很麻烦了 ?

Answer 1

我目前做法是：
data：接口返回的数据
code：错误代码
ret：请求是否成功/请求是否抛出异常
forUser：前端展示给用户看的信息
forWorker：给工作人员看的信息
version：版本号
这个返回格式跟个人习惯还有团队的之间的协商很有关系，一般来说除了几个必须的重要的信息，例如数据、错误代码，其他都是看情况的。

Answer 2

code: 错误代码比如  0为正常  非0为异常
data: 接口返回的数据
msg:  错误信息