問題描述

這是微信公眾平臺接口的返回碼。做項目的時候，需要API接口返回碼，想知道API接口返回碼怎么去設計啊？

我的意思是怎么去設計 不同的返回碼 代表不同的 含義 ， 例如 40001 表示 XXX意思 ， 40002 表示 XXX意思，這些應該這么去設計呢？謝謝大家了

問題解答

應用開發(fā)里用錯誤名比錯誤碼更好，代碼更好讀。

想象一下你的客戶端代碼：

if (error === ’ERROR_INVALID_ACCESS_TOKEN’) { ... }

vs

if (error === 40010) { ... }

國內(nèi)的API提供方有時是為了照顧國內(nèi)開發(fā)者對英文不熟悉（或者API開發(fā)者本身不想起英文名字），所以用了數(shù)字錯誤碼。

數(shù)字碼在系統(tǒng)級別意義比較大，因為傳輸效率高（如二進制協(xié)議），對于大量的JSON格式的字符串傳輸協(xié)議，這點效率是不重要的。

可讀性重要得多，而且錯誤名比錯誤碼有無結構的優(yōu)點，有擴展優(yōu)勢。

給你提供我的想法，特殊的返回碼：（各個接口通用）0，代表成功-1，代表服務器內(nèi)部錯誤普通的錯誤返回碼：第一個數(shù)字代表返回不同接口，其余的就是錯誤類型了，按照重要性遞減排列。

其實沒必要這么深研究，我覺得這樣就夠了。和微信的差不多。重要的是一定要簡約。

你可以學微軟的，比如 ERROR_SUCCESS 是 0 代表成功。從 1 開始就定義錯誤代碼，直到一萬多。那么你可以把錯誤代碼分為一些區(qū)間，比如 1~1000、1001~2000、2001~3000 等，分別代表什么類型的意義，然后每個區(qū)間可以從基礎的能想到的錯誤代碼開始進行定義，之后也可以少量擴增。

$con = array(’code’=>4000,’data’=>’result’);echo json_encode($con);