受众：IT / 集成商 · 适用：SaaS / 私有
目标：确认 API 是否适合当前阶段，并按顺序阅读对接文档。
适合
- 与教务 / SIS / 中台 定期同步 师生与班级
- 需要程序化创建作业、拉取练习结果
- 私有部署后由集成商统一接入
不适合
- 一次性小规模建档（优先 CSV）
- 无开发资源、无法在服务端保管密钥
- 仅需偶尔导出成绩快照（用 CSV 导出即可）
与 CSV 的分工
| 事项 | CSV | API |
|---|
| 首次字段验证 | 推荐 | 可后做 |
| 日常增量同步 | 不推荐 | 推荐 |
| 人工纠错补录 | 推荐 | 可选 |
选型总表见 选哪种进数方式。
阅读顺序
- 对接前准备
- 认证与调用约定
- 典型同步流程
- 联调与上线清单
本帮助中心描述业务顺序与检查项；具体路径与字段以当前环境的 API / OpenAPI 文档为准。
