REST APIの異なるメソッドに同じパス名を書くことはできますか？

Question

Swagger apiを使用してREST APIを作成しています。今、私は（私はオンラインの多くのAPIで、このようなパスを見てきました）、挿入する方法を記述し、更新や方法を以下に削除する：（挿入用）

1. POST

/学生

PUT（更新用）

/学生/ {studentId}

/学生は/ {studentId}

ここで、1は大丈夫ですが、2及び3は、（削除用）

あるDELETE同じパス（ただし、異なる方法があります）。 Swagger APIは私がこのように書くとエラーになります。これは本当に許可されていませんか？

許可されていない場合は、長くしないで別のパスを定義しても「クール」に見える最適な方法は何ですか？同じパスに異なる方法（GET/PUT/DELETEの/ etc）を定義するために

Answer 1

、単にこのパスの下でこれらのメソッドをリストし、そのよう：

paths: 
    /students/{studentId}: 
    # Common parameter for all methods on this path 
    parameters: 
     - name: studentId 
     in: path 
     ... 

    get: 
     summary: Get a student by ID 
     ... 

    put: 
     summary: Update a student 
     ... 

    delete: 
     summary: Delete a student 
     ...