法律法规语义检索接口 API 文档

3. 请求参数（Body）

3.1 字段说明

3.1.1 fatiao_filter字段说明

以下字段均为可选字段

3.1.2 时效性类别（sxx）

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

4. 返回信息

4.1 通用返回结构

4.2extra对象的fatiao字段，包含

1. 基本信息

- 接口名称：法律法规语义检索接口

- 接口用途：对法律法规进行语义检索，支持传入各类筛选项，返回语义相关的法律法规列表。

2. 请求信息

- HTTP Method：POST

- URL：https://open.chineselaw.com/open/law_vector_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 字符串

- 成功/失败判断：看 msg 与 code（HTTP 401为鉴权失败）

4.1 通用返回结构

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

5. 示例

5.1 请求示例

{
  "query": "入户盗窃",
  "rewrite_flag": false,
  "fatiao_filter": {
    "effect1": ["01"],
    "sxx": ["现行有效"],
    "law_start": "2018-01-01",
    "law_end": "2025-12-31"
  }
}

5.2 成功响应示例

{
    "msg": "成功(返回结构化数据)",
    "code": 201,
    "answer": "",
    "extra": {
        "fatiao": [
            {
                "ftid": "aecabfbe6b0843642509a7f1ff865413_264",
                "fgid": "aecabfbe6b0843642509a7f1ff865413",
                "fgtitle": "中华人民共和国刑法(2023修正)",
                "num": "第二百六十四条",
                "content": "　【盗窃罪】盗窃公私财物，数额较大的，或者多次盗窃、入户盗窃、携带凶器盗窃、扒窃的，处三年以下有期徒刑、拘役或者管制，并处或者单处罚金；数额巨大或者有其他严重情节的，处三年以上十年以下有期徒刑，并处罚金；数额特别巨大或者有其他特别严重情节的，处十年以上有期徒刑或者无期徒刑，并处罚金或者没收财产。",
                "sxx": "现行有效",
                "effect1": "法律",
                "tag": [],
                "effect2": "法律",
                "location": "中央",
                "start": 20240301,
                "end": 99999999,
                "dy": "中央",
                "score": 1.107480312,
                "type": 1
            },
            {
                "ftid": "aecabfbe6b0843642509a7f1ff865413_263",
                "fgid": "aecabfbe6b0843642509a7f1ff865413",
                "fgtitle": "中华人民共和国刑法(2023修正)",
                "num": "第二百六十三条",
                "content": "　【抢劫罪】以暴力、胁迫或者其他方法抢劫公私财物的，处三年以上十年以下有期徒刑，并处罚金；有下列情形之一的，处十年以上有期徒刑、无期徒刑或者死刑，并处罚金或者没收财产：\n（一）入户抢劫的；\n（二）在公共交通工具上抢劫的；\n（三）抢劫银行或者其他金融机构的；\n（四）多次抢劫或者抢劫数额巨大的；\n（五）抢劫致人重伤、死亡的；\n（六）冒充军警人员抢劫的；\n（七）持枪抢劫的；\n（八）抢劫军用物资或者抢险、救灾、救济物资的。",
                "sxx": "现行有效",
                "effect1": "法律",
                "tag": [],
                "effect2": "法律",
                "location": "中央",
                "start": 20240301,
                "end": 99999999,
                "dy": "中央",
                "score": 0.6297119999999999,
                "type": 1
            }
        ]
    },
    "messageId": "",
    "style": "",
    "request_id": ""
}

6. 代码示例

6.1 CURL

curl --location --request POST 'https://open.chineselaw.com/open/law_vector_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":["01"],"law_start":"2018-01-01","law_end":"2025-12-31","sxx":["现行有效"]},"return_num":2}'

6.2 Python

import requests

url = "https://open.chineselaw.com/open/law_vector_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": ["01"],
        "law_start": "2018-01-01",
        "law_end": "2025-12-31",
        "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_search";
        String body = "{\"query\":\"入户盗窃\",\"rewrite_flag\":false,\"fatiao_filter\":"
                + "{\"effect1\":[\"01\"],\"law_start\":\"2018-01-01\",\"law_end\":\"2025-12-31\","
                + "\"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_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: ["1"],
      law_start: "2018-01-01",
      law_end: "2025-12-31",
      wenshu_type: "刑事案件",
      sxx: ["现行有效"],
    },
    return_num: 2,
  }),
});

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