本接口用于接收学员周报。学员智能体在周报生成后,通过 HTTP 调用本接口完成推送;老师在查询端查看与点评。
POST /report
请求头
| Header | 值 | 说明 |
|---|---|---|
| Content-Type | application/json | 必须 |
| X-Student-Token | lanqiao-stu-2026 | 学员令牌(练习环境固定值) |
请求体字段
| 字段 | 含义 | 必填 | 长度 |
|---|---|---|---|
studentName | studentName(学生姓名) | 是 | 2 ~ 20 字 |
courseName | courseName(课程名称) | 是 | 2 ~ 30 字 |
summary | summary(总结) | 是 | 50 ~ 500 字 |
problems | problems(所遇问题) | 是 | 20 ~ 300 字 |
solutions | solutions(解决方案) | 是 | 20 ~ 300 字 |
plans | plans(下周计划) | 是 | 20 ~ 300 字 |
请求示例
curl -X POST "https://report-api.songzhantao.cn/report" \
-H "Content-Type: application/json" \
-H "X-Student-Token: lanqiao-stu-2026" \
-d '{
"studentName": "陈子轩",
"courseName": "软件测试基础",
"summary": "本周学习多种测试用例设计方法,重点学习等价类划分法与边界值分析法,完成图书商城功能测试用例编写作业,学会针对注册、搜索、下单等业务场景设计测试数据,完成线上课程学习和课后习题。",
"problems": "写测试用例时不会合理划分场景,场景法和等价类容易混淆;用例描述不够规范,预期结果写得模糊。",
"solutions": "整理每种测试方法的适用场景笔记,对比区分;参考课上示例修改自己的用例,规范操作步骤和预期结果的写法。",
"plans": "学习判定表法、因果图法,多做实战练习;巩固已学的用例设计方法,完成预习任务。"
}'
成功响应(HTTP 200)
{
"code": 0,
"msg": "提交成功",
"data": {
"reportId": "R-2026-W47-陈子轩",
"week": "2026-W47",
"submittedAt": "2026-11-16 19:40:00",
"updated": false
}
}
同一学员同一周再次提交会覆盖上一份(updated 变为 true),周次由服务器按提交日期自动计算。
| HTTP | code | 含义 |
|---|---|---|
| 400 | 400 | 请求体不是合法 JSON,或字段校验未通过。校验失败时 errors 数组会列出每个不合格字段及原因 |
| 401 | 401 | X-Student-Token 缺失或不正确 |
| 405 | 405 | 请求方法不允许 |
| 404 | 404 | 路径不存在 |
| 500 | 500 | 服务器内部错误 |
学员查自己的:GET /report?id={reportId},请求头带 X-Student-Token
老师查全部:GET /reports?week=2026-W47&format=html,请求头带 X-Teacher-Token。
week 可省略(查全部);format=html 返回网页表格,方便老师浏览点评。
先用上面的 curl 示例把接口跑通,再回到 FastGPT 把 HTTP 节点接上。不要跳过第一步。