Get Started

相关信息

柠檬题库是集智能搜题和高效API对接于一体的综合服务平台。我们旨在为用户提供广泛的题库资源和快速精准的题目搜索体验。不论是学生、教师还是开发者，都可以在我们的平台上找到所需的学习和项目资源。通过我们灵活的API接口，您可以将题库功能无缝集成到您的应用程序或网站中，提升用户体验。

说明

重要

我们提供两种查题接口，即普通搜索接口、高级搜索接口，区别如下：

接口类型	携带TOKEN	是否免费	是否限流	是否题库差异
普通查询	×	√	√	×
普通查询	√	×	×	×
高级查询	√	×	×	×

TODO:我们将在近期增加AI搜索接口

对接域名

重要

各对接网址所用CDN服务器均在香港、日本及新加坡，如国内访问缓慢、无法打开，请自行准备科学上网工具

https://api.lemtk.xyz
https://api.vanse.top 推荐

普通查询(api/v1/cx)

相关信息

普通查询接口，支持GET\POST请求，不设置Headers参数Authorization即可免费调用

URL路径 /api/v1/cx

全局Headers

字段名	示例值	必选	类型	说明
Content-Type	application/json	是	string	无
Authorization	Bearer f75ab8bb39ff57c5cb4b4c7565982fe4	否	string	Bearer {Token} 示例：Bearer f75ab8bb39ff57c5cb4b4c7565982fe4 此项为空即为免费查询

GET方式

Query参数

参数名	示例值	必选	类型	说明
question	皂苷在（）中溶解性较大。	是	string	问题题干
type	1	否	string	问题类型，单选题: 0, 多选题: 1, 填空题: 2, 判断题: 3, 简答题: 4
options	热水\|含水稀醇\|热乙醇\|乙醚	否	string	所有选项，以“\|”隔开

请求示例

JavaScript-JQuery

var settings = {
  "url": "https://api.lemtk.xyz/api/v1/cx?question=皂苷在（ ）中溶解性较大。&type=1&options=热水|含水稀醇|热乙醇|乙醚",
  "method": "GET",
  "timeout": 0,
  "headers": {
    "Content-Type": "application/json",
    // "Authorization": "Bearer f75ab8bb39ff57c5cb4b4c7565982fe4" // 可选
  },
};

$.ajax(settings).done(function (response) {
  console.log(response);
});

Python-Requests

import requests
import json

url = "https://api.lemtk.xyz/api/v1/cx?question=皂苷在（ ）中溶解性较大。&type=1&options=热水|含水稀醇|热乙醇|乙醚"

payload = {}
headers = {
  'Content-Type': 'application/json',
  # 'Authorization': 'Bearer f75ab8bb39ff57c5cb4b4c7565982fe4' # 可选
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

成功返回示例

{
    "code": 1000,
    "msg": "success",
    "data": {
        "answer": "热水#含水稀醇#热乙醇"
    }
}

POST方式

body参数

参数名	示例值	必选	类型	说明
v	1.0	是	string	无
question	皂苷在（）中溶解性较大。	是	string	问题题干
type	1	否	string	问题类型，单选题: 0, 多选题: 1, 填空题: 2, 判断题: 3, 简答题: 4
options	热水\|含水稀醇\|热乙醇\|乙醚	否	string	所有选项，以“\|”隔开

请求示例

JavaScript-JQuery

var settings = {
  "url": "https://api.lemtk.xyz/api/v1/cx",
  "method": "POST",
  "timeout": 0,
  "headers": {
    "Content-Type": "application/json",
    // "Authorization": "Bearer f75ab8bb39ff57c5cb4b4c7565982fe4" // 可选
  },
  "data": JSON.stringify({
    "v": "1.0",
    "question": "皂苷在（ ）中溶解性较大。",
    "type": "1",
    "options": "热水|含水稀醇|热乙醇|乙醚"
  }),
};

$.ajax(settings).done(function (response) {
  console.log(response);
});

Python-Requests

import requests
import json

url = "https://api.lemtk.xyz/api/v1/cx"

payload = json.dumps({
  "v": "1.0",
  "question": "皂苷在（ ）中溶解性较大。",
  "type": "1",
  "options": "热水|含水稀醇|热乙醇|乙醚"
})
headers = {
  'Content-Type': 'application/json',
  # 'Authorization': 'Bearer f75ab8bb39ff57c5cb4b4c7565982fe4' # 可选
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

成功返回示例

{
    "code": 1000,
    "msg": "success",
    "data": {
        "answer": "热水#含水稀醇#热乙醇"
    }
}

高级搜索(api/v1/mcx)

相关信息

高级查询接口，支持GET\POST请求，此接口可在题目发生改变时更容易命中题库，提高题库命中率

URL路径 /api/v1/mcx

全局Headers

字段名	示例值	必选	类型	说明
Content-Type	application/json	是	string	无
Authorization	Bearer f75ab8bb39ff57c5cb4b4c7565982fe4	是	string	Bearer {Token} 示例：Bearer f75ab8bb39ff57c5cb4b4c7565982fe4

GET方式

Query参数

参数名	示例值	必选	类型	说明
question	皂苷在（）中溶解性较大。	是	string	问题题干
type	1	否	string	问题类型，单选题: 0, 多选题: 1, 填空题: 2, 判断题: 3, 简答题: 4
options	热水\|含水稀醇\|热乙醇\|乙醚	否	string	所有选项，以“\|”隔开

请求示例

JavaScript-JQuery

var settings = {
  "url": "https://api.lemtk.xyz/api/v1/cx?question=皂苷在（ ）中溶解性较大。&type=1&options=热水|含水稀醇|热乙醇|乙醚",
  "method": "GET",
  "timeout": 0,
  "headers": {
    "Content-Type": "application/json",
    "Authorization": "Bearer f75ab8bb39ff57c5cb4b4c7565982fe4" // 必填
  },
};

$.ajax(settings).done(function (response) {
  console.log(response);
});

Python-Requests

import requests
import json

url = "https://api.lemtk.xyz/api/v1/mcx?question=皂苷在（ ）中溶解性较大。&type=1&options=热水|含水稀醇|热乙醇|乙醚"

payload = {}
headers = {
  'Content-Type': 'application/json',
  'Authorization': 'Bearer f75ab8bb39ff57c5cb4b4c7565982fe4' # 必填
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

成功返回示例

{
    "code": 1000,
    "msg": "success",
    "data": {
        "answer": "热水#含水稀醇#热乙醇"
    }
}

POST方式

body参数

参数名	示例值	必选	类型	说明
v	1.0	是	string	无
question	皂苷在（）中溶解性较大。	是	string	问题题干
type	1	否	string	问题类型，单选题: 0, 多选题: 1, 填空题: 2, 判断题: 3, 简答题: 4
options	热水\|含水稀醇\|热乙醇\|乙醚	否	string	所有选项，以“\|”隔开

请求示例

JavaScript-JQuery

var settings = {
  "url": "https://api.lemtk.xyz/api/v1/mcx",
  "method": "POST",
  "timeout": 0,
  "headers": {
    "Content-Type": "application/json",
    // "Authorization": "Bearer f75ab8bb39ff57c5cb4b4c7565982fe4" // 可选
  },
  "data": JSON.stringify({
    "v": "1.0",
    "question": "皂苷在（ ）中溶解性较大。",
    "type": "1",
    "options": "热水|含水稀醇|热乙醇|乙醚"
  }),
};

$.ajax(settings).done(function (response) {
  console.log(response);
});

Python-Requests

import requests
import json

url = "https://api.lemtk.xyz/api/v1/mcx"

payload = json.dumps({
  "v": "1.0",
  "question": "皂苷在（ ）中溶解性较大。",
  "type": "1",
  "options": "热水|含水稀醇|热乙醇|乙醚"
})
headers = {
  'Content-Type': 'application/json',
  'Authorization': 'Bearer f75ab8bb39ff57c5cb4b4c7565982fe4' # 必填
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

成功返回示例

{
    "code": 1000,
    "msg": "success",
    "data": {
        "answer": "热水#含水稀醇#热乙醇"
    }
}

余额查询(api/v1/balance)

注意

由于系统计费采用队列，受队列数据堆积等影响，此接口并非返回实时余额，故此接口返回余额仅供参考，具体以系统对接信息面板显示为准。

相关信息

余额查询接口，此接口仅支持GET方式，查询剩余调用点数，请合理使用该接口，频繁调用视情况封禁账号及IP地址

URL路径 api/v1/balance

GET方式

Query参数

参数名	示例值	必选	类型	说明
email	12345678@qq.com	是	string	题库注册邮箱
token	f75ab8bb39ff57c5cb4b4c7565982fe4	是	string	题库Token

请求示例

JavaScript-JQuery

var settings = {
  "url": "https://api.lemtk.xyz/api/v1/balance?email=1234578@qq.com&token=f75ab8bb39ff57c5cb4b4c7565982fe4",
  "method": "GET",
  "timeout": 0,
};

$.ajax(settings).done(function (response) {
  console.log(response);
});

Python-Requests

import requests

url = "https://api.lemtk.xyz/api/v1/balance?email=12345678@qq.com&token=f75ab8bb39ff57c5cb4b4c7565982fe4"

payload = {}
headers = {}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

成功返回示例

{
    "code": 1000,
    "msg": "success",
    "data": {
        "balance": 8297, // 余额
        "ban": 0, 
        "email": "12345678@qq.com"
    }
}

接入示例（OCS脚本）

以下内容仅作推荐，不提供任何有关于脚本问题的解答服务
OCS官网：https://docs.ocsjs.com
OCS题库配置文档：https://docs.ocsjs.com/docs/other/api#answererwrapper-题库配置
OCS脚本托管地址：https://scriptcat.org/zh-CN/script-show-page/367 OCS全域名通用版脚本托管地址：https://scriptcat.org/zh-CN/script-show-page/1398
关于最近无法显示脚本的问题解决方法：https://docs.ocsjs.com/docs/issues/2024-11

对接流程

前期准备

确保浏览器可以正常运行任何油猴脚本：https://docs.ocsjs.com/docs/issues/2024-11
安装OCS脚本：https://scriptcat.org/zh-CN/script-show-page/367

登录题库获取题库配置
编辑OCS题库配置

将复制的题库配置粘贴到框内
点击确定后会弹出一下内容,复制图中域名（api.lemtk.xyz）

OCS全域名通用版进行如下处理

刷新页面，等待出现如下页面如弹出以下页面（图1），请选择永久允许此域名，如未弹出但现实连接成功（如下图2），即可正常使用。如未弹出且显示连接失败（如下图3），请删除ocs脚本重新安装并配置题库。

图1
图2
图3

OCS脚本普通版进行如下处理

修改脚本代码，在代码中加入// @connect lemtk.xyz，按ctrl+s保存即可

提示

注：答题间隔最好控制在5s以上，否则可能会被防火墙拉黑，导致题库连接失败。

其他已接入程序

相关信息

类型	名字	项目地址
GO程序	大学生网课题库接口适配器	Github
Python程序	超星学习通答题姬(CxKitty)	Github
油猴脚本	OCS 网课助手	ScriptCat
油猴脚本	SuperStar小助手	ScriptCat

Tips：获取展示请Email我们