angular.js - 设计 API 接口返回的 JSON 数据格式有没有比较流行的最佳实践？

Question

最近我们公司开发一个项目， PC 端 手机 APP 端 手机网页端 设计 API 接口返回的 JSON 数据格式有没有比较流行的最佳实践？

目前找了以下几种版本

版本 1 ： 成功执行： head Status Code:2XX

json {"id":51,"age":58,"name":"lifei"}

失败执行 head Status Code:4XX-5XX {"message":"xxxxxx 错误","errors:{}}

版本 2 ： 成功和失败执行 head Status Code:2xx

json {"code":"0","message:"信息","data":{}}

版本 3: 成功执行： head Status Code:2XX

json {"id":51,"age":58,"name":"lifei"}

失败执行 head Status Code:4XX-5XX {"code":10001, "message":"xxxxxx 错误","errors:{}}

如果业务不同的错误类型，比如我要提现操作，可能会出现银行卡未绑定、没有上传户口本，没有上传身份证，没有绑定手机号码，没有填写住址等错误，没有余额等等。

Answer 1

Jenis ini
http://swagger.io/

Answer 2

http://jsonapi.org/

https://github.com/interagent...

Spesifikasi jenis ini agak rumit, tetapi anda boleh mempelajarinya sekali dan menggunakannya seumur hidup, dan kedua-dua bahagian hadapan dan belakang boleh digunakan semula dengan mudah

Kelebihan mentakrifkan spesifikasi anda sendiri ialah ia mudah, tetapi banyak butiran mungkin tidak dipertimbangkan semasa reka bentuk, menjadikan pengubahsuaian sangat menyusahkan

Answer 3

https://github.com/ShuyunXIAN...

Answer 4

JSON RPC 2.0
http://www.jsonrpc.org/specif...