怎么设计项目的返回码，让不同的返回码代表不同的含义？

Question

这是微信公众平台接口的返回码。做项目的时候，需要API接口返回码，想知道API接口返回码怎么去设计啊？我的意思是怎么去设计 不同的返回码 代表不同的 含义 ， 例如 40001 表示 XXX意思 ， 40002 表示 XXX意思，这些应该这么去设计呢？谢谢大家了

Answer 1

应用开发里用错误名比错误码更好，代码更好读。

想象一下你的客户端代码：

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

vs

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

国内的API提供方有时是为了照顾国内开发者对英文不熟悉（或者API开发者本身不想起英文名字），所以用了数字错误码。

数字码在系统级别意义比较大，因为传输效率高（如二进制协议），对于大量的JSON格式的字符串传输协议，这点效率是不重要的。

可读性重要得多，而且错误名比错误码有无结构的优点，有扩展优势。