API 文档

接口基址：https://cx.ocyo.cn/api。请求与响应均使用 UTF-8；查题接口需要在参数中传入用户 Token。成功查题会扣除 1 次余额。

Token 可在控制台的用户信息中查看。服务端会先查询本地题库，未命中时查询上游题库。

查题

按题干、题型和选项查询答案。选项内容用于排除同题干但答案不在当前选项中的记录。

POST/api/query.php

请求参数 · application/x-www-form-urlencoded

名称	类型	必填	说明
`token`	string	是	用户 API Key
`tm`	string	是	题干，可包含题号和分值
`type`	string	否	题型：0 单选、1 多选、2 填空、3 判断；也支持中文题型
`options`	string	否	选项文本，按行传入 `A. 内容`，或传 JSON 数组
`answernum` / `questionnum`	string	否	传递给上游题库的附加参数

请求示例

curl -X POST 'https://cx.ocyo.cn/api/query.php' \
  -d 'token=YOUR_TOKEN' \
  --data-urlencode 'tm=1. 下列哪项正确？' \
  --data-urlencode 'type=单选' \
  --data-urlencode $'options=A. 正确选项\nB. 错误选项'

成功响应

{"code":1,"data":"正确选项","msg":"","lefts":99}

code=0 未找到答案或上游错误；code=401 Token 无效、账号禁用或余额不足。

兼容查题

兼容 GET、表单 POST 和 JSON POST。返回题目、答案和剩余次数；设置 more=true 时返回结果数组。

GETPOST/api/queryyx.php

请求参数

名称	类型	必填	说明
`token`	string	是	用户 API Key
`title`	string	是	题干，也接受 `q` 或 `question`
`type`	string	否	`multiple`、`judgement`、`completion` 或 `single`
`options`	string	否	选项文本或 JSON 数组
`more`	boolean	否	`true` 返回多个结果

请求示例

curl -G 'https://cx.ocyo.cn/api/queryyx.php' \
  --data-urlencode 'token=YOUR_TOKEN' \
  --data-urlencode 'title=下列哪项正确？' \
  --data-urlencode 'type=single'

成功响应

{"code":1,"data":{"question":"下列哪项正确？","answer":"正确选项","times":99},"message":"请求成功"}

查询余额

GETPOST/api/checkLeft.php

请求参数

名称	类型	必填	说明
`token`	string	是	用户 API Key，可放在查询串或表单中

成功响应

{"code":1,"data":100,"msg":""}

导入 JSON 题库

导入智慧树题目数据。仅允许有效用户 Token；请求体须包含 data.aiExamQuestionInfo。

POST/api/import_json.php

请求参数 · application/json

名称	类型	必填	说明
`token`	string	是	用户 API Key
`json_text`	object / string	是	包含 `data.aiExamQuestionInfo` 的原始题库数据

请求示例

{"token":"YOUR_TOKEN","json_text":{"data":{"aiExamQuestionInfo":[]}}}