rest - 如何定义 bool API RESTful？

Question

我必须定义一个 API 来回答是否可以创建具有给定 ID 的资源，例如

Can I (caller) create this resource with id=resource1 ?

可能的 react 是

• 401 - 调用者未通过身份验证
• 403 - 调用者已通过身份验证但无权执行此检查
• 200 - 是的，您可以使用 id=resource1 创建资源
• ...

现在我的问题是

1. 如何为 API 建模？GET/resources/resource1 会是一个不错的选择吗？

2. 什么 HTTP 代码适合响应，例如，(a) 此资源 ID 已被占用，(b) 您无权创建此特定 ID(但只有少数其他 ID)，(c) 您可以创建此 ID。

Answer 1

github 中的示例可能对您有所帮助。

用于检查用户是否关注另一个用户的 api:

GET/user/following/:用户名

交易信息显示在 github's api document 中

对于你的问题1，我认为你可以这样实现:

GET/resource/existence/:resource_id

对于问题2，你也可以看看github's client errors