3. 请求参数（Body）

本接口 允许不传 keyword，不传则主要按过滤条件返回法规列表。

3.1 字段说明

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

• body 为空 JSON：返回失败 message = "请求参数不能为空"
• top_k 默认/上限：
  • 未传或 <=0：size = 10
  • >0：size = top_k
  • >50：size = 50
• search_mode 默认：
  • 未传或为空：AND
  • 否则：转大写（如 or -> OR）

5.1 通用返回结构（ResultVO）

5.2 data 列表单条元素字段（按代码组装）

法规关键词检索接口

1. 基本信息

• 接口名称：法规关键词检索接口
• 接口用途：对法规（法规概要/大纲）进行关键词检索与条件过滤，返回法规列表；当传入 keyword 时，会返回命中内容的高亮片段（若可获取）。

2. 请求信息

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

3. 请求参数（Body）

本接口 允许不传 keyword，不传则主要按过滤条件返回法规列表。

3.1 字段说明

3.2 校验与默认值

• body 为空 JSON：返回失败 message = "请求参数不能为空"
• top_k 默认/上限：
  • 未传或 <=0：size = 10
  • >0：size = top_k
  • >50：size = 50
• search_mode 默认：
  • 未传或为空：AND
  • 否则：转大写（如 or -> OR）

4. 返回信息

• 返回类型：JSON 字符串

4.1 通用返回结构

4.2 data 列表单条元素字段

5. 示例

5.1 请求参数示例（带 keyword）

{
  "keyword": "行政处罚",
  "search_mode": "AND",
  "fgmc": "中华人民共和国行政处罚法",
  "sxx": "现行有效",
  "top_k": 10
}

5.2 请求参数示例（不带 keyword，仅过滤）

{
  "sxx": "现行有效",
  "xljb_1": "法律",
  "top_k": 10
}

5.3 成功响应示例（data 为 list）

{
  "code": 200,
  "data": [
    {
      "fbbm": "全国人大常委会",
      "ssrq": "2021-07-15",
      "title": "中华人民共和国行政处罚法(2021修订)",
      "_score": 63.246273,
      "url": "/zxt/statuteDetail/detailPage/0c15f68cf89e1339125e9f41d5d31c67",
      "content": "……（keyword 命中时的高亮片段）……",
      "fwzh": "中华人民共和国主席令第70号",
      "sxx": "现行有效",
      "fbrq": "2021-01-22",
      "xljb_2": "法律",
      "xljb_1": "法律",
      "fgmc": "中华人民共和国行政处罚法(2021修订)",
      "id": "0c15f68cf89e1339125e9f41d5d31c67"
    },
    {
      "sxx": "现行有效",
      "fbrq": "1996-06-06",
      "xljb_2": "部门规范性文件",
      "xljb_1": "部门规章",
      "fgmc": "国家税务总局关于贯彻实施《中华人民共和国行政处罚法》的通知",
      "fbbm": "国家税务总局",
      "ssrq": "1996-06-06",
      "id": "174d6dcbe3762bb197b6481a7515d237",
      "title": "国家税务总局关于贯彻实施《中华人民共和国行政处罚法》的通知",
      "_score": 60.66238,
      "url": "/zxt/statuteDetail/detailPage/174d6dcbe3762bb197b6481a7515d237",
      "content": "……（keyword 命中时的高亮片段）……"
    }
  ],
  "message": "请求成功",
  "status": "success"
}

5.4 失败响应示例（程序异常）

{
  "data": null,
  "status": "failed",
  "code": 500,
  "message": "程序处理异常"
}

6. 代码示例

6.1 CURL

curl --location --request POST "https://open.chineselaw.com/open/rh_fg_search" \
--header "X-API-Key: 你的api_key" \
--header "Accept: application/json" \
--header "Content-Type: application/json; charset=utf-8" \
--data-raw "{\"keyword\": \"行政处罚\", \"search_mode\": \"AND\", \"fgmc\": \"中华人民共和国行政处罚法\", \"sxx\": \"现行有效\", \"top_k\": 2}"

6.2 Python

import requests

url = "https://open.chineselaw.com/open/rh_fg_search"
API_KEY = "你的api_key"
headers = {
    "X-API-Key": API_KEY,
    "Accept": "application/json",
    "Content-Type": "application/json; charset=utf-8",
}
payload = {
    "keyword": "行政处罚",
    "search_mode": "AND",
    "fgmc": "中华人民共和国行政处罚法",
    "sxx": "现行有效",
    "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 RhFgSearchExample {

    static void main(String[] args) throws Exception {
        String apiKey = "你的api_key";
        String url = "https://open.chineselaw.com/open/rh_fg_search";
        String body = "{\"keyword\":\"行政处罚\",\"search_mode\":\"AND\","
                + "\"fgmc\":\"中华人民共和国行政处罚法\",\"sxx\":\"现行有效\",\"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_fg_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({
    keyword: "行政处罚",
    search_mode: "AND",
    fgmc: "中华人民共和国行政处罚法",
    sxx: "现行有效",
    top_k: 2,
  }),
});

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

7. 备注

• 该接口返回的是法规概要字段集合，默认 不返回法规全文；