我可以在REST API中为不同的方法编写相同的path名吗?
我正在使用Swagger API编写REST API。 现在,我想以下面的方式编写插入,更新和删除的方法(我已经看到许多API在线上的这样的path):
- POST (插入)
/学生们
- PUT (用于更新)
/学生/ {} studentId
- 删除 (删除)
/学生/ {} studentId
现在,1是好的,但2和3是相同的path(但有不同的方法)。 Swagger API给我错误,当我这样写。 那么这真的不被允许?
如果不允许,那么定义不同path的最好方法是什么,而不要让它们变长,仍然看起来很酷?
对于Swagger,它确实认为path/a/b
和/a/c
是相同的,这会popup该错误。 有关于此的所有时间的讨论: https : //github.com/OAI/OpenAPI-Specification/issues/576 。
但是你仍然可以尝试类似的东西
/students/{studentId}: parameters: - name: studentId ... get: ... put: ...
查看@ Helen的评论以获取更多信息。