管理类联考题库接进刷题页:先看统计再定页面|数据鱼API

简介: 管理类联考刷题页不是把题目拉下来就能用。以数据鱼API的管理类联考题库为例,从 ping、stats、categories 三个只读端点起步,再决定列表、详情、判分三层怎么接,避开题型空缺与写作题无法自动判分的坑。

朋友在做管理类联考的刷题小程序,原型上画了三个 Tab:数学、逻辑、写作。他问我第一版要接哪些接口,我让他先别打开设计稿,先把题库的统计接口跑一遍。

原因很简单:刷题产品的页面结构,应该由题库的真实分布决定,而不是由竞品截图决定。题目都集中在哪、哪些题型其实没有数据、写作能不能自动判分,这些问题在写第一行列表代码之前就该有答案。

下面拿数据鱼API的「管理类联考题库」服务当例子。它把统计、分类、列表、详情、判分拆成了独立端点,适合按“先看数据、再定页面、最后接判分”的顺序接入。
第一步:用三个只读端点摸清家底
先调 ping,确认服务可用,同时拿到题型、难度、语言和分页上限。再调 stats,看总量和分布;最后调 categories,拿分类的 slug 与名称。这三个端点都不需要业务参数,适合放在接入脚本的第一屏。

文档里的实测数据来自数据鱼API:总题量 333,分类 3 个,题型只有单选题 318 道、判断题 15 道。ping 的 types 里虽然列了“多选题”,但 stats.by_type 里并没有多选题的记录。这不是让你去猜原因,而是提醒你:导航可以按 types 生成,但空筛选器不要急着上线。如果产品经理坚持要一个“多选题专项”,至少先确认题库里真的有题,否则用户点进去只会看到空状态。

分类同样值得先看一眼:

分类 slug 名称 文档中的定位
shuxue 数学基础 算术、代数、几何、数据分析
luoji 逻辑推理 形式逻辑、论证逻辑、分析推理
xiezuo 写作基础 论证有效性分析、论说文写作常识
stats.by_module 还能看到更细的分布,比如论证逻辑 49 道、论证有效性分析 49 道、分析推理 38 道、论说文 35 道。这些数字直接决定首页的模块入口怎么排:题多的模块放前面,题少的模块别做成大卡片。

第二步:列表和详情,把“带不带答案”分开
刷题页常见的性能浪费,是列表页顺手把 with_answer=1 也带上,导致每道题的答案解析跟着列表一起返回。数据鱼API的管理类联考题库给了两个开关:brief=1 只返回简要字段,with_answer=1 才返回答案与解析。列表页用前者,用户点开题目、进入解析页时再用后者,响应体能小一大截。

分页参数也要按场景选。page 适合有页码的列表,page_size 最大 20;after_id 适合“上拉加载更多”,只取 id 大于游标的新数据,不会因为前面插入记录而重复。做错题本这类按时间倒序的页面,游标比页码稳。

详情页用 detail,必填 id。如果要做“答完一题看解析”,可以把 with_answer=1 放在详情请求里,而不是在列表阶段就打开。字段太多时,fields 能指定返回字段,最多 30 个;但第一版不建议过度裁剪,先把渲染跑通,再按性能数据收窄。

GET /api/mba/list?category=shuxue&brief=1&page_size=20
GET /api/mba/detail?id=1&with_answer=1
第三步:判分能自动,写作题别硬判
单题判分用 check,传 id 和 answer,答案写成 A 或 ABD 这样的字符串。返回里有 correct、your_answer、correct_answer 和 analysis,足够撑起一个“答对/答错/看解析”的结果页。批量判分用 exam,answers 是必填的数组;不过文档明确标注这个端点的自动化探测没有成功,错误是“缺少参数: answers (数组)”。上线前请用真实结构跑通,别只看参数表。

更值得注意的是写作分类。xiezuo 下面有论证有效性分析和论说文相关题目,但题库的题型统计里只有单选题和判断题,没有主观题判分入口。也就是说,这个接口能帮你做写作常识的客观题练习,做不了整篇作文的评分。产品原型上如果画了“AI 批改作文”,那是另一个能力,别把它算进题库接入的工作量。

页面 端点 关键参数 开关
分类首页 stats / categories 无 先读分布再排入口
题目列表 list page_size 最大 20,可用 after_id brief=1
题目详情 detail id 必填 解析页再开 with_answer=1
单题判分 check id、answer reveal 控制是否直接给正确答案
批量模考 exam answers 数组必填 with_analysis、reveal
收束:先做一条能走通的主链路
第一版不需要把所有端点都接上。选一个分类,做“列表 → 详情 → 答题 → 判分 → 解析”这一条链路,把 brief 和 with_answer 的切换跑顺,再复制到其他分类。统计端点负责告诉你哪些入口值得做,判分端点负责告诉你哪些题型不能自动做。

数据鱼这个接口的分页上限是 20,意味着长列表必须做加载更多;after_id 和 page 二选一,别混用。把这些限制写进接口层,页面组件就不用关心游标细节。

题库是原料,页面是菜。先把原料的品种和数量看清,再决定菜单,比先画菜单再找原料省事得多。

以上统计、分类、分页与判分说明,整理自数据鱼API「管理类联考题库」接口的公开文档;文中产品场景为虚构示例,题目内容与考试政策请以官方发布为准。

相关文章
|
5天前
|
Linux Go 开发工具
手机上跑 DeepSeek 智能体:开源安卓客户端 DSH Go 安装与使用指南
DSH Go 是一款开源安卓客户端,将 DeepSeek Harness 智能体引擎装进手机:免 Root、免 Termux,一键安装即用;支持本机运行(内置 Ubuntu+Node.js)或远程接管电脑会话;具备插话打断、过程折叠、屏幕操控、端到端加密分享等特色功能,真正实现智能体“口袋化”。
6861 15
|
5天前
|
弹性计算 人工智能 API
Codex超详细入门指南(下载·安装·登录·上手,全版本覆盖,2026最新版)
建议收藏本教程,2026 全年各版本更新随时回来查阅。如果你在搭建过程中遇到任何问题,欢迎结合 阿里云工单系统 提交技术支持请求,或在 阿里云开发者社区 搜索 Codex 相关话题交流。 祝你编码愉快,效率翻倍!
2293 8
|
8天前
|
人工智能 前端开发 API
阿里云Qwen4-Max 大模型详解:定位、特征、能力、适用场景与相对Qwen3-Max差异解析
2026年11月11日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问AI平台Token Plan并接入千问办公、Qoder等入口。该版本聚焦知识理解、世界感知、编程与Agentic四项升级,主打复杂编程、专业办公、前端设计与专业软件操作等真实任务。预览期为11月11日10:00至11月25日24:00,仅支持Token Plan调用,到期后模型标识下线;限时2折、新用户再享5折,最低1折可体验。
|
8天前
|
JSON 前端开发 API
阿里云最新Qwen4-Max大模型介绍:模型定位、特征、能力、适用场景解析
2026 年 11 月 11 日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问 AI 平台 Token Plan,并同步接入千问办公、Qoder 等入口。该版本聚焦知识理解、世界感知、编程与 Agentic 四项升级,主打复杂编程、专业办公、前端设计与专业软件操作。预览期至 11 月 25 日 24:00,到期后模型标识下线;限时 2 折、新用户再享 5 折,最低 1 折可体验。
|
3天前
|
传感器 安全 区块链
Windows 电脑运行安卓应用教程:开源工具 ApkStart 双击 APK 即装、独立窗口运行
ApkStart 是一款开源Windows工具,让安卓APP像原生软件一样运行:双击APK即安装、生成真实图标、独立窗口启动、开始菜单可搜索。无需传统模拟器,内置QEMU运行时,支持数据互通、ARM兼容与命令行操作。(239字)
|
21天前
|
Linux 开发工具 iOS开发
Codex保姆级教程(下载+安装+登录+使用,含所有版本,2026最新)
Codex是OpenAI推出的开源AI编程智能体,本地运行,可理解整个代码库,支持自然语言指令改代码、执行命令、跑测试、修Bug,兼容Win/macOS/Linux。(239字)
10171 59
|
4天前
|
人工智能 弹性计算 开发工具
零成本玩各大模型!DeepSeek Harness dsh-our-free-model 插件,13 个厂商模型直接用
总结一下:装这个插件,你不用注册、不用绑卡、不用填一个 Key,就能在 DeepSeek Harness 里用上 DeepSeek V4.1 Flash、Kimi K3 这一批前沿模型,而且是白嫖的、还不限量。三步搞定:下载插件,复制包含 `package.json` 的插件目录路径,在「添加插件」里粘贴路径安装并重启。无论是在阿里云 ECS 上通过命令行部署的 Web 版,还是本地的 Electron 桌面端,都能顺利跑通,快速搭建一套零成本的免费模型使用环境。
1047 0
|
7天前
|
Linux API iOS开发
【DSH】DeepSeek Harness新手保姆教程(下载+安装+配置+使用,2026最新实测)
DeepSeek Harness(dsh)是DeepSeek AI开源的智能体框架,秉持“一切皆插件”理念,支持读文件、改代码、跑命令、处理表格、联网搜索等操作。免费开源,兼容Windows/macOS/Linux,提供桌面端与网页端,可灵活安装插件扩展能力。
|
15天前
|
Linux 开发工具 iOS开发
2026最新codex下载安装保姆级使用教程(下载+安装+登录+使用,含所有历史版本)
本文详解OpenAI Codex国内快速上手指南:提供Win/macOS/Linux全平台免安装包、npm/Homebrew等多方式安装、账号/API Key双登录、简体中文切换,覆盖下载、安装、汉化、使用及高频避坑(如微软商店失败、npm超时等),10分钟即可跑通。
3482 9