我现在有一个邮件收发的服务,其中,获取邮件列表和获取指定邮件详细内容这两个接口很接近。现在是这样设计的,但是使用一个action参数来区分总觉得很别扭,请熟悉REST接口的大牛提点,应该怎样设计这两个接口?
获取邮件列表,返回所有邮件的概要
GET http://127.0.0.1:8080/email?ssl=true&host=imap.sina.com&port=993&protocol=imap&action=list&user=xxx&password=xxx&id=1
获取指定邮件,返回指定id邮件的全文
GET http://127.0.0.1:8080/email?ssl=true&host=imap.sina.com&port=993&protocol=imap&action=get&user=xxx&password=xxx&id=7
#frontend
Header token=${token} instead user & password
http://127.0.0.1:8080/email
http://127.0.0.1:8080/email/{id}
#backend
email_config.properties
...
######GET http://127.0.0.1:8080/emails 返回邮件列表
GET http://127.0.0.1:8080/email/ID 返回指定邮件
个人理解 不知道对不对……
######我公司也是这样设计的######GET http://127.0.0.1:8080/emails 返回邮件列表
GET http://127.0.0.1:8080/email/ID 返回指定邮件
个人理解 不知道对不对……
列表中不需要加 s
######谢谢######get方法。。password这样的值有加密过吗。。
######回复 @金木道长 : 第一个答案看起来不错######比较简陋的接口,不想做oauth验证,可逆加密倒可以考虑版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。