证券著作语义检索
对图书正文做 hybrid(dense + sparse)语义检索,支持可选的问题改写与过滤条件。返回按相关度降序的**正文命中片段**,最多 45 条。 **能力边界**:返回的是按问题召回的片段,不是整书、也不是完整章节;章节与页码是返回字段,不能作为检索或过滤条件。
首屏摘要
| 接口名称 | 证券著作语义检索 |
|---|---|
| 接口描述 | 对图书正文做 hybrid(dense + sparse)语义检索,支持可选的问题改写与过滤条件。返回按相关度降序的**正文命中片段**,最多 45 条。 **能力边界**:返回的是按问题召回的片段,不是整书、也不是完整章节;章节与页码是返回字段,不能作为检索或过滤条件。 |
| 分类 | 证券合规 |
| 调用地址 | https://open.chineselaw.com/open/search_securities_books |
| 文档摘要 | 证券著作检索 接口说明 面向证券合规场景的图书语义检索接口。输入一段自然语言问题,在出版社授权书库中按语义相似度返回书籍正文片段,可直接用于法条之外的学理支撑、观点引用与出处标注。 返回的是**书籍正文片段**,不是整本书、不是完整章节,也不是法规条文原文;引用时应注明为图书检索片段,并同时给出书名、章节与印刷页码。 请求地址 POST https://open.chineselaw.com/open/search_securities_books Content-Type… |
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| question | string | 是 | 检索问题,自然语言描述,不能为空白,最多 2000 个字符 |
| rewriteFlag | boolean | 否 | 是否先对问题做改写再检索,默认 true;传 false 则使用原始问题检索 |
| denseWeight | number | 否 | 稠密向量检索权重,取值 0~1,默认 0.6 |
| sparseWeight | number | 否 | 稀疏检索权重,取值 0~1,默认 0.4 |
| filters | object | 否 | 过滤条件,多个条件之间为 AND 关系,不传则检索账户可访问的全部书目 |
filters 支持的字段
| 字段名 | 类型 | 说明 |
|---|---|---|
| isbn | string 或 string[] | ISBN,需带连字符,例如 978-7-5764-1901-6 |
| title | string 或 string[] | 书名 |
| author | string 或 string[] | 作者 |
| ztfl | string 或 string[] | 中图分类号 |
| book_category | string 或 string[] | 图书类别 |
| law_department | string 或 string[] | 法学部门 |
| publish_date | int、int[] 或范围对象 | 出版年份,格式 YYYY |
| copyright_expire_date | int、int[] 或范围对象 | 版权到期日,格式 YYYYMMDD |
范围对象支持 gt、gte、lt、lte 以及 between: [下限, 上限],多个约束之间为 AND。
注意:字符串字段不能做范围过滤;未知字段、空数组、对数值字段传字符串均返回 400。
响应参数
| 字段 | 类型 | 说明 |
|---|---|---|
| code | int | 业务状态码,200 表示成功 |
| message | string | 提示信息,成功时为 success |
| data | array | 命中片段列表,最多 45 条;无命中时为空数组,属正常结果 |
| data[].id | long | 片段唯一标识 |
| data[].score | number | 相似度得分,越大越相关 |
| data[].scid | string | 卷册唯一标识,同一本书的片段 scid 相同 |
| data[].title | string | 书名 |
| data[].author | string | 作者 |
| data[].isbn | string | ISBN |
| data[].publishDate | int | 出版年份 |
| data[].price | string | 定价 |
| data[].pageCount | string | 总页数 |
| data[].ztfl | string | 中图分类号 |
| data[].bookCategory | string | 图书类别 |
| data[].lawDepartment | string | 法学部门 |
| data[].buyLink | string | 购买链接 |
| data[].sectionTitle | string | 命中的章节标题 |
| data[].pdfName | string | 源文件名称 |
| data[].printedPageStart | string | 印刷版起始页 |
| data[].printedPageEnd | string | 印刷版结束页 |
| data[].content | string | 命中的正文片段,不是整章或整书全文 |
| timestamp | long | 服务器时间戳,毫秒 |
字段说明:除 id、score、publishDate 外,其余字段均为字符串类型,可能缺失、为 null 或空串,调用方需做容错。印刷页以 printedPageStart / printedPageEnd 为准,不使用 pdfName 或物理页码替代。
错误码
| 错误码 | 说明 |
|---|---|
| 400 | 请求参数不合法:question 为空或超过 2000 字符、JSON 格式错误、filters 字段或类型不支持、数值范围写法错误 |
| 401 | 鉴权失败:缺少 X-API-Key,或 API Key 无效、已过期、已禁用 |
| 403 | 内部服务鉴权失败:服务端转发配置异常,与调用方参数无关,请联系平台 |
| 404 | 接口不存在:请确认请求路径为 /open/book_search,且使用 POST 方法 |
| 429 | 请求过于频繁:触发平台限流,请降低频率后重试 |
| 500 | 服务异常:网关或后端处理失败,可凭响应头 x-request-id 联系平台排查 |
| 502 | 上游检索服务返回异常或连接失败 |
| 503 | 检索服务暂不可用:上游未配置或额度不足 |
| 504 | 上游检索超时:可稍后重试,重试可能产生重复计费 |
调用示例
CURL
curl --location --request POST 'https://open.chineselaw.com/open/search_securities_books' \
--header 'X-API-Key: 你的api_key' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
"question": "内幕交易的认定标准与法律责任",
"rewriteFlag": true
}'JAVA
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;
import java.time.Duration;
public class BookSearchExample {
public static void main(String[] args) throws Exception {
String apiKey = "你的api_key";
String body = """
{
"question": "内幕交易的认定标准与法律责任",
"rewriteFlag": true
}
""";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://open.chineselaw.com/open/search_securities_books"))
.timeout(Duration.ofSeconds(60))
.header("X-API-Key", apiKey)
.header("Accept", "application/json")
.header("Content-Type", "application/json; charset=UTF-8")
.POST(HttpRequest.BodyPublishers.ofString(body, StandardCharsets.UTF_8))
.build();
HttpClient client = HttpClient.newHttpClient();
HttpResponse<String> response = client.send(
request, HttpResponse.BodyHandlers.ofString(StandardCharsets.UTF_8));
System.out.println(response.statusCode());
System.out.println(response.body());
}
}PYTHON
import requests
url = "https://open.chineselaw.com/open/search_securities_books"
API_KEY = "你的api_key"
headers = {
"X-API-Key": API_KEY,
"Accept": "application/json",
"Content-Type": "application/json",
}
payload = {
"question": "内幕交易的认定标准与法律责任",
"rewriteFlag": True,
"denseWeight": 0.6,
"sparseWeight": 0.4,
"filters": {
"isbn": ["978-7-5764-1901-6"]
},
}
response = requests.post(url, json=payload, headers=headers, timeout=60)
response.raise_for_status()
print(response.json())JAVASCRIPT
const API_KEY = "你的api_key";
const url = "https://open.chineselaw.com/open/search_securities_books";
const res = await fetch(url, {
method: "POST",
headers: {
"X-API-Key": API_KEY,
"Accept": "application/json",
"Content-Type": "application/json",
},
body: JSON.stringify({
question: "内幕交易的认定标准与法律责任",
rewriteFlag: true,
}),
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);
console.log(await res.json());
响应示例
{
"code": 200,
"message": "success",
"data": [
{
"id": 468773899904199767,
"score": 0.9936116790902788,
"scid": "855d9829bfb4ee511fc81858f51d50db",
"title": "上市公司法治论",
"author": "李东方著",
"isbn": "978-7-5764-1901-6",
"publishDate": 2025,
"price": "129.0",
"pageCount": "744",
"ztfl": "D",
"bookCategory": "教材",
"lawDepartment": "经济法",
"buyLink": "[https://lw3o9.xetlk.com/s/46taYP](https://lw3o9.xetlk.com/s/46taYP)",
"sectionTitle": "四、内幕交易行为的责任形式",
"pdfName": "1_上市公司法治论.pdf",
"printedPageStart": "689",
"printedPageEnd": "689",
"content": "我国《证券法》对内幕交易的行政责任也作了相应的规制,即证券交易内幕信息的知情人或者非法获取内幕信息的人违反《证券法》第53条的规定从事内幕交易的,责令依法处理非法持有的证券,没收违法所得……"
}
],
"timestamp": 1794305864133
}
完整文档
证券著作检索
接口说明
面向证券合规场景的图书语义检索接口。输入一段自然语言问题,在出版社授权书库中按语义相似度返回书籍正文片段,可直接用于法条之外的学理支撑、观点引用与出处标注。
返回的是书籍正文片段,不是整本书、不是完整章节,也不是法规条文原文;引用时应注明为图书检索片段,并同时给出书名、章节与印刷页码。
请求地址
POST https://open.chineselaw.com/open/search_securities_books
Content-Type: application/json
X-API-Key: 你的开放平台 API Key
只支持 POST,其他方法不保证可用。
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| question | string | 是 | 检索问题,非空白,最多 2000 字符 |
| rewriteFlag | boolean | 否 | 是否先改写问题,默认 true |
| denseWeight | number | 否 | 稠密向量权重,0~1,默认 0.6 |
| sparseWeight | number | 否 | 稀疏检索权重,0~1,默认 0.4 |
| filters | object | 否 | 过滤条件,多条件 AND |
filters 支持字段:isbn、title、author、ztfl、book_category、law_department(字符串或字符串数组);publish_date、copyright_expire_date(整数、整数数组或范围对象,支持 gt、gte、lt、lte、between)。
请求示例
{
"question": "内幕交易的认定标准与法律责任",
"rewriteFlag": false
}
响应说明
| 字段 | 类型 | 说明 |
|---|---|---|
| code | int | 200 表示成功 |
| message | string | 提示信息 |
| data | array | 命中片段,最多 45 条,可能为空数组 |
| data[].title | string | 书名 |
| data[].author | string | 作者 |
| data[].isbn | string | ISBN |
| data[].sectionTitle | string | 命中的章节标题 |
| data[].content | string | 命中的正文片段 |
| data[].printedPageStart | string | 印刷版起始页 |
| data[].printedPageEnd | string | 印刷版结束页 |
| data[].score | number | 相似度得分 |
| data[].scid | string | 卷册标识 |
| data[].publishDate | int | 出版年份 |
| data[].price | string | 定价 |
| data[].pageCount | string | 总页数 |
| data[].ztfl | string | 中图分类号 |
| data[].bookCategory | string | 图书类别 |
| data[].lawDepartment | string | 法学部门 |
| data[].buyLink | string | 购买链接 |
| data[].pdfName | string | 源文件名称 |
| data[].id | long | 片段标识 |
| timestamp | long | 服务器时间戳,毫秒 |
错误码
| 错误码 | 说明 |
|---|---|
| 400 | 请求参数不合法 |
| 401 | 鉴权失败,Key 缺失或无效 |
| 403 | 内部服务鉴权失败,服务端配置问题 |
| 404 | 接口不存在,检查路径与方法 |
| 429 | 触发限流 |
| 500 | 服务异常,可凭 x-request-id 排查 |
| 502 | 上游检索服务异常 |
| 503 | 检索服务暂不可用 |
| 504 | 上游检索超时 |
使用建议
- 问题越具体,命中越准。带明确法律概念的问题(如「内幕交易的认定标准」)效果好于宽泛提问。
- 需要限定书目时传 filters.isbn;传了过滤条件而返回空数组时,不要放宽条件重试,先确认 ISBN 是否正确。
- 返回 45 条是上游上限,调用方如需精简,可按 score 自行截断。
- 同一问题重复调用可能重复计费,客户端应做缓存。