1

我正在创建一个简单的 API 来验证会员资格。客户端必须输入一个字符串 ID,服务器将检查该 ID 是否是我们社区的有效成员。ID 只能是数字,长度为 10。

很简单吧?

如果 ID 是有效的,我们当然会返回 HTTP 状态码 OK。如果 ID 包含 alfabet,或者少于/多于 10 个,那么我们将返回 HTTP 状态代码 BAD REQUEST。

问题是,当 ID 是数字且长度 = 10,但不是我们社区的成员时,返回的最佳实用 HTTP 状态代码是什么?为什么是这样。

4

1 回答 1

0

REST API 的端点通常是您使用 HTTP 方法(如 GET、PUT、POST、DELTE)对其进行操作的资源。当你这样做时,更容易决定返回哪个 HTTP 状态。

所以也许你可以做一个端点

/member/{id}
  • 如果存在具有此 ID 的成员,则返回 HTTP 200 并且如果您想要一些带有基本成员信息的 JSON
  • 如果 id 有效,但不存在成员,则返回 HTTP 404 - NOT FOUND
  • 如果 id 无效,长度 !=10 或包含无效字符,则返回 HTTP 400 BAD REQUEST

在这里您可以找到有关REST API 设计的更多信息

于 2017-01-18T22:04:53.513 回答