案例语义检索接口

3. 请求参数（Body）

3.1 字段说明

3.1.1 wenshu_filter字段说明

以下字段均为可选字段

3.1.2 文书种类编码（wszl 元素）

4. 返回信息

- 返回类型：JSON 字符串

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

- 响应状态码说明

4.1 通用返回结构

4.2extra对象的wenshu字段，包含

- 接口名称：案例语义检索接口

- 接口用途：根据自然语言 query 在案例库中进行语义相似度检索，默认同时覆盖普通案例和权威案例，支持通过 wenshu_filter 按案件类别、案由、文书类型、法院、地域、结案日期及典型案例等条件过滤，并返回整理后的完整案例内容（不等同于原始裁判文书逐字全文）及相似度评分。

2. 请求信息

- HTTP Method：POST

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

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

- X-API-Key：你的api_key

- 请求体：JSON

3. 请求参数（Body）

3.1 字段说明

3.1.1 wenshu_filter字段说明

以下字段均为可选字段

3.1.2 文书种类编码（wszl 元素）

4. 返回信息

- 返回类型：JSON 字符串

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

- 响应状态码说明

4.1 通用返回结构

4.2extra对象的wenshu字段，包含

5. 示例

5.1 请求示例

{
  "query": "入户盗窃",
  "rewrite_flag": false,
  "wenshu_filter": {
    "wszl": ["1"],
    "ja_start": "2015-01-01",
    "ja_end": "2025-01-01",
    "wenshu_type":"刑事案件",
    "dianxing": false,
    "fayuan": ["北京市第一中级人民法院"],
    "cj": "中级",
    "xzqh_p": "北京"
  }
}

5.2 成功响应示例

{
    "msg": "成功(返回结构化数据)",
    "code": 201,
    "answer": "",
    "extra": {
        "wenshu": [
            {
                "type": 2,
                "scid": "b5c63a4ec01df9495b6b9024bf0a2bee",
                "spcx": "二审案件",
                "ajlb": "刑事案件",
                "jbdw": "北京市第一中级人民法院",
                "title": "吕江波盗窃二审刑事判决书",
                "jand": 2019,
                "jaDate": 20191223,
                "xzqh_c": "一中院",
                "wszl": "判决书",
                "para_name": "总结",
                "ah": "（2019）京01刑终629号",
                "ay": [
                    "201"
                ],
                "content": "本案的案件基本事实为：被告人吕江波在湖北省黄石市三江共和城铜锣湾广场售楼部更衣室内，通过脚踩方式使被害人杨某掉落的信用卡等物品未被发现，随后非法占有并使用这些信用卡进行了取款，共计取款人民币8000元。吕江波的家属后来代其赔偿了被害人14000元，得到了被害人的谅解。吕江波的行为最终被认定为盗窃信用卡并使用，构成盗窃罪。本案争议焦点在于原审被告人吕江波的行为是否构成信用卡诈骗罪以及是否应当对其盗窃行为进行重新定罪量刑。法院认为，吕江波实施了窃取他人财物的行为，数额较大，其行为符合盗窃罪的构成要件，而非信用卡诈骗罪。一审判决将吕江波的行为错误地定性为信用卡诈骗罪，并据此作出数罪并罚的判决，属于法律适用错误，应予以纠正。同时，考虑到吕江波到案后能如实供述自己的罪行，自愿签署认罪认罚具结书，并在案发后通过家属帮助退赔全部涉案赃款，获得被害人谅解，依法可以从轻处罚。然而，鉴于吕江波多次实施盗窃，包括入户盗窃，这一情节在量刑时必须予以充分考虑。综合考量吕江波犯罪的事实、性质、情节及其行为对社会的危害程度，法院依法改判其构成盗窃罪，并根据相关法律规定调整了刑罚，确保判决公正合理。被告人以非法占有为目的，实施盗窃行为，数额较大，构成盗窃罪，应予惩处。若被告人到案后如实供述罪行，签署认罪认罚具结书，并在亲属协助下退赔全部赃款且获得被害人谅解，可依法从宽处罚；但多次盗窃或入户盗窃的情节应在量刑时予以考量。争议焦点1：原审被告人吕江波的行为是否构成盗窃罪而非信用卡诈骗罪。",
                "xzqh_p": "北京",
                "cj": "中级",
                "score": 1.0098828125000001,
                "authority": "",
                "db": "精选案例库",
                "anyou": [
                    "盗窃罪"
                ]
            },
            {
                "type": 2,
                "scid": "3f186a2590ab411f2fedcd003caf9c1e",
                "spcx": "二审案件",
                "ajlb": "刑事案件",
                "jbdw": "北京市第一中级人民法院",
                "title": "汪传国盗窃二审刑事判决书",
                "jand": 2019,
                "jaDate": 20190322,
                "xzqh_c": "一中院",
                "wszl": "判决书",
                "para_name": "总结",
                "ah": "（2019）京01刑终124号",
                "ay": [
                    "201"
                ],
                "content": "本案的案件基本事实为：2018年6月29日凌晨，汪传国在北京石景山区模式口村28号院内先后窃取了张某1的苹果牌Iphone6SPLUS手机一部及少量现金，以及郭某的两部手机（白色华为牌NOVA青春型手机一部，价值780元；苹果牌黑色Iphone8PLUS手机一部，价值4400元）和现金22100元。同年7月12日，汪传国被抓获，但赃款赃物未能追回。汪传国家属事后分别向张某1和郭某进行了部分经济补偿并获得了谅解。二审期间，汪传国未能提供新证据支持其未盗窃郭某现金的主张，相关证据足以证实其盗窃金额。本案争议焦点在于上诉人汪传国是否构成盗窃罪以及其刑事责任的确定。法院认为，汪传国以非法占有为目的，实施了入户盗窃他人财物的行为，且涉案金额较大，其行为符合盗窃罪的构成要件，依法应予惩处。此外，汪传国曾因盗窃罪被判刑，刑满释放后五年内再次实施盗窃行为，属于累犯，依法应从重处罚。然而，考虑到汪传国到案后如实供述了部分犯罪事实，积极退赔被害人部分损失并获得谅解，依法可以从轻处罚。综上所述，一审法院认定汪传国犯盗窃罪的事实清楚，证据确凿，定罪准确，量刑适当，审判程序合法，但未依法责令汪传国退赔全部违法所得，存在不当之处，需予以纠正。以非法占有为目的实施入户盗窃，数额较大的，构成盗窃罪，依法应予惩处。若行为人系累犯，即曾因盗窃罪被判处有期徒刑，刑罚执行完毕后五年内再犯应判处有期徒刑以上刑罚之罪的，依法应从重处罚。同时，行为人如实供述犯罪事实，积极退赔被害人损失并获得谅解的，依法可以从轻处罚。法院在判决时需考虑犯罪事实、性质、情节及对社会的危害程度，确保量刑适当。",
                "xzqh_p": "北京",
                "cj": "中级",
                "score": 0.9608060420000001,
                "authority": "",
                "db": "精选案例库",
                "anyou": [
                    "盗窃罪"
                ]
            }
        ]
    },
    "messageId": "",
    "style": "",
    "request_id": ""
}

6. 代码示例

6.1 CURL

curl --location --request POST 'https://open.chineselaw.com/open/case_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,"wenshu_filter":{"wszl":["1"],"ja_start":"2015-01-01","ja_end":"2025-01-01","wenshu_type":"刑事案件","fayuan":["北京市第一中级人民法院"],"cj":"中级","xzqh_p":"北京","dianxing":false},"return_num":2}'

6.2 Python

import requests

url = "https://open.chineselaw.com/open/case_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,
    "wenshu_filter": {
        "wszl": ["1"],
        "ja_start": "2015-01-01",
        "ja_end": "2025-01-01",
        "wenshu_type": "刑事案件",
        "fayuan": ["北京市第一中级人民法院"],
        "cj": "中级",
        "xzqh_p": "北京",
        "dianxing": False,
    },
    "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/case_vector_search";
        String body = "{\"query\":\"入户盗窃\",\"rewrite_flag\":false,\"wenshu_filter\":"
                + "{\"wszl\":[\"1\"],\"ja_start\":\"2015-01-01\",\"ja_end\":\"2025-01-01\","
                + "\"wenshu_type\":\"刑事案件\",\"fayuan\":[\"北京市第一中级人民法院\"],"
                + "\"cj\":\"中级\",\"xzqh_p\":\"北京\",\"dianxing\":false},\"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/case_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,
    wenshu_filter: {
      wszl: ["1"],
      ja_start: "2015-01-01",
      ja_end: "2025-01-01",
      wenshu_type: "刑事案件",
      fayuan: ["北京市第一中级人民法院"],
      cj: "中级",
      xzqh_p: "北京",
      dianxing: false,
    },
    return_num: 2,
  }),
});

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