#這是微信公眾平台介面的回傳碼。做專案的時候,需要API介面回傳碼,想知道API介面回傳碼怎麼去設計啊?
我的意思是怎麼去設計 不同的回傳碼 代表不同的 意義 , 例如 40001 表示 XXX意思 , 40002 表示 XXX意思,這些應該這麼去設計呢?謝謝大家了
黄舟2017-06-12 09:21:41
應用程式開發裡用錯誤名比錯誤碼更好,程式碼更好讀。
想像一下你的客戶端程式碼:
if (error === 'ERROR_INVALID_ACCESS_TOKEN') { ... }
vs
if (error === 40010) { ... }
國內的API提供者有時是為了照顧國內開發者對英文不熟悉(或API開發者本身不想起英文名字),所以用了數字錯誤碼。
數位碼在系統層級意義比較大,因為傳輸效率高(如二進位協定),對於大量的JSON格式的字串傳輸協議,這點效率是不重要的。
可讀性重要得多,而且錯誤名稱比錯誤碼有無結構的優點,有擴展優勢。
迷茫2017-06-12 09:21:41
給你提供我的想法,
特殊的返回碼:(各個接口通用)
0,代表成功
-1,代表服務器內部錯誤
普通的錯誤返回碼:
第一個數字代表返回不同接口,
其餘的就是錯誤類型了,依照重要性遞減排列。
其實沒必要這麼深研究,我覺得這樣就夠了。
和微信的差不多。
重要的是一定要簡約。
高洛峰2017-06-12 09:21:41
你可以學微軟的,像是 ERROR_SUCCESS 是 0 代表成功。從 1 開始就定義錯誤代碼,直到一萬多。那你可以把錯誤代碼分成一些區間,例如1~1000、1001~2000、2001~3000 等,分別代表什麼類型的意義,然後每個區間可以從基礎的能想到的錯誤代碼開始進行定義,之後也可以少量擴增。