3. 请求参数（Body）

以下字段均为可选字段，但 请求体不能为空（至少一个检索字段非空<top_k 不计入>，空会返回失败）。

cfsj_start 不得晚于 cfsj_end。

3.1 字段说明

4. 返回信息

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

4.1 通用返回结构

4.2 data 字段单条元素字段（命中时）

data 为对象数组，对象主要字段如下：

监管案例关键词检索接口

1. 基本信息

• 接口名称：监管案例关键词检索接口
• 接口用途：检索监管案例列表。支持按标题、公司全称、被处罚主体名称、处罚机构、监管类型、处罚时间和全文关键词过滤；请求体不能为空。返回命中总数和案例列表，content为正文内容。

2. 请求信息

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

3. 请求参数（Body）

以下字段均为可选字段，但 请求体不能为空（至少一个检索字段非空<top_k 不计入>，空会返回失败）。

cfsj_start 不得晚于 cfsj_end。

3.1 字段说明

4. 返回信息

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

4.1 通用返回结构

4.2 data 字段单条元素字段（命中时）

data 为对象数组，对象主要字段如下：

5. 示例

5.1 请求参数示例

{
  "search_mode": "OR",
  "title": "行政处罚",
  "cfsj_start": "2023-01-01",
  "cfsj_end": "2023-12-31",
  "top_k": 2
}

5.2 成功响应示例（命中）

{
    "code": 200,
    "data": [
        {
            "发文时间": "2023-03-08 14:18:59",
            "监管类型": "行政处罚",
            "标题": "新疆银保监局行政处罚信息公开表（新银保监罚决字〔2023〕7号）",
            "处罚机构": "中国银行保险监督管理委员会新疆监管局",
            "内容": "（张伟伟）\n行政处罚决定书文号\n\t新银保监罚决字〔2023〕7号\n被处罚当事人姓名或名称\n\t个人姓名\n\t张伟伟\n单位\n\t名称\n\t法定代表人（主要负责人）姓名\n\t主要违法违规事实（案由）\n\t担任邮储银行天山区支行行长期间，对该支行未有效监督个人贷款资金使用，致使贷款资金被挪用的违法违规行为负有责任。\n行政处罚依据\n\t《中华人民共和国银行业监督管理法》第二十一条、第四十八条；《个人贷款管理暂行办法》第三十四条、第三十五条、第四十二条和相关审慎经营规则。\n行政处罚决定\n\t警告，罚款人民币六万元\n作出处罚决定的机关名称\n\t中国银行保险监督管理委员会\n新疆监管局\n作出处罚决定的日期\n\t2023年3月1日",
            "链接": "http://www.cbirc.gov.cn/cbircweb/DocInfo/SelectByDocId?docId=1099019",
            "处罚时间": "2023-03-01 00:00:00",
            "数据id": 9877,
            "处罚字号": "新银保监罚决字〔2023〕7号"
        },
        {
            "发文时间": "2023-03-03 14:49:54",
            "监管类型": "行政处罚",
            "标题": "中国银保监会江西监管局2023年第16号行政处罚信息公开表",
            "处罚机构": "中国银保监会江西监管局",
            "内容": "（赣州银行股份有限公司昌南支行）\n行政处罚决定书文号\n\t赣银保监罚决字〔2023〕16号\n被处罚当事人姓名或名称\n\t个人姓名\n\t单位\n\t名称\n\t赣州银行股份有限公司昌南支行\n法定代表人（主要负责人）姓名\n\t邱俊\n主要违法违规事实（案由）\n\t银行承兑汇票保证金来自贷款\n行政处罚依据\n\t《中华人民共和国银行业监督管理法》第四十六条\n行政处罚决定\n\t罚款30万元\n作出处罚决定的机关名称\n\t中国银保监会江西监管局\n作出处罚决定的日期\n\t2023年2月23日",
            "链接": "http://www.cbirc.gov.cn/cbircweb/DocInfo/SelectByDocId?docId=1098410",
            "处罚时间": "2023-02-23 00:00:00",
            "公司全称": "赣州银行股份有限公司昌南支行",
            "数据id": 9908,
            "处罚字号": "赣银保监罚决字〔2023〕16号"
        }
    ],
    "message": "请求成功",
    "status": "success"
}

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

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

6. 代码示例

6.1 CURL

curl --location --request POST "https://open.chineselaw.com/open/rh_zqcfws_search" \
--header "X-API-Key: 你的api_key" \
--header "Accept: application/json" \
--header "Content-Type: application/json; charset=utf-8" \
--data-raw "{\"search_mode\":\"OR\",\"title\":\"行政处罚\",\"cfsj_start\":\"2023-01-01\",\"cfsj_end\":\"2023-12-31\",\"top_k\":2}"

6.2 Python

import requests

url = "https://open.chineselaw.com/open/rh_zqcfws_search"
API_KEY = "你的api_key"
headers = {
    "X-API-Key": API_KEY,
    "Accept": "application/json",
    "Content-Type": "application/json; charset=utf-8",
}
payload = {
    "search_mode": "OR",
    "title": "行政处罚",
    "cfsj_start": "2023-01-01",
    "cfsj_end": "2023-12-31",
    "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 RhJgalSearchExample {

    static void main(String[] args) throws Exception {
        String apiKey = "你的api_key";
        String url = "https://open.chineselaw.com/open/rh_zqcfws_search";
        String body = "{\"search_mode\":\"OR\",\"title\":\"行政处罚\",\"cfsj_start\":\"2023-01-01\",\"cfsj_end\":\"2023-12-31\",\"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_zqcfws_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({
    "search_mode": "OR",
    "title": "行政处罚",
    "cfsj_start": "2023-01-01",
    "cfsj_end": "2023-12-31",
    "top_k": 2
  }),
});

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