如何检查实体是否在RESTful API列表中?

时间:2015-12-07 13:46:00

标签: api rest

我正在为我的应用程序的后端设计API。

假设用户可以关注其他用户的活动。 在这种情况下,我设计了一个API,允许我这样做:

POST /me/following

并将id作为此请求的正文。 然后我可以用这种方式检索关注者列表:

GET /me/following

此API附带分页,因此我无法立即检索整个列表。 但是如何检查用户是否跟随另一个用户?我应该使用像

这样的东西吗?
GET /me/following/{user_id}

并检查此请求的状态代码?就像200它存在或404它不存在于列表中?

通常404表示调用的端点不存在。如果实体不存在怎么办?是否有状态代码?

1 个答案:

答案 0 :(得分:1)

GET /me/following/{user_id}似乎很好。

我可能会返回204 No Content

  

成功2xx   此类状态代码表示已成功接收,理解和接受客户端的请求。

     

[...]

     

204无内容

     

服务器已完成请求但不需要返回   entity-body,可能想要返回更新的元信息。

相比之下,404描述了某种错误,尽管它可以完成这项工作,具体取决于你如何看待它

  

客户端错误4xx

     

4xx类状态代码适用于客户端的情况   似乎有错误。

     

404 Not Found

     

服务器未找到与Request-URI匹配的任何内容。没有   指示该条件是暂时的还是   永久的。

http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html