证券行业法律法规语义检索接口 API 文档

3. 请求参数（Body）

3.1 字段说明

3.1.1 fatiao_filter字段说明

> 以下字段均为可选字段

3.1.2 时效性类别（sxx）

3.1.3 一级效力级别类别（effect1）

4. 返回信息

- 返回类型：JSON 字符串

- 成功/失败判断：请求响应状态码

- 响应状态码说明

4.1 通用返回结构

4.2 **extra对象的fatiao**字段，包含

1. 基本信息

- 接口名称：证券行业法律法规语义检索接口

- 接口用途：按自然语言query做证券行业相关法条级语义检索，可按时效性、一级效力级别和实施日期范围过滤。返回结果在extra.fatiao，每条主要是法条内容及所属法规信息，不是整部法规全文列表；如需法规详情需再用法规 ID 调详情接口。

2. 请求信息

- HTTP Method：POST

- URL：https://open.chineselaw.com/open/law_vector_zq_search

- Content-Type：application/json; charset=utf-8

- X-API-Key：你的api_key

- 请求体：JSON

3. 请求参数（Body）

3.1 字段说明

3.1.1 fatiao_filter字段说明

> 以下字段均为可选字段

3.1.2 时效性类别（sxx）

3.1.3 一级效力级别类别（effect1）

4. 返回信息

- 返回类型：JSON 字符串

- 成功/失败判断：请求响应状态码

- 响应状态码说明

4.1 通用返回结构

4.2 **extra对象的fatiao**字段，包含

5. 示例

5.1 请求示例

{
    "query": "内幕交易",
    "rewrite_flag": false,
    "fatiao_filter": {
        "effect1": ["法律"],
        "sxx": ["现行有效"]
    },
    "return_num": 2
}

5.2 成功响应示例

{
    "msg": "成功(返回结构化数据)",
    "code": 201,
    "answer": "",
    "extra": {
        "fatiao": [
            {
                "url": "https://ydzk.chineselaw.com/zxt/statuteDetail/detailPage/f74ea8ee4b09a918a3dea5c7d151514b?text=14",
                "ftid": "f74ea8ee4b09a918a3dea5c7d151514b_14",
                "fgid": "f74ea8ee4b09a918a3dea5c7d151514b",
                "fgtitle": "中华人民共和国期货和衍生品法",
                "num": "第十四条",
                "content": "　本法所称内幕信息，是指可能对期货交易或者衍生品交易的交易价格产生重大影响的尚未公开的信息。 \n期货交易的内幕信息包括： \n（一）国务院期货监督管理机构以及其他相关部门正在制定或者尚未发布的对期货交易价格可能产生重大影响的政策、信息或者数据； \n（二）期货交易场所、期货结算机构作出的可能对期货交易价格产生重大影响的决定； \n（三）期货交易场所会员、交易者的资金和交易动向； \n（四）相关市场中的重大异常交易信息； \n（五）国务院期货监督管理机构规定的对期货交易价格有重大影响的其他信息。",
                "sxx": "现行有效",
                "effect1": "法律",
                "tag": [
                    "证券行业法规"
                ],
                "effect2": "法律",
                "location": "中央",
                "start": 20220801,
                "end": 99999999,
                "dy": "中央",
                "score": 1.1926545599999998,
                "type": 1
            },
            {
                "url": "https://ydzk.chineselaw.com/zxt/statuteDetail/detailPage/f60152fce037dbb27c49045cb502bde7?text=52",
                "ftid": "f60152fce037dbb27c49045cb502bde7_52",
                "fgid": "f60152fce037dbb27c49045cb502bde7",
                "fgtitle": "中华人民共和国证券法(2019修订)",
                "num": "第五十二条",
                "content": "　证券交易活动中，涉及发行人的经营、财务或者对该发行人证券的市场价格有重大影响的尚未公开的信息，为内幕信息。 \n本法第八十条第二款、第八十一条第二款所列重大事件属于内幕信息。",
                "sxx": "现行有效",
                "effect1": "法律",
                "tag": [
                    "财税##金融证券法规##证券法规",
                    "财税##金融证券法规",
                    "财税##其他法律法规##其他法律",
                    "企业法##证券、债券",
                    "财税##金融证券法规##证券法规##证监会",
                    "财税##其他法律法规",
                    "财税",
                    "企业法",
                    "证券行业法规",
                    "上市公司法",
                    "上市公司法##上市公司"
                ],
                "effect2": "法律",
                "location": "中央",
                "start": 20200301,
                "end": 99999999,
                "dy": "中央",
                "score": 1.1910819,
                "type": 1
            }
        ]
    },
    "messageId": "",
    "style": "",
    "request_id": ""
}

6. 代码示例

6.1 CURL

curl --location --request POST 'https://open.chineselaw.com/open/law_vector_zq_search' \
--header 'X-API-Key: 你的api_key' \
--header 'Content-Type: application/json; charset=utf-8' \
--header 'Accept: application/json' \
--data-raw '{"query":"内幕交易","rewrite_flag":false,"fatiao_filter":{"effect1":["法律"],"sxx":["现行有效"]},"return_num":2}'

6.2 Python

import requests

url = "https://open.chineselaw.com/open/law_vector_zq_search"
API_KEY = "你的api_key"
headers = {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json; charset=utf-8",
    "Accept": "application/json",
}
payload = {
    "query": "内幕交易",
    "rewrite_flag": False,
    "fatiao_filter": {
        "effect1": ["法律"],
        "sxx": ["现行有效"],
    },
    "return_num": 2,
}

response = requests.post(url, json=payload, headers=headers, timeout=60)
response.raise_for_status()
print(response.json())

6.3 Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;

class CaseVectorSearchExample {

    static void main(String[] args) throws Exception {
        String apiKey = "你的api_key";
        String url = "https://open.chineselaw.com/open/law_vector_zq_search";
        String body = "{\"query\":\"内幕交易\",\"rewrite_flag\":false,\"fatiao_filter\":"
                + "{\"effect1\":[\"法律\"],"
                + "\"sxx\":[\"现行有效\"]},\"return_num\":2}";

        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(url))
                .timeout(Duration.ofSeconds(60))
                .header("X-API-Key", apiKey)
                .header("Content-Type", "application/json; charset=utf-8")
                .header("Accept", "application/json")
                .POST(HttpRequest.BodyPublishers.ofString(body))
                .build();

        HttpClient client = HttpClient.newHttpClient();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

6.4 JavaScript

const API_KEY = "你的api_key";
const url = "https://open.chineselaw.com/open/law_vector_zq_search";

const res = await fetch(url, {
  method: "POST",
  headers: {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json; charset=utf-8",
    "Accept": "application/json",
  },
  body: JSON.stringify({
    query: "内幕交易",
    rewrite_flag: false,
    fatiao_filter: {
      effect1: ["法律"],
      sxx: ["现行有效"],
    },
    return_num: 2,
  }),
});

if (!res.ok) throw new Error(`HTTP NULL`);
console.log(await res.json());