我是否正确设计了此WCF RESTful接口？

Question

我正在使用WcF身份验证服务创建WCF Web服务,我需要的第一组功能是管理客户端的收件箱.客户端将由身份验证确定.

这是我尝试REST的REST设计:

---

https://api.mydomain.com/v1/inbox/messages (GET)

使用可选的搜索过滤器返回收件箱中的结果页面

• 计数 - 每页的记录数
• 页面 - 开始的页面
• 排序 - (可选)字段进行排序
• 搜索 - (可选)要搜索的文本

---

https://api.mydomain.com/v1/inbox/mark (POST)

标记一条或多条已读或未读的邮件

• 动作 - MarkRead或MarkUnread
• MessageIDs - 要标记的消息ID列表

---

https://api.mydomain.com/v1/inbox/archive (POST)

归档一条或多条消息

• MessageIDs - 要归档的消息ID列表

---

我这样做了吗？如果没有,那么设计这个界面会有什么更好的方法呢？

Answer 1

关于已读/未读部分，我认为您不需要发帖。我认为你需要 put 方法 https://api.mydomain.com/v1/inbox/messageId/Read https://api.mydomain.com/v1/inbox/messageId/Unread

创建新记录并且想要更新时需要发布

对于存档部分我同意。只需记住返回存档过程的结果即可。