clwy-app
  1. 课程
clwy-app
  • 前台
    • 首页
      • 查询列表
    • 分类
      • 查询分类列表
    • 课程
      • 查询课程列表
        GET
      • 查询课程详情
        GET
    • 章节
      • 查询章节详情
    • 文章
      • 查询文章列表
      • 查询文章详情
    • 搜索
      • 搜索
    • 系统信息
      • 查询系统信息
    • 认证
      • 注册
      • 登录
    • 用户
      • 查询当前登录用户详情
      • 更新用户信息
      • 更新账户信息
      • 注销账户
    • 点赞
      • 查询用户点赞的课程
      • 点赞、取消赞
    • 上传
      • 上传图片
  1. 课程

查询课程列表

开发中
GET
/courses

请求参数

Query 参数
categoryId
string 
必需
示例值:
2

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'http://localhost:3000/courses?categoryId=2'

返回响应

🟢200成功
application/json
Body
status
boolean 
必需
message
string 
必需
data
object 
必需
courses
array [object {12}] 
必需
pagination
object 
必需
示例
{
    "status": true,
    "message": "查询课程列表成功。",
    "data": {
        "courses": [
            {
                "id": 9,
                "createdAt": "2025-04-22 20:06:58",
                "updatedAt": "2025-04-22 20:06:58",
                "name": "Node.js 入门 - 使用 Express + Sequelize 实作 API",
                "image": "http://localhost:3000/uploads/images/1745294815786-766619312.jpeg",
                "recommended": false,
                "introductory": true,
                "likesCount": 0,
                "chaptersCount": 0,
                "categoryId": 2,
                "userId": 1,
                "category": {
                    "id": 2,
                    "name": "后端开发"
                }
            },
            {
                "id": 6,
                "createdAt": "2025-04-22 20:04:14",
                "updatedAt": "2025-04-22 20:04:24",
                "name": "Laravel 技巧库",
                "image": "http://localhost:3000/uploads/images/1745294590884-399536674.jpeg",
                "recommended": false,
                "introductory": false,
                "likesCount": 0,
                "chaptersCount": 0,
                "categoryId": 2,
                "userId": 1,
                "category": {
                    "id": 2,
                    "name": "后端开发"
                }
            },
            {
                "id": 4,
                "createdAt": "2025-04-22 20:01:19",
                "updatedAt": "2025-04-22 20:04:41",
                "name": "Workerman + Laravel + Vue.js 实战聊天室",
                "image": "http://localhost:3000/uploads/images/1745294416780-81608528.jpeg",
                "recommended": true,
                "introductory": false,
                "likesCount": 0,
                "chaptersCount": 0,
                "categoryId": 2,
                "userId": 1,
                "category": {
                    "id": 2,
                    "name": "后端开发"
                }
            },
            {
                "id": 2,
                "createdAt": "2025-04-22 18:35:13",
                "updatedAt": "2025-05-28 17:36:47",
                "name": "Node.js 项目实践",
                "image": "http://localhost:3000/uploads/images/1745289257308-482473119.png",
                "recommended": true,
                "introductory": true,
                "likesCount": 2,
                "chaptersCount": 10,
                "categoryId": 2,
                "userId": 1,
                "category": {
                    "id": 2,
                    "name": "后端开发"
                }
            },
            {
                "id": 1,
                "createdAt": "2025-04-22 18:26:45",
                "updatedAt": "2025-05-26 19:42:19",
                "name": "超简单的 Laravel 新手入门课程",
                "image": "http://localhost:3000/uploads/images/1745288773354-15314852.jpeg",
                "recommended": true,
                "introductory": true,
                "likesCount": 3,
                "chaptersCount": 0,
                "categoryId": 2,
                "userId": 1,
                "category": {
                    "id": 2,
                    "name": "后端开发"
                }
            }
        ],
        "pagination": {
            "page": 1,
            "limit": 10,
            "total": 5
        }
    }
}
上一页
查询分类列表
下一页
查询课程详情
Built with