驾考题库API怎么接入车型科目分页与随机练习如何设计
驾考题库 API 接入时应明确驾照类型和科目，再用分页控制题量；顺序模式适合题库浏览和断点学习，随机模式适合练习。题目、选项、答案、解析与图片要分别建模，并处理类型错误和空结果。
驾考题库接口能提供哪些数据
驾考题库接口适合刷题应用、驾校学习系统、内部培训工具和练习小程序。它提供题目列表及答案解析，但不负责用户考试报名、学习进度、模拟考试计分规则或法定考试资格判断，这些能力需要业务系统另行实现。
极速数据当前的驾考题库 API 文档提供 /driverexam/query 端点，支持 GET 和 POST，返回 JSON。请求可以按驾照类型、科目、章节、分页和排序方式筛选题目；返回结果包含题库总数、当前页、每页数量和题目列表。
产品页当前列出小车、客车、货车、摩托车等题目类型，并把科目一和科目四作为科目选择。支持类型、题库版本和内容会更新，正式上线前应重新核对文档，不把当前清单写成永久不变的覆盖承诺。
type和subject应该怎样选择
type 决定驾照题目类型，当前参数表列出的值包括 A1、A3、B1、A2、B2、C1、C2、C3、D、E、F。虽然说明中提到默认 C1，参数表同时将它标为必填，因此接入时应显式传递，不要依赖默认值。
subject 当前使用 1 表示科目一、4 表示科目四，说明中的默认值为 1。用户首次进入应用时可以设置默认科目，但请求、缓存键和学习记录中都应保存实际科目，避免切换后把两套进度混在一起。
chapter 是可选章节参数。当前文档对科目一、科目四和摩托车章节分别给出不同编号范围，因此不能只按“第几个章节”在客户端自行推算。比较稳妥的做法是把章节作为后台配置，并在文档更新后复核；没有选择章节时则按整个类型和科目查询。
一个清晰的练习会话至少应保存：
| 字段 | 作用 |
|---|---|
license_type | 本次练习的驾照类型 |
subject | 科目一或科目四 |
chapter | 可选章节条件 |
sort_mode | 顺序或随机 |
page_number | 顺序模式的当前位置 |
page_size | 单次获取数量 |
started_at | 会话开始时间 |
顺序查询和随机查询如何分工
当前文档使用 sort=normal 表示正常排序，sort=rand 表示随机排序，默认值为 normal。两种模式适合不同的学习任务，不应只做一个“换一批”按钮而不保存状态。
顺序模式适合章节学习、题库浏览和断点续练。业务系统可以保存 pagenum、pagesize 与已答题目状态，用户下次从对应位置继续。随机模式适合日常练习或薄弱项抽题，但随机返回不天然等于不重复；若产品要求一次练习内不重复，需要业务侧保存已出现题目的候选标识并做去重。
文档没有公开独立题目 ID，因此不能假定存在稳定主键。可以基于题干、选项和题目类型生成内部内容指纹，用于当前版本内的候选去重；题库更新后同一道题的文字或解析可能变化，内容指纹也会随之变化。版本升级时应保留旧答题记录，不要直接把历史记录强行绑定到修改后的文本。
分页参数中，pagesize 当前默认 1、最大值 100，pagenum 表示当前页。单次请求不宜为了减少调用就固定取最大值：移动端首屏、练习节奏、图片大小和缓存策略都会影响合适的题量。可以按业务页面决定每批数量，但不要超过当前文档上限。
最小请求模板怎样写
以下模板依据当前接口文档整理，使用占位 APPKEY，没有执行真实请求：
curl --get "https://api.jisuapi.com/driverexam/query" \
--data-urlencode "appkey=YOUR_APPKEY" \
--data-urlencode "type=C1" \
--data-urlencode "subject=1" \
--data-urlencode "pagenum=1" \
--data-urlencode "pagesize=10" \
--data-urlencode "sort=normal"
如果用户选择章节，再增加经过校验的 chapter 参数。APPKEY 必须留在服务端，不要放进网页 JavaScript、移动端安装包或公开代码仓库。服务端还应对用户请求设置频率限制，避免一个刷新动作触发多次重复调用。
请求成功后先检查 JSON 顶层状态，再读取 result。不要因为 HTTP 200 就直接访问题目列表；业务错误同样可能以 JSON 返回。
题目和答案应该怎样建模
当前文档的列表字段包括 question、option1 至 option4、answer、explain、pic，题目记录中还可见适用类型信息。建议把题干、选项、答案、解析和图片地址分开保存，不要拼成一段富文本。
不同题型的选项可能为空。文档公开示例中既有四选一题，也有选项为空、答案为“对”的判断题。因此前端应根据实际字段渲染：有选项时展示选项列表，没有选项时按判断题交互，不要因为 option1 为空就认定整条数据损坏。
答题流程可以按以下顺序处理：
- 展示题干与可用选项，默认隐藏标准答案和解析。
- 用户提交后再比较
answer，记录用户选择与答题时间。 - 展示
explain，但不要让解析字段承担题目唯一标识。 pic非空时再加载图片，并设置超时、占位和失败提示。- 切题时保存本地进度，再请求下一页或读取缓存。
图片属于远程资源时，应允许域名、内容安全策略和缓存设置通过上线环境验证。接口返回图片地址不等于业务系统可以永久复制或再分发；存储、缓存和商业使用范围仍应以服务条款和授权为准。
错误码和空结果怎样处理
当前驾考题库文档列出三个业务错误码：201 表示类型不正确，202 表示科目不正确，210 表示没有信息。
201 应回到驾照类型枚举检查，避免把显示名称或小写值直接传入；202 应检查科目是否使用文档规定的值；210 可能意味着当前条件下没有结果，可让用户取消章节筛选或检查类型和科目组合，但不能自行宣称某类题库永久不受支持。
系统错误码 101 至 108 涉及 APPKEY、有效期、权限、次数、IP 限制、维护或停用。这些错误应由服务端监控处理，不应把 APPKEY 或完整上游响应直接暴露给终端用户。
还要单独处理网络超时、非 JSON 响应和字段缺失。参数错误不要自动重试；网络瞬时失败可以有限退避重试；空结果则应保留查询条件供排查。日志建议记录驾照类型、科目、章节、页码、业务状态和追踪号，APPKEY 必须脱敏。
题库更新后学习记录怎么保留
驾考内容具有版本变化，产品页也展示了题库更新记录。业务系统不应假定题干和解析永久不变。每次同步或缓存题目时，可记录获取日期、内容指纹和来源版本备注；发现题干、答案或解析变化时，保留新旧内容的差异，避免直接覆盖后无法解释历史答题结果。
模拟考试的题量、合格线、时间限制和抽题规则不能仅由这个查询接口推导。若产品需要模拟正式考试，应另行依据当前适用的主管部门规则和业务要求设计，并明确练习结果不等同于正式考试成绩。
总结
驾考题库 API 的接入重点是先固定驾照类型和科目，再根据顺序学习或随机练习选择排序模式，同时把分页、题型渲染、版本变化和错误状态独立处理。开发前查看精确文档，上线后保留题库版本和学习记录，才能让更新与历史进度相互兼容。
