如題。
另外,條目的展示是否用 data 包起來比較好,比如:
"status": 200,
"total": 57,
"data" : {
[
"item" : {
"id": 1,
"name" : "name1"
},
...
"item" : {
"id": 999,
"name" : "name999"
}
]
}
API 這種東西設計感覺稍有不嚴謹就會照成很多「歷史問題」。小弟第一次寫 API ,經驗不足,於是參照了一下各大 SNS 的 API ,發現他們混用情況很嚴重,一下用 code 一下用 status 。
就連 stripe 這種把 API 當藝術品在維護的文檔,也有這種現象,而且在 stripe 的 API 中,我還發現兩個新詞 amount 和 total_count 這讓我比較困惑,不知參照誰的標準去定義 API 。
雖然自己隨便選一個單詞來定義即可,但還是想問問大家是怎麼處理,以及有什麼好的範例推薦。