跳到正文
阿里雲開發者社區 AI·· 6 小時前AI 評分32

管理類聯考題庫接入刷題頁:先看統計再決定頁面|數據魚API

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

AI 導讀

數據魚API的管理類聯考題庫接入刷題頁,應先查統計與分類,再按題庫分佈設計列表、詳情和判分流程。題庫共 333 道題、分為 3 個分類,只有單選題 318 道和判斷題 15 道;列表每頁最多 20 題。寫作分類沒有主觀題判分入口,不能用這個接口為整篇作文評分。

正文

2026-11-19 7

版权

版权声明:

本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写 侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

简介: 管理类联考刷题页不是把题目拉下来就能用。以数据鱼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「管理类联考题库」接口的公开文档;文中产品场景为虚构示例,题目内容与考试政策请以官方发布为准。

來源:阿里雲開發者社區 AI · developer.aliyun.com