为什么API中存在整数错误代码?

时间:2013-02-18 15:30:55

标签: api error-handling

在几乎所有类型的API中都有整数错误代码,例如(例如123),表示错误类型。我想知道使用user_not_foundinvalid_request等描述性字符串代码是否更好。在我看来,它们更实用:假设您在几个月左右后回到代码中,您可以轻松地完成错误处理部分,而无需在文档中搜索错误代码。

为什么API中仍然存在整数错误代码?

2 个答案:

答案 0 :(得分:2)

在API中,客户端通常是使用条件测试响应代码的计算机。

快得多来测试一次性整数,而不是再次测试字符串,这就是全部。

此外,错误代码有一定的逻辑:API通常使用HTTP代码,因此当您(作为人类)读取它们时,您知道2xx表示成功,4xx表示客户端错误和5xx表示服务器端错误,即使您不是全心全意地了解它们。

修改

您的问题让我想到了this answer,关于网站的加载时间如何影响利润。你应该阅读它来说服自己,即使几毫秒有时也很重要。

答案 1 :(得分:0)

但大多数错误都有很好的名称。标准C,POSIX和Windows都有错误代码的名称。当然,大多数这些名称都是作为预处理器宏编写的,但也有一些函数可以从这些消息中获取一个好的字符串或消息。