普通案例关键词检索接口 API 文档
检索普通裁判案例列表。支持按案号、标题、涉诉企业、案由、法院、地域、文书种类、案件类别、裁判/结案日期、全文关键词、分析过程关键词、援引法条等条件过滤;请求体不能为空。返回命中总数和案例列表,content是命中高亮片段或摘要/分析过程片段,不等同于完整正文;需要全文时应再调用案例详情接口。
接口概览
| 接口名称 | 普通案例关键词检索接口 |
|---|---|
| 接口描述 | 检索普通裁判案例列表。支持按案号、标题、涉诉企业、案由、法院、地域、文书种类、案件类别、裁判/结案日期、全文关键词、分析过程关键词、援引法条等条件过滤;请求体不能为空。返回命中总数和案例列表,content是命中高亮片段或摘要/分析过程片段,不等同于完整正文;需要全文时应再调用案例详情接口。 |
| 接口分类 | 案例文书 |
| 调用地址 | https://open.chineselaw.com/open/rh_ptal_search |
| 请求方式 | POST |
请求参数
以下字段均为可选字段,但 请求体不能为空(空 JSON 会返回失败)。
3.1 字段说明
| 字段名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
ah |
string | 否 | 案号 |
title |
string | 否 | 标题检索:按空格拆分后,标题需全部命中 |
ay |
string[] | 否 | 案由数组;多值为或关系 |
jbdw |
string[] | 否 | 经办法院/承办单位数组;多值为或关系 |
ssqy |
string | 否 | 涉诉企业筛选,单值,子串命中 |
lawyer |
string | 否 | 律师姓名筛选,单值,精确命中,和lawfirm 配合使用,筛选指定律所的律师筛选 |
lawfirm |
string | 否 | 律所筛选,单值,子串命中,和lawyer 配合使用,筛选指定律所的律师筛选 |
xzqh_p |
string[] | 否 | 省级行政区数组,可选值:北京、天津、河北、山西、内蒙古、辽宁、吉林、黑龙江、上海、江苏、浙江、安徽、福建、江西、山东、河南、湖北、湖南、广东、广西、海南、重庆、四川、贵州、云南、西藏、陕西、甘肃、青海、宁夏、新疆、最高、新疆生产建设兵团;多值为或关系 |
wszl |
string[] | 否 | 文书种类数组,可选值:判决书、裁定书、调解书、决定书;多值为或关系 |
ajlb |
string | 否 | 案件类别,可选值:刑事案件、民事案件、行政案件、执行案件、管辖案件、国家赔偿与司法救助案件、强制清算与破产案件、国际司法协助案件、非诉保全审查案件、其他案件" |
ja_start |
string | 否 | 结案/裁判日期起(含当前日期),格式为:yyyy-MM-dd |
ja_end |
string | 否 | 结案/裁判日期止(含当前日期),格式为:yyyy-MM-dd |
qw |
string | 否 | 全文关键词(按 search_mode 将空格拆分并用 AND/OR 拼接成 queryString) |
fxgc |
string | 否 | 分析过程关键词(按 search_mode 将空格拆分并用 AND/OR 拼接成 queryString) |
search_mode |
string | 否 | 关键词拼接模式:and 或 or;为空默认 and;非法会返回失败 |
yyft |
string[] | 否 | 援引法条数组(形如“中华人民共和国刑法第二条”),列表的每个元素只能包含一个法条,且法条编号必须为中文“第二条”这种格式 |
ft_search_mode |
string | 否 | yyft 拼接模式:and 或 or;为空默认 and;非法会返回失败 |
top_k |
number | 否 | 返回条数上限:默认 10;最大 50;小于等于 0 会按默认 10 处理 |
3.2 校验与默认值(按代码)
- body 为空 JSON:返回失败
message = "请求参数不能为空" search_mode非法:返回失败message = "search_mode 不合法"ft_search_mode非法:返回失败message = "ft_search_mode 不合法"search_mode默认:未传或为空 ->andft_search_mode默认:未传或为空 ->andtop_k默认/上限:top_k <= 0-> 10top_k > 50-> 50
响应参数
4. 返回信息
-
返回类型:JSON 字符串
-
成功/失败判断:请求响应状态码
-
响应状态码说明
响应状态码 说明 200 接口调用成功 500 程序异常,具体描述见message信息 429 超流量拦截 403 鉴权失败 / 黑名单被拒 400 请求体解析失败/无法解析来源 IP 422 参数校验异常
4.1 通用返回结构
| 字段名 | 类型 | 说明 |
|---|---|---|
status |
string | success 等 |
code |
number | 业务状态码 |
message |
string | 提示信息 |
data |
object | 数据结果 |
4.2 data 字段(命中时)
data 为对象,包含:
| 字段名 | 类型 | 说明 |
|---|---|---|
total |
object | 命中总数 |
lst |
object[] | 命中列表 |
4.3 lst 单条元素字段
| 字段名 | 类型 | 说明 |
|---|---|---|
type |
string | 固定为 普通案例 |
id |
string | 案例 ID |
ah |
string | 案号 |
title |
string | 标题 |
ay |
string | 案由 |
jbdw |
string | 经办法院/承办单位 |
ajlb |
string | 案件类别 |
xzqh_p |
string | 省级行政区 |
wszl |
string | 文书种类 |
jafs |
string | 结案方式 |
cprq |
string | 日期 |
content |
string | 内容片段:优先高亮片段(当本次请求含关键词时),否则优先文书摘要总结,其次裁判分析过程段,最后回退为全文 |
llm_content |
string | 拼接字段:<ah>##<content> |
url |
string | 详情 URL:/ydzk/caseDetail/case/ + id |
score |
number | ES score |
错误码
| 错误码 | 说明 |
|---|---|
| 500 | 程序异常,具体描述见message信息 |
| 429 | 超流量拦截 |
| 403 | 鉴权失败 / 黑名单被拒 |
| 400 | 请求体解析失败/无法解析来源 IP |
| 422 | 参数校验异常 |
调用示例
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}"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());
}
}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())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());
MCP Tool 名称
| MCP Server | yuandian-case(案例文书 Server) |
|---|---|
| Streamable HTTP 入口 | https://open.chineselaw.com/mcp/case/stream |
| MCP Tool | yuandian_rh_ptal_search |
响应示例
{
"code": 200,
"data": {
"total": 15467,
"lst": [
{
"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号",
"cj": "基层",
"spcx": "一审案件",
"type": "普通案例",
"title": "北京饮发酒业有限公司与陈向华买卖合同纠纷一审民事判决书",
"xzqh_c": "二中院",
"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": "https://ydzk.chineselaw.com/ydzk/caseDetail/case/938e1e392736fdf2208db6e5312f0041",
"score": 36.73003,
"ajlb": "民事案件",
"jafs": "判决",
"ay": [
"买卖合同纠纷"
],
"wszl": "判决书",
"jbdw": "北京市西城区人民法院",
"id": "938e1e392736fdf2208db6e5312f0041",
"xzqh_p": "北京"
},
{
"cprq": "2023年10月24日",
"llm_content": "(2023)京0106民初22061号##另,双方均同意将案涉房屋面积补差价16040元在逾期交房违约金中予以扣减,邓某无需另行交纳面积补差价。\n庭审中,双方均认可实际交房时间为2021年9月29日。\n2020年9月30日,邓某(买受人)与某公司(出卖人)签订编号《北京市商品房预售合同》,约定房屋坐落为丰台区南苑乡槐房村和新宫村1404-669地块669-27-2#地下车库×层×,总价款为420000元。出卖人应当于2021年9月30日前向买受人交付该商品房,逾期交付责任为(二)逾期超过180日,买受人有权解除合同,买受人不解除合同的,合同继续履行,出卖人按日计算向买受人支付全部房价款万分之一的违约金。双方均认可邓某已经交纳案涉车位款420000元,并同意以此金额为基数计算逾期交付违约金。\n庭审中,双方均认可实际交付车位时间为2022年7月17日。\n本院认为,依法成立的合同受法律保护。邓某与某公司签订的两份《北京市商品房预售合同》均系双方真实意思表示,不违反法律法规规定,合法有效,双方均应依约履行。\n关于逾期交房违约金,本案中,某公司逾期交房,构成违约,某公司应承担相应违约责任。某公司认可邓某主张的违约金计算基数、日万分之一的计算标准及违约金计算的期间,本院对此不持异议。经本院核算,邓某主张某公司支付其逾期交付违约金,某公司应支付邓某逾期交房违约金210204.55元,数额合理,予以支持。\n关于逾期交付车位违约金,某公司逾期交付地下车位,构成违约,某公司应承担相应违约责任。某公司认可邓某主张的违约金计算基数、日万分之一的计算标准及违约金计算的期间,本院对此不持异议。经本院核算,某公司应支付邓某逾期交付车位违约金12180元,超出部分不予支持。\n综上所述,依照《中华人民共和国民法典》第五百零九条、第五百七十七条、第五百八十五条,《中华人民共和国民事诉讼法》第一百六十五条之规定,判决如下:\n一、某投资有限公司于本判决生效之日起十日内支付邓某逾期交房违约金210204.55元;\n二、某投资有限公司于本判决生效之日起十日内支付邓某逾期交付车位违约金12180元;\n三、驳回邓某的其他诉讼请求。\n如果未按本判决指定的期间履行给付金钱义务,应当依照《中华人民共和国民事诉讼法》第二百六十条之规定,加倍支付迟延履行期间的债务利息。\n案件受理费10元,由某投资有限公司负担(于本判决生效之日起七日内交纳)。\n本判决为终审判决。\n审判员史艳\n二〇二三年十月二十四日\n书记员卢刘华",
"ah": "(2023)京0106民初22061号",
"cj": "基层",
"spcx": "一审案件",
"type": "普通案例",
"title": "邓某与某投资有限公司房屋买卖合同纠纷一审民事判决书",
"xzqh_c": "二中院",
"content": "另,双方均同意将案涉房屋面积补差价16040元在逾期交房违约金中予以扣减,邓某无需另行交纳面积补差价。\n庭审中,双方均认可实际交房时间为2021年9月29日。\n2020年9月30日,邓某(买受人)与某公司(出卖人)签订编号《北京市商品房预售合同》,约定房屋坐落为丰台区南苑乡槐房村和新宫村1404-669地块669-27-2#地下车库×层×,总价款为420000元。出卖人应当于2021年9月30日前向买受人交付该商品房,逾期交付责任为(二)逾期超过180日,买受人有权解除合同,买受人不解除合同的,合同继续履行,出卖人按日计算向买受人支付全部房价款万分之一的违约金。双方均认可邓某已经交纳案涉车位款420000元,并同意以此金额为基数计算逾期交付违约金。\n庭审中,双方均认可实际交付车位时间为2022年7月17日。\n本院认为,依法成立的合同受法律保护。邓某与某公司签订的两份《北京市商品房预售合同》均系双方真实意思表示,不违反法律法规规定,合法有效,双方均应依约履行。\n关于逾期交房违约金,本案中,某公司逾期交房,构成违约,某公司应承担相应违约责任。某公司认可邓某主张的违约金计算基数、日万分之一的计算标准及违约金计算的期间,本院对此不持异议。经本院核算,邓某主张某公司支付其逾期交付违约金,某公司应支付邓某逾期交房违约金210204.55元,数额合理,予以支持。\n关于逾期交付车位违约金,某公司逾期交付地下车位,构成违约,某公司应承担相应违约责任。某公司认可邓某主张的违约金计算基数、日万分之一的计算标准及违约金计算的期间,本院对此不持异议。经本院核算,某公司应支付邓某逾期交付车位违约金12180元,超出部分不予支持。\n综上所述,依照《中华人民共和国民法典》第五百零九条、第五百七十七条、第五百八十五条,《中华人民共和国民事诉讼法》第一百六十五条之规定,判决如下:\n一、某投资有限公司于本判决生效之日起十日内支付邓某逾期交房违约金210204.55元;\n二、某投资有限公司于本判决生效之日起十日内支付邓某逾期交付车位违约金12180元;\n三、驳回邓某的其他诉讼请求。\n如果未按本判决指定的期间履行给付金钱义务,应当依照《中华人民共和国民事诉讼法》第二百六十条之规定,加倍支付迟延履行期间的债务利息。\n案件受理费10元,由某投资有限公司负担(于本判决生效之日起七日内交纳)。\n本判决为终审判决。\n审判员史艳\n二〇二三年十月二十四日\n书记员卢刘华",
"url": "https://ydzk.chineselaw.com/ydzk/caseDetail/case/0ca39a9d5e0d1722122f9469e15a3e7d",
"score": 36.651863,
"ajlb": "民事案件",
"jafs": "判决",
"ay": [
"房屋买卖合同纠纷"
],
"wszl": "判决书",
"jbdw": "北京市丰台区人民法院",
"id": "0ca39a9d5e0d1722122f9469e15a3e7d",
"xzqh_p": "北京"
}
]
},
"message": "请求成功",
"status": "success"
}
完整文档
普通案例关键词检索接口
1. 基本信息
- 接口名称:普通案例关键词检索接口
- 接口用途:检索普通裁判案例列表。支持按案号、标题、涉诉企业、案由、法院、地域、文书种类、案件类别、裁判/结案日期、全文关键词、分析过程关键词、援引法条等条件过滤;请求体不能为空。返回命中总数和案例列表,content是命中高亮片段或摘要/分析过程片段,不等同于完整正文;需要全文时应再调用案例详情接口。
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 字段说明
| 字段名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
ah |
string | 否 | 案号 |
title |
string | 否 | 标题检索:按空格拆分后,标题需全部命中 |
ay |
string[] | 否 | 案由数组;多值为或关系 |
jbdw |
string[] | 否 | 经办法院/承办单位数组;多值为或关系 |
ssqy |
string | 否 | 涉诉企业筛选,单值,子串命中 |
lawyer |
string | 否 | 律师姓名筛选,单值,精确命中,和lawfirm 配合使用,筛选指定律所的律师筛选 |
lawfirm |
string | 否 | 律所筛选,单值,子串命中,和lawyer 配合使用,筛选指定律所的律师筛选 |
xzqh_p |
string[] | 否 | 省级行政区数组,可选值:北京、天津、河北、山西、内蒙古、辽宁、吉林、黑龙江、上海、江苏、浙江、安徽、福建、江西、山东、河南、湖北、湖南、广东、广西、海南、重庆、四川、贵州、云南、西藏、陕西、甘肃、青海、宁夏、新疆、最高、新疆生产建设兵团;多值为或关系 |
wszl |
string[] | 否 | 文书种类数组,可选值:判决书、裁定书、调解书、决定书;多值为或关系 |
ajlb |
string | 否 | 案件类别,可选值:刑事案件、民事案件、行政案件、执行案件、管辖案件、国家赔偿与司法救助案件、强制清算与破产案件、国际司法协助案件、非诉保全审查案件、其他案件" |
ja_start |
string | 否 | 结案/裁判日期起(含当前日期),格式为:yyyy-MM-dd |
ja_end |
string | 否 | 结案/裁判日期止(含当前日期),格式为:yyyy-MM-dd |
qw |
string | 否 | 全文关键词(按 search_mode 将空格拆分并用 AND/OR 拼接成 queryString) |
fxgc |
string | 否 | 分析过程关键词(按 search_mode 将空格拆分并用 AND/OR 拼接成 queryString) |
search_mode |
string | 否 | 关键词拼接模式:and 或 or;为空默认 and;非法会返回失败 |
yyft |
string[] | 否 | 援引法条数组(形如“中华人民共和国刑法第二条”),列表的每个元素只能包含一个法条,且法条编号必须为中文“第二条”这种格式 |
ft_search_mode |
string | 否 | yyft 拼接模式:and 或 or;为空默认 and;非法会返回失败 |
top_k |
number | 否 | 返回条数上限:默认 10;最大 50;小于等于 0 会按默认 10 处理 |
3.2 校验与默认值(按代码)
- body 为空 JSON:返回失败
message = "请求参数不能为空" search_mode非法:返回失败message = "search_mode 不合法"ft_search_mode非法:返回失败message = "ft_search_mode 不合法"search_mode默认:未传或为空 ->andft_search_mode默认:未传或为空 ->andtop_k默认/上限:- top_k <= 0 -> 10
- top_k > 50 -> 50
4. 返回信息
-
返回类型:JSON 字符串
-
成功/失败判断:请求响应状态码
-
响应状态码说明
响应状态码 说明 200 接口调用成功 500 程序异常,具体描述见message信息 429 超流量拦截 403 鉴权失败 / 黑名单被拒 400 请求体解析失败/无法解析来源 IP 422 参数校验异常
4.1 通用返回结构
| 字段名 | 类型 | 说明 |
|---|---|---|
status |
string | success 等 |
code |
number | 业务状态码 |
message |
string | 提示信息 |
data |
object | 数据结果 |
4.2 data 字段(命中时)
data 为对象,包含:
| 字段名 | 类型 | 说明 |
|---|---|---|
total |
object | ES 命中总数 |
lst |
object[] | 命中列表 |
4.3 lst 单条元素字段
| 字段名 | 类型 | 说明 |
|---|---|---|
type |
string | 固定为 普通案例 |
id |
string | 案例 ID |
ah |
string | 案号 |
title |
string | 标题 |
ay |
string | 案由 |
jbdw |
string | 经办法院/承办单位 |
ajlb |
string | 案件类别 |
xzqh_p |
string | 省级行政区 |
wszl |
string | 文书种类 |
jafs |
string | 结案方式 |
cprq |
string | 日期 |
content |
string | 内容片段:优先高亮片段(当本次请求含关键词时),否则优先文书摘要总结,其次裁判分析过程段,最后回退为全文 |
llm_content |
string | 拼接字段:<ah>##<content> |
url |
string | 详情 URL:/ydzk/caseDetail/case/ + id |
score |
number | ES score |
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": 15467,
"lst": [
{
"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号",
"cj": "基层",
"spcx": "一审案件",
"type": "普通案例",
"title": "北京饮发酒业有限公司与陈向华买卖合同纠纷一审民事判决书",
"xzqh_c": "二中院",
"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": "https://ydzk.chineselaw.com/ydzk/caseDetail/case/938e1e392736fdf2208db6e5312f0041",
"score": 36.73003,
"ajlb": "民事案件",
"jafs": "判决",
"ay": [
"买卖合同纠纷"
],
"wszl": "判决书",
"jbdw": "北京市西城区人民法院",
"id": "938e1e392736fdf2208db6e5312f0041",
"xzqh_p": "北京"
},
{
"cprq": "2023年10月24日",
"llm_content": "(2023)京0106民初22061号##另,双方均同意将案涉房屋面积补差价16040元在逾期交房违约金中予以扣减,邓某无需另行交纳面积补差价。\n庭审中,双方均认可实际交房时间为2021年9月29日。\n2020年9月30日,邓某(买受人)与某公司(出卖人)签订编号《北京市商品房预售合同》,约定房屋坐落为丰台区南苑乡槐房村和新宫村1404-669地块669-27-2#地下车库×层×,总价款为420000元。出卖人应当于2021年9月30日前向买受人交付该商品房,逾期交付责任为(二)逾期超过180日,买受人有权解除合同,买受人不解除合同的,合同继续履行,出卖人按日计算向买受人支付全部房价款万分之一的违约金。双方均认可邓某已经交纳案涉车位款420000元,并同意以此金额为基数计算逾期交付违约金。\n庭审中,双方均认可实际交付车位时间为2022年7月17日。\n本院认为,依法成立的合同受法律保护。邓某与某公司签订的两份《北京市商品房预售合同》均系双方真实意思表示,不违反法律法规规定,合法有效,双方均应依约履行。\n关于逾期交房违约金,本案中,某公司逾期交房,构成违约,某公司应承担相应违约责任。某公司认可邓某主张的违约金计算基数、日万分之一的计算标准及违约金计算的期间,本院对此不持异议。经本院核算,邓某主张某公司支付其逾期交付违约金,某公司应支付邓某逾期交房违约金210204.55元,数额合理,予以支持。\n关于逾期交付车位违约金,某公司逾期交付地下车位,构成违约,某公司应承担相应违约责任。某公司认可邓某主张的违约金计算基数、日万分之一的计算标准及违约金计算的期间,本院对此不持异议。经本院核算,某公司应支付邓某逾期交付车位违约金12180元,超出部分不予支持。\n综上所述,依照《中华人民共和国民法典》第五百零九条、第五百七十七条、第五百八十五条,《中华人民共和国民事诉讼法》第一百六十五条之规定,判决如下:\n一、某投资有限公司于本判决生效之日起十日内支付邓某逾期交房违约金210204.55元;\n二、某投资有限公司于本判决生效之日起十日内支付邓某逾期交付车位违约金12180元;\n三、驳回邓某的其他诉讼请求。\n如果未按本判决指定的期间履行给付金钱义务,应当依照《中华人民共和国民事诉讼法》第二百六十条之规定,加倍支付迟延履行期间的债务利息。\n案件受理费10元,由某投资有限公司负担(于本判决生效之日起七日内交纳)。\n本判决为终审判决。\n审判员史艳\n二〇二三年十月二十四日\n书记员卢刘华",
"ah": "(2023)京0106民初22061号",
"cj": "基层",
"spcx": "一审案件",
"type": "普通案例",
"title": "邓某与某投资有限公司房屋买卖合同纠纷一审民事判决书",
"xzqh_c": "二中院",
"content": "另,双方均同意将案涉房屋面积补差价16040元在逾期交房违约金中予以扣减,邓某无需另行交纳面积补差价。\n庭审中,双方均认可实际交房时间为2021年9月29日。\n2020年9月30日,邓某(买受人)与某公司(出卖人)签订编号《北京市商品房预售合同》,约定房屋坐落为丰台区南苑乡槐房村和新宫村1404-669地块669-27-2#地下车库×层×,总价款为420000元。出卖人应当于2021年9月30日前向买受人交付该商品房,逾期交付责任为(二)逾期超过180日,买受人有权解除合同,买受人不解除合同的,合同继续履行,出卖人按日计算向买受人支付全部房价款万分之一的违约金。双方均认可邓某已经交纳案涉车位款420000元,并同意以此金额为基数计算逾期交付违约金。\n庭审中,双方均认可实际交付车位时间为2022年7月17日。\n本院认为,依法成立的合同受法律保护。邓某与某公司签订的两份《北京市商品房预售合同》均系双方真实意思表示,不违反法律法规规定,合法有效,双方均应依约履行。\n关于逾期交房违约金,本案中,某公司逾期交房,构成违约,某公司应承担相应违约责任。某公司认可邓某主张的违约金计算基数、日万分之一的计算标准及违约金计算的期间,本院对此不持异议。经本院核算,邓某主张某公司支付其逾期交付违约金,某公司应支付邓某逾期交房违约金210204.55元,数额合理,予以支持。\n关于逾期交付车位违约金,某公司逾期交付地下车位,构成违约,某公司应承担相应违约责任。某公司认可邓某主张的违约金计算基数、日万分之一的计算标准及违约金计算的期间,本院对此不持异议。经本院核算,某公司应支付邓某逾期交付车位违约金12180元,超出部分不予支持。\n综上所述,依照《中华人民共和国民法典》第五百零九条、第五百七十七条、第五百八十五条,《中华人民共和国民事诉讼法》第一百六十五条之规定,判决如下:\n一、某投资有限公司于本判决生效之日起十日内支付邓某逾期交房违约金210204.55元;\n二、某投资有限公司于本判决生效之日起十日内支付邓某逾期交付车位违约金12180元;\n三、驳回邓某的其他诉讼请求。\n如果未按本判决指定的期间履行给付金钱义务,应当依照《中华人民共和国民事诉讼法》第二百六十条之规定,加倍支付迟延履行期间的债务利息。\n案件受理费10元,由某投资有限公司负担(于本判决生效之日起七日内交纳)。\n本判决为终审判决。\n审判员史艳\n二〇二三年十月二十四日\n书记员卢刘华",
"url": "https://ydzk.chineselaw.com/ydzk/caseDetail/case/0ca39a9d5e0d1722122f9469e15a3e7d",
"score": 36.651863,
"ajlb": "民事案件",
"jafs": "判决",
"ay": [
"房屋买卖合同纠纷"
],
"wszl": "判决书",
"jbdw": "北京市丰台区人民法院",
"id": "0ca39a9d5e0d1722122f9469e15a3e7d",
"xzqh_p": "北京"
}
]
},
"message": "请求成功",
"status": "success"
}
5.3 成功响应示例(未命中)
{
"status": "success",
"code": 200,
"message": "未查询到相关内容"
}
5.4 失败响应示例
5.4.1 请求体为空
{
"status": "param verification failed",
"code": 422,
"message": "请求参数不能为空"
}
5.4.2 search_mode 非法
{
"status": "param verification failed",
"code": 422,
"message": "search_mode 不合法"
}
5.4.3 ft_search_mode 非法
{
"status": "param verification failed",
"code": 422,
"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());