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

這種
http://swagger.io/

Answer 2

http://jsonapi.org/

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

這種規範都比較複雜，但是學一次終身受用，而且前端和後端都可以很方便復用

自己定義規範優勢就是簡單，但是很多細節問題可能設計的時候考慮不到，修改起來很麻煩

Answer 3

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

Answer 4

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