Rest API 资源命名约定

Question

我有一个学生表，其中包含他的所有基本详细信息以及以下架构。 ssnId为主键

{"name" : "Jack",
"age" : 10,
"ssnId": "12345"
}

我还有另一张桌子students_by_region。一个学生可以属于多个区域。地区是主键。

{
"region" : "Atlanta",
"studentSet" : [Student A, Student B]
}

需要帮助为以下用例定义上表的其余 API

1. X 地区的所有学生都找我。
2. 将学生添加到特定区域。
3. 创建一个包含学生的区域。

Answer 1

1) 获取所有学生的列表 ->

GET /students

2) 通过发布 JSON 请求正文创建新学生 ->

POST /regions/<regionID>/students

3) 将其一分为二：

POST /regions 

创建一个新区域，然后

POST /regions/<newRegionID>/students