·
Think twice, code once.

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

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

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