有一些标准定义可以参考：

• Json API：不止包含返回数据结构，还有 hateoas 相关信息
• odata-json-format：比较全面的一套 API 通用接口设计
• jSend：简单返回规范
• Google json guide：谷歌的 json 接口规范，和二楼的回答比较相似
• HAL：超文本应用语言，更接近 hateoas 规范，spring boot 的返回数据结构很多就长这样，如下图：

不过讲真的，hateoas 想法很美好，实际很少公司会做到完整的 hateoas 规范，如果真的需要这些表述状态转移信息，不如直接上 graphql 自定义能力更强。