
接口错误码:数字ID优于字符串描述?
在设计接口返回的错误码时,是选择数字ID还是字符串描述,一直是开发者关注的焦点。
虽然字符串描述更直观易懂,但我们建议采用数字ID作为错误码,并单独使用errmsg字段返回错误信息。
这种方法的优势在于:
- 高效传输与处理: 数字ID占用空间更小,传输效率更高,也更易于程序处理。
- 易于维护和扩展: 通过预先定义的错误码表,可以方便地将数字ID映射到具体的错误信息,方便维护和扩展新的错误类型。
-
信息更全面: 结合
errmsg提供的详细描述,可以满足不同场景下的错误信息需求。
例如,微信接口的错误码结构就是一个很好的范例:
{
"errcode": 40010,
"errmsg": "错误信息"
}
errcode是简洁的数字ID,errmsg则提供了详细的错误解释。 这种设计兼顾了错误码的简洁性和信息丰富性,方便开发者快速理解和处理错误。










