API DETAIL

证券著作语义检索

对图书正文做 hybrid(dense + sparse)语义检索,支持可选的问题改写与过滤条件。返回按相关度降序的**正文命中片段**,最多 45 条。 **能力边界**:返回的是按问题召回的片段,不是整书、也不是完整章节;章节与页码是返回字段,不能作为检索或过滤条件。

分类:证券合规 方法:POST

首屏摘要

接口名称证券著作语义检索
接口描述对图书正文做 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 上游检索超时

使用建议

  1. 问题越具体,命中越准。带明确法律概念的问题(如「内幕交易的认定标准」)效果好于宽泛提问。
  2. 需要限定书目时传 filters.isbn;传了过滤条件而返回空数组时,不要放宽条件重试,先确认 ISBN 是否正确。
  3. 返回 45 条是上游上限,调用方如需精简,可按 score 自行截断。
  4. 同一问题重复调用可能重复计费,客户端应做缓存。