我的Swagger doc（又名Open API）应该定义500个响应代码吗？

Question

如果我要使用像AutoRest这样的客户端生成器，我是否希望生成的客户端能够预测500个错误？

或者，我希望在try / catch中包装客户端请求吗？

这只是我需要做出的风格决定吗？

Answer 1

对于Swagger Codegen（免费，开源），API客户端通常会返回4xx或5xx HTTP响应的异常（例如ApiException），因为它表示发生了错误（例如，删除数据库中从不存在的对象）并且通常ApiException对象包含有关服务器返回的错误的所有信息。