我应该为REST API错误引发哪个异常？

Question

我正在用Python编写一个简单的API客户端，我想知道如果远程服务器不满意，我应该引发什么异常。

API本身的文档记录非常糟糕（我不知道所有可能的错误消息，所以我不能为所有这些消息定义自定义类），我让请求处理HTTP级别的错误，在这些情况下会引发HTTPError，但是如果服务器在JSON响应中只提供error键，我应该引发什么呢？

我目前使用的是Exception，但感觉非常广泛，我想知道是否有更好的替代方案。

问候。

Answer 1

是的，仅仅引发Exc0019可能过于宽泛。

通常一个模块应该定义他自己的基本异常类：

class MyAPIClientError(Exception):
    pass

然后您可以将其子类化：

class RemoteServerNotHappyError(MyAPIClientError):
    pass

可能应该提到服务器的json返回的API客户端类所不期望的内容。在您认为合适的时候添加相关的错误信息。

这意味着你的库的用户可以捕获这些特定的异常（他们可能知道如何处理），而不必捕获每个异常（他们肯定不知道如何处理每个可能的失败模式）。