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

3.1 字段说明

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

• body 为空 JSON：返回失败 message = "请求参数不能为空"
• search_mode 非法：返回失败 message = "search_mode 不合法"
• ft_search_mode 非法：返回失败 message = "ft_search_mode 不合法"
• search_mode 默认：未传或为空 -> and
• ft_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_ptal_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 不合法"
• ft_search_mode 非法：返回失败 message = "ft_search_mode 不合法"
• search_mode 默认：未传或为空 -> and
• ft_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 单条元素字段

5. 示例

5.1 请求参数示例

{
  "ay": ["买卖合同纠纷"],
  "xzqh_p": ["北京"],
  "wszl": ["判决书"],
  "ajlb": "民事",
  "ja_start": "2020-01-01",
  "ja_end": "2023-12-31",
  "qw": "违约金 逾期",
  "top_k": 2
}

5.2 成功响应示例（命中）

{
  "code": 200,
  "data": {
    "total": 15414,
    "lst": [
      {
        "cprq": "2022年08月18日",
        "llm_content": "（2022）京03民终6978号##关于新仟瑞公司主张的违约金，双方均认可所签《铝板采购合同》后附通用条款第9.1.1条约定：甲方逾期付款未超过十五天的，乙方予以宽限；甲方逾期付款超过十五天的，以逾期付款额为基数，从第十六天开始，按每日万分之一（0.1‰）向乙方偿付逾期付款的违约金，该违约金总额不超过合同总金额的百分之二（2％）。故新仟瑞公司要求按照年利率5.775％为标准计算违约金，无事实依据，一审法院根据在案证据及双方庭审陈述予以调整。对于违约金的起算时间，一审法院亦根据在案证据及双方庭审陈述予以调整。\n关于新仟瑞公司主张的律师费，因双方所签涉诉合同中并未对此作出约定，故对于新仟瑞该项诉讼请求，一审法院不予支持。\n依照《中华人民共和国合同法》第一百零七条、第一百五十九条之规定，判决：一、北京嘉寓门窗幕墙股份有限公司给付河北新仟瑞新型建材有限公司款956751.23元并支付违约金（违约金的计算方式为：以38.5万元为基数，按照年利率3.85％计算，自2021年8月6日起计算至实际付清之日止；以571751.23元为基数，按照年利率3.85％计算，自2021年12月26日起计算至实际付清之日止。上述违约金总额以29315元为限），均于判决生效之日起七日内执行；二、驳回河北新仟瑞新型建材有限公司的其他诉讼请求。如果未按判决所指定的期间履行给付金钱义务，应当依照《中华人民共和国民事诉讼法》第二百六十条之规定，加倍支付迟延履行期间的债务利息。\n二审期间，双方当事人未提交证据。\n本院对一审查明的事实予以确认。\n本院认为，综合双方诉辩意见，本案二审争议焦点为：违约金数额认定问题。\n一、二审期间，嘉寓门窗公司对其尚欠新仟瑞公司货款956751.23元无异议，本院对此予以确认。关于违约金一节，双方签订《铝板采购合同》后附通用条款第9.1.1条约定：甲方逾期付款未超过十五天的，乙方予以宽限；甲方逾期付款超过十五天的，以逾期付款额为基数，从第十六天开始，按每日万分之一（0.1‰）向乙方偿付逾期付款的违约金，该违约金总额不超过合同总金额的百分之二（2％）。现嘉寓门窗公司未按期支付货款，其应当承担逾期付款之违约责任。嘉寓门窗公司虽上诉主张双方合同中明确约定了新仟瑞公司应在嘉寓门窗公司付款前开具相应的发票，因新仟瑞公司未提供，属于有过错行为；因此嘉寓门窗公司不应承担逾期付款利息。但，嘉寓门窗公司并未提交其向新仟瑞公司付款前，要求新仟瑞公司开具发票但新仟瑞公司拒绝开具发票之相关证据；新仟瑞公司亦不予认可，故而嘉寓门窗公司关于新仟瑞公司存在过错故其不应承担逾期付款利息之上诉主张，缺乏充分依据和证据佐证，本院不予采纳。一审法院根据双方合同约定及当事人陈述予以认定嘉寓门窗公司应支付新仟瑞公司违约金，并无不当，本院予以支持。\n",
        "ah": "（2022）京03民终6978号",
        "type": "普通案例",
        "title": "北京嘉寓门窗幕墙股份有限公司与河北新仟瑞新型建材有限公司买卖合同纠纷二审民事判决书",
        "content": "关于新仟瑞公司主张的违约金，双方均认可所签《铝板采购合同》后附通用条款第9.1.1条约定：甲方逾期付款未超过十五天的，乙方予以宽限；甲方逾期付款超过十五天的，以逾期付款额为基数，从第十六天开始，按每日万分之一（0.1‰）向乙方偿付逾期付款的违约金，该违约金总额不超过合同总金额的百分之二（2％）。故新仟瑞公司要求按照年利率5.775％为标准计算违约金，无事实依据，一审法院根据在案证据及双方庭审陈述予以调整。对于违约金的起算时间，一审法院亦根据在案证据及双方庭审陈述予以调整。\n关于新仟瑞公司主张的律师费，因双方所签涉诉合同中并未对此作出约定，故对于新仟瑞该项诉讼请求，一审法院不予支持。\n依照《中华人民共和国合同法》第一百零七条、第一百五十九条之规定，判决：一、北京嘉寓门窗幕墙股份有限公司给付河北新仟瑞新型建材有限公司款956751.23元并支付违约金（违约金的计算方式为：以38.5万元为基数，按照年利率3.85％计算，自2021年8月6日起计算至实际付清之日止；以571751.23元为基数，按照年利率3.85％计算，自2021年12月26日起计算至实际付清之日止。上述违约金总额以29315元为限），均于判决生效之日起七日内执行；二、驳回河北新仟瑞新型建材有限公司的其他诉讼请求。如果未按判决所指定的期间履行给付金钱义务，应当依照《中华人民共和国民事诉讼法》第二百六十条之规定，加倍支付迟延履行期间的债务利息。\n二审期间，双方当事人未提交证据。\n本院对一审查明的事实予以确认。\n本院认为，综合双方诉辩意见，本案二审争议焦点为：违约金数额认定问题。\n一、二审期间，嘉寓门窗公司对其尚欠新仟瑞公司货款956751.23元无异议，本院对此予以确认。关于违约金一节，双方签订《铝板采购合同》后附通用条款第9.1.1条约定：甲方逾期付款未超过十五天的，乙方予以宽限；甲方逾期付款超过十五天的，以逾期付款额为基数，从第十六天开始，按每日万分之一（0.1‰）向乙方偿付逾期付款的违约金，该违约金总额不超过合同总金额的百分之二（2％）。现嘉寓门窗公司未按期支付货款，其应当承担逾期付款之违约责任。嘉寓门窗公司虽上诉主张双方合同中明确约定了新仟瑞公司应在嘉寓门窗公司付款前开具相应的发票，因新仟瑞公司未提供，属于有过错行为；因此嘉寓门窗公司不应承担逾期付款利息。但，嘉寓门窗公司并未提交其向新仟瑞公司付款前，要求新仟瑞公司开具发票但新仟瑞公司拒绝开具发票之相关证据；新仟瑞公司亦不予认可，故而嘉寓门窗公司关于新仟瑞公司存在过错故其不应承担逾期付款利息之上诉主张，缺乏充分依据和证据佐证，本院不予采纳。一审法院根据双方合同约定及当事人陈述予以认定嘉寓门窗公司应支付新仟瑞公司违约金，并无不当，本院予以支持。\n",
        "url": "/ydzk/caseDetail/case/183fe9bf6e95f51fab804e383854a51f",
        "score": 11.359024,
        "ajlb": "民事案件",
        "ay": [
          "买卖合同纠纷"
        ],
        "wszl": "判决书",
        "id": "183fe9bf6e95f51fab804e383854a51f",
        "xzqh_p": "北京"
      },
      {
        "cprq": "2021年05月25日",
        "llm_content": "（2021）京0102民初3161号##根据《最高人民法院关于审理买卖合同纠纷案件适用法律问题的解释》第十八条第四款的规定，买卖合同没有约定逾期付款违约金或者该违约金的计算方法，出卖人以买受人违约为由主张赔偿逾期付款损失，违约行为发生在2019年8月19日之前的，人民法院可以中国人民银行同期同类人民币贷款基准利率为基础，参照逾期罚息利率标准计算；违约行为发生在2019年8月20日之后的，人民法院可以违约行为发生时中国人民银行授权全国银行间同业拆借中心公布的一年期贷款市场报价利率（LPR）标准为基础，加计30——50％计算逾期付款损失。本案中，双方既未约定尾款支付时间，也未约定逾期付款违约金的计算标准。关于逾期付款违约金的起算时间，本院认为，虽双方未明确约定尾款付款时间，但是从原告2019年2月4日交货至本案2021年1月26日立案，时间将近2年，该期间早已超过被告应付尾款的合理时间，且原告在此期间多次向被告催收货款，因此，原告主张自2021年1月26日起计收逾期付款违约金，本院认为并无不当，本院予以支持。原告主张按一年期LPR标准计算违约金，该标准并未超过法律规定的违约金计算标准，因此本院予以支持。此外，根据本院确定的违约金的起算时间，本院将违约金计算标准确定为2021年1月的一年期LPR。\n综上所述，饮发酒业公司要求陈向华支付货款7000元及逾期付款违约金的诉讼请求，本院予以支持。依照《中华人民共和国合同法》第一百三十条、第一百五十九条、《最高人民法院关于审理买卖合同纠纷案件适用法律问题的解释》第一条第一款、第十八条第四款之规定，判决如下：\n本判决生效后七日内，陈向华向北京饮发酒业有限公司支付货款7000元，以及自2021年1月26日起至货款实际付清之日止的违约金（以上述未付货款为基数，按2021年1月的一年期LPR标准计算）。\n如果未按本判决指定的期间履行给付金钱义务，应当依照《中华人民共和国民事诉讼法》第二百五十三条规定，加倍支付迟延履行期间的债务利息。\n案件受理费50元以及公告费（以实际发生为准），由陈向华负担（于本判决生效后七日内直接支付给北京饮发酒业有限公司）。\n如不服本判决，可以在判决书送达之日起十五日内，向本院递交上诉状，并按对方当事人的人数提出副本，上诉于北京市第二中级人民法院，并于提起上诉后七日内交纳二审案件受理费，逾期未交按撤回上诉处理。\n审判员郭高明\n二〇二一年五月二十五日\n书记员吴佩珊",
        "ah": "（2021）京0102民初3161号",
        "type": "普通案例",
        "title": "北京饮发酒业有限公司与陈向华买卖合同纠纷一审民事判决书",
        "content": "根据《最高人民法院关于审理买卖合同纠纷案件适用法律问题的解释》第十八条第四款的规定，买卖合同没有约定逾期付款违约金或者该违约金的计算方法，出卖人以买受人违约为由主张赔偿逾期付款损失，违约行为发生在2019年8月19日之前的，人民法院可以中国人民银行同期同类人民币贷款基准利率为基础，参照逾期罚息利率标准计算；违约行为发生在2019年8月20日之后的，人民法院可以违约行为发生时中国人民银行授权全国银行间同业拆借中心公布的一年期贷款市场报价利率（LPR）标准为基础，加计30——50％计算逾期付款损失。本案中，双方既未约定尾款支付时间，也未约定逾期付款违约金的计算标准。关于逾期付款违约金的起算时间，本院认为，虽双方未明确约定尾款付款时间，但是从原告2019年2月4日交货至本案2021年1月26日立案，时间将近2年，该期间早已超过被告应付尾款的合理时间，且原告在此期间多次向被告催收货款，因此，原告主张自2021年1月26日起计收逾期付款违约金，本院认为并无不当，本院予以支持。原告主张按一年期LPR标准计算违约金，该标准并未超过法律规定的违约金计算标准，因此本院予以支持。此外，根据本院确定的违约金的起算时间，本院将违约金计算标准确定为2021年1月的一年期LPR。\n综上所述，饮发酒业公司要求陈向华支付货款7000元及逾期付款违约金的诉讼请求，本院予以支持。依照《中华人民共和国合同法》第一百三十条、第一百五十九条、《最高人民法院关于审理买卖合同纠纷案件适用法律问题的解释》第一条第一款、第十八条第四款之规定，判决如下：\n本判决生效后七日内，陈向华向北京饮发酒业有限公司支付货款7000元，以及自2021年1月26日起至货款实际付清之日止的违约金（以上述未付货款为基数，按2021年1月的一年期LPR标准计算）。\n如果未按本判决指定的期间履行给付金钱义务，应当依照《中华人民共和国民事诉讼法》第二百五十三条规定，加倍支付迟延履行期间的债务利息。\n案件受理费50元以及公告费（以实际发生为准），由陈向华负担（于本判决生效后七日内直接支付给北京饮发酒业有限公司）。\n如不服本判决，可以在判决书送达之日起十五日内，向本院递交上诉状，并按对方当事人的人数提出副本，上诉于北京市第二中级人民法院，并于提起上诉后七日内交纳二审案件受理费，逾期未交按撤回上诉处理。\n审判员郭高明\n二〇二一年五月二十五日\n书记员吴佩珊",
        "url": "/ydzk/caseDetail/case/938e1e392736fdf2208db6e5312f0041",
        "score": 11.344663,
        "ajlb": "民事案件",
        "ay": [
          "买卖合同纠纷"
        ],
        "wszl": "判决书",
        "id": "938e1e392736fdf2208db6e5312f0041",
        "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 不合法"
}

5.4.3 ft_search_mode 非法

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

6. 代码示例

6.1 CURL

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

6.2 Python

import requests

url = "https://open.chineselaw.com/open/rh_ptal_search"
API_KEY = "你的api_key"
headers = {
    "X-API-Key": API_KEY,
    "Accept": "application/json",
    "Content-Type": "application/json; charset=utf-8",
}
payload = {
    "ay": ["买卖合同纠纷"],
    "xzqh_p": ["北京"],
    "wszl": ["判决书"],
    "ajlb": "民事",
    "ja_start": "2020-01-01",
    "ja_end": "2023-12-31",
    "qw": "违约金 逾期",
    "search_mode": "and",
    "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 RhPtalSearchExample {

    static void main(String[] args) throws Exception {
        String apiKey = "你的api_key";
        String url = "https://open.chineselaw.com/open/rh_ptal_search";
        String body = "{\"ay\":[\"买卖合同纠纷\"],\"xzqh_p\":[\"北京\"],\"wszl\":[\"判决书\"],"
                + "\"ajlb\":\"民事\",\"ja_start\":\"2020-01-01\",\"ja_end\":\"2023-12-31\","
                + "\"qw\":\"违约金 逾期\",\"search_mode\":\"and\",\"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_ptal_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({
    ay: ["买卖合同纠纷"],
    xzqh_p: ["北京"],
    wszl: ["判决书"],
    ajlb: "民事",
    ja_start: "2020-01-01",
    ja_end: "2023-12-31",
    qw: "违约金 逾期",
    search_mode: "and",
    top_k: 2,
  }),
});

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