#如何设计API返回码（错误码）？#
客户端请求API，通常需要通过返回码来判断API返回的结果是否符合预期，以及该如何处理返回的内容等。

相信很多同学都吃过返回码定义混乱的亏，有的API用返回码是int类型，有的是string类型，有的用0表示成功，又有的用1表示成功，还有用“true”表示成功，碰上这种事情，只能说：头疼。

API返回码的设计还是要认真对待，毕竟好的返回码设计可以降低沟通成本以及程序的维护成本。

HTTP状态码参考
图片

以HTTP状态码为例，为了更加清晰的表述和区分状态码的含义，HTTP状态做了分段。
对于后端开发来说，我们通常见到的都是：

2XX状态码，比如200->请求成功。

5XX状态码，比如502->服务器异常，通常就是服务没正常运行，或者代码执行出错。

通过状态码即可初步判断问题原因，HTTP状态的设计思路值得借鉴。

参数约定
图片

虽说是返回码设计，但是只有code是不行的，还要有对应的message，让人可以看懂。
参考HTTP状态码的思路，我们对错误码进行分段。

通过这样的设计，不论是程序还是人都可以非常方便的区分API的返回结果，关键是统一！

个性化Message

通常我们的Message都是写给工程师看的，但是在不同的场景下，同样的错误，可能需要给用户看到不一样的错误提示。

比方说20000-29999表示订单创建失败：

20001，订单创建失败，存在进行中的订单

20002，订单创建失败，上一个订单正在排队创建中

这两种错误情况如果是给用户看，可能就只适合看到：很抱歉，您有一个正在进行中的订单，请到我的订单列表中处理。

但是对于API来说，返回的信息又必须是准确的，但用户看到的就必须转译，这个转译的工作调用方可以做，但是通常API提供者来提供个性化的Message能力会更好。

我们可以把转译的消息配置到数据库，并缓存到Redis或者API本机。

然后在请求处理结束即将返回的时候，根据application_id+code，去匹配替换message。

这样我们就可以让手机APP的用户、微信小程序的用户、网页下单的企业用户看到不同的消息。

返回信息的统一处理
图片

有了统一的code，我们就可以通过Nginx或者APM工具统计API请求Code数量及分布信息。

我们可以根据单位时间内99999的数量来做API的异常告警。

我们可以根据Code的返回饼图，帮助我们发现系统、业务流程中的问题。

等等……

总之，好的返回码设计，可以帮助我们提高沟通效率，降低代码的维护成本。

我:许愿下次回归蔡氏头发长一点点最好染个发！
四大喜铺:好的，pb已经拍好了，但是是黑短发呢亲亲

我:许愿我CP拍照在一组！
四大喜铺:好的，亲亲给您安排了一个三人组一个两人组，只不过很可惜，你CP被拆了，真的很抱歉呢亲亲

我:许愿这次回归多给点预算
四大喜铺:好的呢亲亲，但是公司马上要倒闭了，您将就一下呢亲亲

您好，请您停止现在的行为，不要再用任何方式试探和打扰我的生活，非常困扰。我个人认为，目前进行匿名提问、坦白说、送外卖的都是同一个人，这样的行为让我感到很被冒犯。感谢您的好意，花收到了，请不要再这样做了。我大概也有所怀疑，这样的行为可能不是出于恶意，但是让我感到不适。我也大概有所猜测是谁有这样的行为，并且通过什么途径获知我的个人信息。我只能说，是我个人需要提高隐私保护的警惕心。作为认识一段时间的人，即便没有深交，也希望能够彼此尊重，不要做一些没有意义的试探。我很抱歉，可能给您带来一些误会。我会更加注意与人相处的分寸与边界，谢谢。（坦白说已关闭，匿名问答已删除，部分微博已隐藏，我也不追问到底是谁了，感谢） https://t.cn/RL8pcv4