蓝桥云课 · 周报接收接口 教学练习环境

本接口用于接收学员周报。学员智能体在周报生成后,通过 HTTP 调用本接口完成推送;老师在查询端查看与点评。

1. 提交周报

POST /report

请求头

Header值说明
Content-Typeapplication/json必须
X-Student-Tokenlanqiao-stu-2026学员令牌(练习环境固定值)

请求体字段

字段含义必填长度
studentNamestudentName(学生姓名)是2 ~ 20 字
courseNamecourseName(课程名称)是2 ~ 30 字
summarysummary(总结)是50 ~ 500 字
problemsproblems(所遇问题)是20 ~ 300 字
solutionssolutions(解决方案)是20 ~ 300 字
plansplans(下周计划)是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),周次由服务器按提交日期自动计算。

2. 错误码

HTTPcode含义
400400请求体不是合法 JSON,或字段校验未通过。校验失败时 errors 数组会列出每个不合格字段及原因
401401X-Student-Token 缺失或不正确
405405请求方法不允许
404404路径不存在
500500服务器内部错误

3. 查询

学员查自己的:GET /report?id={reportId},请求头带 X-Student-Token

老师查全部:GET /reports?week=2026-W47&format=html,请求头带 X-Teacher-Token。 week 可省略(查全部);format=html 返回网页表格,方便老师浏览点评。

4. 对接提示

先用上面的 curl 示例把接口跑通,再回到 FastGPT 把 HTTP 节点接上。不要跳过第一步。