以下字段均为可选字段，但 请求体不能为空（空 JSON 会返回失败）。

3.1 字段说明

3.2 校验与默认值（按代码）

• body 为空 JSON：返回失败 message = "请求参数不能为空"
• search_mode 非法：返回失败 message = "search_mode 不合法"
• search_mode 默认：未传或为空 -> and
• top_k 默认/上限：
  • top_k <= 0 -> 10
  • top_k > 50 -> 50

4.1 通用返回结构（ResultVO）

4.2 data 字段（命中时）

data 为对象，包含：

4.3 lst 单条元素字段

权威案例关键词检索接口

1. 基本信息

• 接口名称：权威案例关键词检索接口
• 接口用途：对“权威案例”库进行多条件/关键词检索，返回命中的案例列表（优先返回要旨/摘要）与命中总数。

2. 请求信息

• HTTP Method：POST
• URL：https://open.chineselaw.com/open/rh_qwal_search
• Content-Type：application/json; charset=utf-8
• Accept：application/json
• X-API-Key：你的api_key

3. 请求参数（Body）

以下字段均为可选字段，但 请求体不能为空（空 JSON 会返回失败）。

3.1 字段说明

3.2 校验与默认值（按代码）

• body 为空 JSON：返回失败 message = "请求参数不能为空"
• search_mode 非法：返回失败 message = "search_mode 不合法"
• search_mode 默认：未传或为空 -> and
• top_k 默认/上限：
  • top_k <= 0 -> 10
  • top_k > 50 -> 50

4. 返回信息

• 返回类型：JSON 字符串
• 成功/失败判断：看 status 与 code

4.1 通用返回结构

4.2 data 字段（命中时）

data 为对象，包含：

4.3 lst 单条元素字段

返回列表的基础字段来自 qw_map。

5. 示例

5.1 请求参数示例

{
  "title": "买卖合同纠纷",
  "ay": ["买卖合同纠纷"],
  "ajlb": "民事",
  "ja_start": "2023-01-01",
  "ja_end": "2023-12-31",
  "qw": "违约金 逾期",
  "top_k": 2
}

5.2 成功响应示例（命中）

{
  "code": 200,
  "data": {
    "total": 2,
    "lst": [
      {
        "cprq": "2023年12月25日",
        "llm_content": "null##基本案情：某发电公司在上海某产权交易所公开挂牌交易部分资产。2020年10月21日，某金属材料公司（乙方）与某发电公司（甲方）签订资产交易合同，约定价款922万元、一次性付款，合同生效后10个工作日内完成权利交接，交易所出具交易凭证后2个工作日内移交资产。甲方如逾期进行权利交接，每逾期一日按交易价款的3‰支付违约金。另约定，某发电公司在合同签订后5个工作日内将交易手续费支付至指定账户，交易所在双方手续费到账后3个工作日内出具资产交易凭证。其后，某金属材料公司缴纳了手续费和价款。2020年11月18日，交易所出具资产交易凭证。11月27日，某金属材料公司与某发电公司完成实物移交。\n\n一审情况：2021年2月3日，某金属材料公司起诉至陕西省宝鸡市凤翔区人民法院，请求判令某发电公司支付逾期交货违约金497880元。一审法院认为，根据合同约定，某发电公司应于2020年10月28日之前缴纳交易手续费，2020年11月4日前配合完成产权主体权利交接。某发电公司实际于2020年11月16日缴纳手续费，双方完成交接为2020年11月27日。某发电公司逾期缴纳手续费，进而导致违反合同约定，未与某金属材料公司按时完成权利交接和资产移交，违约17天，依据双方每逾期一日按交易价款3‰支付违约金的标准计算，应支付违约金470220元。据此，一审判决：某发电公司支付违约金470220元。\n\n二审情况：某发电公司上诉认为违约金过高、请求法院调减。宝鸡市中级人民法院二审认为，某发电公司违约，应当赔偿违约金。但合同约定的违约金标准过高，遂参照合同成立时同期全国银行间同业拆借中心公布的一年期贷款市场报价利率标准四倍调整违约金。改判某发电公司赔偿违约金67050元。某金属材料公司向陕西省高级人民法院申请再审被驳回。\n\n检察机关履职情况：某金属材料公司向陕西省宝鸡市人民检察院申请监督。检察机关依法受理后，通过调阅诉讼卷宗，询问双方当事人，审查认为：第一，生效判决认定案涉违约金过高，缺乏证据证明。双方均为商事主体，经协商一致约定违约赔偿数额的计算标准。案涉违约金未超过某发电公司订立合同时预见到或应当预见到的因违约可能造成的损失。某发电公司请求调减违约金并未提交相关证据证明双方约定过高，二审法院直接认定约定的违约金标准过高并调低，无事实依据。第二，生效判决将约定违约金调减为一年期贷款市场报价利率标准四倍，缺乏法律依据。双方资产交易并非借贷关系，违约金认定不能采取逾期还款违约责任计算方式，人民法院应依据法律规定和当事人意思自治，根据公平原则和诚实信用原则确定违约责任，避免过当行使自由裁量权，干预市场主体自主经营活动。\n\n再审情况：陕西省人民检察院认为生效判决认定违约金过高予以调减，缺乏事实和法律依据，于2023年8月8日向陕西省高级人民法院提出抗诉。陕西省高级人民法院裁定指令宝鸡市中级人民法院再审该案。宝鸡市中级人民法院再审认为，双方当事人均系公司法人，具有远高于一般自然人的理性判断，能够预见和合理判断违约行为将产生的法律后果，且某发电公司未能举证证实约定的违约金过分高于实际损失，原审判决适用法律错误，结果不当，应予撤销。2023年12月25日，宝鸡市中级人民法院采纳抗诉意见，作出再审判决：撤销二审判决，维持一审判决。2024年1月8日，某发电公司履行再审判决确定的470220元违约金给付义务。\n\n典型意义：习近平总书记指出：社会主义市场经济是信用经济、法治经济。诚信原则被称为帝王条款，是民法基本原则之一。《中华人民共和国民法典》第七条规定：民事主体从事民事活动，应当遵循诚信原则，秉持诚实，恪守承诺。第五百零九条第一款规定：当事人应当按照约定全面履行自己的义务。诚信与法治是现代市场经济健康、高效、有序运行的基石，也是社会主义核心价值观的重要内容。各类民事主体均应尊重和遵循契约精神，践行重信守诺的行为规则和原则。民商事交易的基础是当事人相互信任，尊重契约，如果一方主体不恪守承诺、违背诚信就必须承担违约金、损害赔偿金等法律责任，这是法律对诚信价值的基本保障。检察机关在履行民事检察监督职能中，要依法全面审查案件，准确区分把握民商事交易的不同特性，正确判断当事人约定违约金的合法性和公平性。要以精准办案保障社会诚信和法治体系建设，引导民事主体恪守契约精神，诚实经营交易，养成信守约定和承诺的观念。要以检察监督助推人民法院规范行使自由裁量权，确保合同纠纷案件中违约金酌减规则的正确适用，为市场经济发展提供有力司法保障。",
        "type": "典型案例",
        "title": "最高人民检察院发布6起检察机关依法履职推动社会主义核心价值观融入法治建设典型案例之六：陕西检察机关对某金属材料公司与某发电公司买卖合同纠纷抗诉案",
        "content": "基本案情：某发电公司在上海某产权交易所公开挂牌交易部分资产。2020年10月21日，某金属材料公司（乙方）与某发电公司（甲方）签订资产交易合同，约定价款922万元、一次性付款，合同生效后10个工作日内完成权利交接，交易所出具交易凭证后2个工作日内移交资产。甲方如逾期进行权利交接，每逾期一日按交易价款的3‰支付违约金。另约定，某发电公司在合同签订后5个工作日内将交易手续费支付至指定账户，交易所在双方手续费到账后3个工作日内出具资产交易凭证。其后，某金属材料公司缴纳了手续费和价款。2020年11月18日，交易所出具资产交易凭证。11月27日，某金属材料公司与某发电公司完成实物移交。\n\n一审情况：2021年2月3日，某金属材料公司起诉至陕西省宝鸡市凤翔区人民法院，请求判令某发电公司支付逾期交货违约金497880元。一审法院认为，根据合同约定，某发电公司应于2020年10月28日之前缴纳交易手续费，2020年11月4日前配合完成产权主体权利交接。某发电公司实际于2020年11月16日缴纳手续费，双方完成交接为2020年11月27日。某发电公司逾期缴纳手续费，进而导致违反合同约定，未与某金属材料公司按时完成权利交接和资产移交，违约17天，依据双方每逾期一日按交易价款3‰支付违约金的标准计算，应支付违约金470220元。据此，一审判决：某发电公司支付违约金470220元。\n\n二审情况：某发电公司上诉认为违约金过高、请求法院调减。宝鸡市中级人民法院二审认为，某发电公司违约，应当赔偿违约金。但合同约定的违约金标准过高，遂参照合同成立时同期全国银行间同业拆借中心公布的一年期贷款市场报价利率标准四倍调整违约金。改判某发电公司赔偿违约金67050元。某金属材料公司向陕西省高级人民法院申请再审被驳回。\n\n检察机关履职情况：某金属材料公司向陕西省宝鸡市人民检察院申请监督。检察机关依法受理后，通过调阅诉讼卷宗，询问双方当事人，审查认为：第一，生效判决认定案涉违约金过高，缺乏证据证明。双方均为商事主体，经协商一致约定违约赔偿数额的计算标准。案涉违约金未超过某发电公司订立合同时预见到或应当预见到的因违约可能造成的损失。某发电公司请求调减违约金并未提交相关证据证明双方约定过高，二审法院直接认定约定的违约金标准过高并调低，无事实依据。第二，生效判决将约定违约金调减为一年期贷款市场报价利率标准四倍，缺乏法律依据。双方资产交易并非借贷关系，违约金认定不能采取逾期还款违约责任计算方式，人民法院应依据法律规定和当事人意思自治，根据公平原则和诚实信用原则确定违约责任，避免过当行使自由裁量权，干预市场主体自主经营活动。\n\n再审情况：陕西省人民检察院认为生效判决认定违约金过高予以调减，缺乏事实和法律依据，于2023年8月8日向陕西省高级人民法院提出抗诉。陕西省高级人民法院裁定指令宝鸡市中级人民法院再审该案。宝鸡市中级人民法院再审认为，双方当事人均系公司法人，具有远高于一般自然人的理性判断，能够预见和合理判断违约行为将产生的法律后果，且某发电公司未能举证证实约定的违约金过分高于实际损失，原审判决适用法律错误，结果不当，应予撤销。2023年12月25日，宝鸡市中级人民法院采纳抗诉意见，作出再审判决：撤销二审判决，维持一审判决。2024年1月8日，某发电公司履行再审判决确定的470220元违约金给付义务。\n\n典型意义：习近平总书记指出：社会主义市场经济是信用经济、法治经济。诚信原则被称为帝王条款，是民法基本原则之一。《中华人民共和国民法典》第七条规定：民事主体从事民事活动，应当遵循诚信原则，秉持诚实，恪守承诺。第五百零九条第一款规定：当事人应当按照约定全面履行自己的义务。诚信与法治是现代市场经济健康、高效、有序运行的基石，也是社会主义核心价值观的重要内容。各类民事主体均应尊重和遵循契约精神，践行重信守诺的行为规则和原则。民商事交易的基础是当事人相互信任，尊重契约，如果一方主体不恪守承诺、违背诚信就必须承担违约金、损害赔偿金等法律责任，这是法律对诚信价值的基本保障。检察机关在履行民事检察监督职能中，要依法全面审查案件，准确区分把握民商事交易的不同特性，正确判断当事人约定违约金的合法性和公平性。要以精准办案保障社会诚信和法治体系建设，引导民事主体恪守契约精神，诚实经营交易，养成信守约定和承诺的观念。要以检察监督助推人民法院规范行使自由裁量权，确保合同纠纷案件中违约金酌减规则的正确适用，为市场经济发展提供有力司法保障。",
        "url": "/ydzk/caseDetail/qwcase/573c3f61efd08baa545121a12a007685",
        "score": 21.300636,
        "ajlb": "民事案件",
        "ay": [
          "合同、准合同纠纷",
          "合同纠纷",
          "买卖合同纠纷"
        ],
        "wszl": "判决书",
        "jbdw": "陕西省宝鸡市中级人民法院",
        "id": "573c3f61efd08baa545121a12a007685"
      },
      {
        "cprq": "2023年11月15日",
        "llm_content": "（2023）鲁02民辖终472号##裁判要旨：合同约定或裁或诉条款，仲裁协议被确认无效的，诉讼管辖约定的效力应当单独予以认定。诉讼管辖约定符合《中华人民共和国民事诉讼法》第三十五条规定的，应当认定有效。\n基本案情：青岛某公司与陕西某公司签订《水处理设备供货改造分包合同》，约定青岛某公司向陕西某公司供应水处理设备，合同总金额58万元。合同争议解决条款约定：协商不能解决的，(1)提交西安市仲裁委员会仲裁，(2)依法向需方所在地人民法院起诉或按《中华人民共和国合同法》有关规定解决。青岛某公司履行合同义务后，陕西某公司支付货款30万元，剩余28万元未付。青岛某公司向山东省平度市人民法院起诉，请求支付剩余货款及违约金等。陕西某公司提出管辖权异议，认为需方所在地为陕西省西安市雁塔区，本案应由陕西省西安市雁塔区人民法院管辖。\n裁判分析：争议焦点为案涉合同中或裁或诉条款的效力及管辖法院的确定。相关事实和细节：合同约定协商不成可提交西安市仲裁委员会仲裁或向需方所在地人民法院起诉。法院分析思路及结论依据：根据《最高人民法院关于适用＜中华人民共和国仲裁法＞若干问题的解释》第七条，当事人约定争议可向仲裁机构申请仲裁也可向人民法院起诉的，仲裁协议无效。故案涉合同中仲裁约定无效，但诉讼管辖约定有效，本案应由需方陕西某公司所在地的陕西省西安市雁塔区人民法院管辖，山东省平度市人民法院对本案无管辖权。\n判决结果：一审裁定本案移送陕西省西安市雁塔区人民法院处理；二审裁定驳回上诉，维持原裁定。",
        "ah": "（2023）鲁02民辖终472号",
        "type": "参考案例",
        "title": "青岛某源热能设备有限公司诉陕西某光锅炉销售有限公司买卖合同纠纷案",
        "content": "裁判要旨：合同约定或裁或诉条款，仲裁协议被确认无效的，诉讼管辖约定的效力应当单独予以认定。诉讼管辖约定符合《中华人民共和国民事诉讼法》第三十五条规定的，应当认定有效。\n基本案情：青岛某公司与陕西某公司签订《水处理设备供货改造分包合同》，约定青岛某公司向陕西某公司供应水处理设备，合同总金额58万元。合同争议解决条款约定：协商不能解决的，(1)提交西安市仲裁委员会仲裁，(2)依法向需方所在地人民法院起诉或按《中华人民共和国合同法》有关规定解决。青岛某公司履行合同义务后，陕西某公司支付货款30万元，剩余28万元未付。青岛某公司向山东省平度市人民法院起诉，请求支付剩余货款及违约金等。陕西某公司提出管辖权异议，认为需方所在地为陕西省西安市雁塔区，本案应由陕西省西安市雁塔区人民法院管辖。\n裁判分析：争议焦点为案涉合同中或裁或诉条款的效力及管辖法院的确定。相关事实和细节：合同约定协商不成可提交西安市仲裁委员会仲裁或向需方所在地人民法院起诉。法院分析思路及结论依据：根据《最高人民法院关于适用＜中华人民共和国仲裁法＞若干问题的解释》第七条，当事人约定争议可向仲裁机构申请仲裁也可向人民法院起诉的，仲裁协议无效。故案涉合同中仲裁约定无效，但诉讼管辖约定有效，本案应由需方陕西某公司所在地的陕西省西安市雁塔区人民法院管辖，山东省平度市人民法院对本案无管辖权。\n判决结果：一审裁定本案移送陕西省西安市雁塔区人民法院处理；二审裁定驳回上诉，维持原裁定。",
        "url": "/ydzk/caseDetail/qwcase/e2edfb10d1f257dc9eb306c38746a7ae",
        "score": 19.30098,
        "ajlb": "民事案件",
        "ay": [
          "合同、准合同纠纷",
          "合同纠纷",
          "买卖合同纠纷"
        ],
        "jbdw": "山东省青岛市中级人民法院",
        "id": "e2edfb10d1f257dc9eb306c38746a7ae",
        "xzqh_p": "山东"
      }
    ]
  },
  "message": "请求成功",
  "status": "success"
}

5.3 成功响应示例（未命中）

{
  "data": null,
  "status": "success",
  "code": 200,
  "message": "未查询到相关内容"
}

5.4 失败响应示例

5.4.1 请求体为空

{
  "data": null,
  "status": "failed",
  "code": 500,
  "message": "请求参数不能为空"
}

5.4.2 search_mode 非法

{
  "data": null,
  "status": "failed",
  "code": 500,
  "message": "search_mode 不合法"
}

6. 代码示例

6.1 CURL

curl --location --request POST "https://open.chineselaw.com/open/rh_qwal_search" \
--header "X-API-Key: 你的api_key" \
--header "Accept: application/json" \
--header "Content-Type: application/json; charset=utf-8" \
--data-raw "{\"title\": \"买卖合同纠纷\", \"ay\": [\"买卖合同纠纷\"], \"ajlb\": \"民事\", \"ja_start\": \"2023-01-01\", \"ja_end\": \"2023-12-31\", \"qw\": \"违约金 逾期\", \"top_k\": 2}"

6.2 Python

import requests

url = "https://open.chineselaw.com/open/rh_qwal_search"
API_KEY = "你的api_key"
headers = {
    "X-API-Key": API_KEY,
    "Accept": "application/json",
    "Content-Type": "application/json; charset=utf-8",
}
payload = {
    "title": "买卖合同纠纷",
    "ay": ["买卖合同纠纷"],
    "ajlb": "民事",
    "ja_start": "2023-01-01",
    "ja_end": "2023-12-31",
    "qw": "违约金 逾期",
    "top_k": 2,
}

response = requests.post(url, json=payload, headers=headers, timeout=30)
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 RhQwalSearchExample {

    static void main(String[] args) throws Exception {
        String apiKey = "你的api_key";
        String url = "https://open.chineselaw.com/open/rh_qwal_search";
        String body = "{\"title\":\"买卖合同纠纷\",\"ay\":[\"买卖合同纠纷\"],"
                + "\"ajlb\":\"民事\",\"ja_start\":\"2023-01-01\",\"ja_end\":\"2023-12-31\","
                + "\"qw\":\"违约金 逾期\",\"top_k\":2}";

        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(url))
                .timeout(Duration.ofSeconds(30))
                .header("X-API-Key", apiKey)
                .header("Accept", "application/json")
                .header("Content-Type", "application/json; charset=utf-8")
                .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/rh_qwal_search";

const res = await fetch(url, {
  method: "POST",
  headers: {
    "X-API-Key": API_KEY,
    "Accept": "application/json",
    "Content-Type": "application/json; charset=utf-8",
  },
  body: JSON.stringify({
    title: "买卖合同纠纷",
    ay: ["买卖合同纠纷"],
    ajlb: "民事",
    ja_start: "2023-01-01",
    ja_end: "2023-12-31",
    qw: "违约金 逾期",
    top_k: 2,
  }),
});

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