php - 创建自定义状态代码

Question

我有一个 API，我需要在其上设置自定义状态代码。除了正常的标准 http 状态代码之外，创建我们自己的状态代码是否是最佳实践？

即，如果我的客户发送一个空白参数 (orderID)，我可以设置一个我自己的随机状态代码编号，比如 123 吗？或者是否有任何标准方法来创建客户状态代码？

Answer 1

现有的代码很多，所以通常你不需要发明新的代码。不过，您可能会这样做，但是当您这样做时，请确保使用正确的范围。

例如，200+ 范围表示任何类型的成功，300+ 是重定向，400+ 范围是客户端错误(错误的 url 格式，未找到目标)，500+ 是服务器错误。

通过遵循这些准则，您可以使用各种客户端与您的 API 进行通信。浏览器通常应该显示任何 2XX 状态代码的结果，并将其视为成功请求，即使特定的 XX 对它来说是未知的。

要获得相当完整的状态代码列表及其正常含义，以及每个范围的一般描述，请参见: http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html

599 是分配的最高状态代码。我不知道是否允许使用 600+ 范围，但我找不到任何相关信息。不过，我无法想象您的身份不属于任何现有类别。

休息:除了返回代码，您还可以(应该？)查看不同的方法。您可能知道 GET(在 url 中发送数据)和 POST(随请求发送额外数据)，因为它们很常用。但是您还得到了 PUT 和 DELETE，它们对于像这样的 api 特别有用。如果您搜索像 Restfull API 这样的术语，您应该会得到大量关于这个主题的文档。另外，请参阅此 W3 link请求方法的概述。

整合:要通过 api 创建客户，您可以发送包含新客户数据的 PUT 请求。该 API 可以返回 201 Created 以及客户的 ID(或 slug)。如果要删除客户，发送DELETE请求，返回204 No content，因为只需要确认删除成功，不需要发送任何内容。