php - RESTful API URL 结构

Question

我被困在如何为我正在开发的 RESTful API 构建我的 URL。我的问题来自这样一个事实，即有时我需要从一次调用中获取多个连接表。

在一种情况下，我需要获得两张桌子。我有一个名为 的表courses和一个名为 的表topics。我需要获得该course_name行，然后是属于该课程的所有主题。

在另一个例子中，我需要获得三个表。我需要加入topics到表parts中bullet_points

我应该如何在网址中引用这些？

应该是这样的吗？要获得一门课程：

courses/:course_id/ 

要获得课程及其主题：

courses/:course_id/topics

要获得一个主题及其部分和要点：

courses/:course_id/topics/:topic_id/parts

我是新手，所以想知道我应该如何真正接近网址的结构。

Answer 1

我认为您建议的 URL 结构很好。它也很好地对应于良好的资源布局。

// courses
$list = $model->getCourseList();

// courses/c_id
$course = $model->getCourse($c_id);

    // courses/c_id/topics
    $courseTopicList = $course->getTopicList();

    // courses/c_id/topics/t_id
    $courseTopic = $course->getTopic($t_id);

        // courses/c_id/topics/t_id/parts
        $courseTopicParts = $topic->getParts();