开放平台联调顺序页
这页把 `questions → submit → report` 收成一条最省脑子的 reserve 联调路径,后面我们给合作方或自己回看时都更顺。
当前最推荐顺序
先看题目结构,再看提交结果,最后看报告结果。这样最不容易把“题目问题、提交问题、报告问题”混在一起。
1. 拉题
先确认 `GET /api/open/questions` 的版本、题量、题干和选项结构是否稳定。
GET /api/open/questions?version=L1|L2|L3
先看这些字段
planned_total_questionscurrent_available_questionsquestion_textoptions
如果这一步先出问题
如果这里先出问题,优先回 questions 示例页看 `缺少 version / 非法 version`,再确认是拉完整题目还是轻量拉题干。
2. 提交
再确认 `POST /api/open/submit` 能稳定返回 scores 和 report_id。
POST /api/open/submit
先看这些字段
scoresreport_idassessment_id
如果这一步先出问题
如果提交没接住,先回 submit 示例页看 `assessment_id / selected_option / 答案集完整性` 这三类常见错误。
3. 取报告
最后确认 `GET /api/open/report/[reportId]` 是否带齐三套报告和协作判断增强公开结果。
GET /api/open/report/[reportId]
先看这些字段
recommended_suitereport_variantspartner_copypartner_follow_up_copy
如果这一步先出问题
如果报告不对,先回 report 示例页看 `reportId` 是否缺失,再确认返回结构和 suite / partner 字段是否齐全。