javascript - Wie benenne ich Vorgänge, die nicht CURD entsprechen, in einer URL im REST-Stil?

Question

Derzeit gibt es im Internet eine große Anzahl von Artikeln zum Entwerfen einer RESTful-API (der Einfachheit halber wird „RESTful API“ im Folgenden als „API“ abgekürzt. Es gibt jedoch keinen „universellen“ Designstandard für die Authentifizierung). ? Was ist das API-Format? Wenn Sie mit dem Schreiben einer App beginnen, insbesondere wenn der Back-End-Modellteil geschrieben wurde, müssen Sie große Anstrengungen unternehmen, um den öffentlichen API-Teil Ihrer App zu entwerfen und zu implementieren. Denn sobald die API freigegeben ist, wird es schwierig sein, sie für die Außenwelt zu ändern.

Frage 1:
E-Mail /mail/1/send mit POST senden /mail/send mit POST
So benennen Sie die URL

Frage 2
Eine bestimmte Benutzerliste abrufen /getVipUser /user/vip /getUserList?type=vip
So benennen Sie die URL

Frage 3
Soll ich ein Kamel oder eine Schlange verwenden? Es ist sehr verwirrend, dass ich beides verwendet habe, aber ich bin immer noch verwirrt.

Answer 1

restful只是一套参考的规范而已，我的理解是 软件开发领域没有包打天下的规范，只有各不相同的 best practice 最佳实践，至于 API 只要便于开发人员区分就行了，楼主不必强迫自己为了规范而规范，只要实现功能谁会在乎你API长什么样。

Answer 2

可以看看 阮一峰的博文：
http://www.ruanyifeng.com/blo...

关于使用驼峰还是蛇形 应该全部小写

Answer 3

vip可以作为一个资源
GET vips/user/{id} OR GET users/vip/{id} 获取单个资源
GET vips/user OR GET users/vip 获取多个资源

Answer 4

这些资源你或许可以参考一下：restful-api-design-references - RESTful API 设计参考文献列表，可帮助你更加彻底的了解REST风格的接口设计。

RESTful api的实际应用中，Github API v3 的设计可以说是楷模，也可以看看。