我正在寻找为来自Web服务的JSON响应编写约定。这是一个令人惊奇的问题:Standard JSON API response format?
看着上面的问题,我最喜欢https://github.com/omniti-labs/jsend。它简单易懂。它基于这样的思想,每个呼叫都返回一个status
,其值是以下三个值之一:success
,fail
和error
。
我认为fail
中的error
和jsend
可能是同一件事。在这两种情况下,都出了问题,用户/编码器需要修复。但是我想到了将这个想法调整为这样的方式:
success
一切顺利,用户可以继续进行。warning
出了点问题,但是用户仍然可以继续。error
出了点问题,用户无法继续操作。 但是warning
真的有必要吗? warning
何时比error
更有意义?
假设您提交5个新客户,成功3个,失败2个。这是warning
还是error
?我认为这是error
。出问题了,前端需要重新发送2个失败的用户。您不能只是继续运行该应用程序并让用户知道We 3 succeeded and 2 failed
,该用户现在应该做什么?
注意:在我的回复中,总是有status
,message
和data
。因此,您可以使用以下方法来解决上述问题:
状态:“错误”, 消息:“ 3个用户成功而2个失败”, 数据:[..前端失败的2个用户重新提交。]