开放平台联调顺序页

这页把 `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 字段是否齐全。

去看这一步示例