最近我們公司開發一個項目, 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:{}}
如果業務不同的錯誤類型,例如我要提現操作,可能會出現銀行卡未綁定、沒有上傳戶口本,沒有上傳身分證,沒有綁定手機號碼,沒有填寫住址等錯誤,沒有餘額等等。
巴扎黑2017-05-15 17:07:02
http://jsonapi.org/
https://github.com/interagent...
這種規範都比較複雜,但是學一次終身受用,而且前端和後端都可以很方便復用
自己定義規範優勢就是簡單,但是很多細節問題可能設計的時候考慮不到,修改起來很麻煩