3. 请求参数（Body）

3.1 字段说明

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

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

5.1 通用返回结构（ResultVO）

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

法条关键词检索接口

1. 基本信息

• 接口名称：法条关键词检索接口
• 接口用途：根据关键词检索法条内容，并可按法规名称、效力级别、时效性、发布日期/实施日期范围等条件过滤；返回法条列表并补充所属法规的关键信息。

2. 请求信息

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

3. 请求参数（Body）

3.1 字段说明

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

• body 为空 JSON：返回失败 message = "请求参数不能为空"
• keyword 为空：返回失败（501）message = "keyword 参数不可为空！"
• 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": "行政处罚",
  "search_mode": "AND",
  "fgmc": "中华人民共和国行政处罚法",
  "sxx": "现行有效",
  "top_k": 10
}

5.2 成功响应示例

{
  "code": 200,
  "data": [
    {
      "llm_content": " - 《中华人民共和国行政处罚法(2021修订)》第五十九条##　行政机关依照本法第五十七条的规定给予行政处罚，应当制作行政处罚决定书。行政处罚决定书应当载明下列事项： \n（一）当事人的姓名或者名称、地址； \n（二）违反法律、法规、规章的事实和证据； \n（三）行政处罚的种类和依据； \n（四）行政处罚的履行方式和期限； \n（五）申请行政复议、提起行政诉讼的途径和期限； \n（六）作出行政处罚决定的行政机关名称和作出决定的日期。 \n行政处罚决定书必须盖有作出行政处罚决定的行政机关的印章。",
      "ft_num": "第五十九条",
      "fbbm": "全国人大常委会",
      "ssrq": "2021-07-15",
      "_score": 52.875587,
      "title": "中华人民共和国行政处罚法(2021修订)第五十九条",
      "tid": "59",
      "url": "/zxt/statuteDetail/detailPage/0c15f68cf89e1339125e9f41d5d31c67?text=59",
      "content": "　行政机关依照本法第五十七条的规定给予行政处罚，应当制作行政处罚决定书。行政处罚决定书应当载明下列事项： \n（一）当事人的姓名或者名称、地址； \n（二）违反法律、法规、规章的事实和证据； \n（三）行政处罚的种类和依据； \n（四）行政处罚的履行方式和期限； \n（五）申请行政复议、提起行政诉讼的途径和期限； \n（六）作出行政处罚决定的行政机关名称和作出决定的日期。 \n行政处罚决定书必须盖有作出行政处罚决定的行政机关的印章。",
      "fwzh": "中华人民共和国主席令第70号",
      "sxx": "现行有效",
      "fgid": "0c15f68cf89e1339125e9f41d5d31c67",
      "ftmc": "中华人民共和国行政处罚法(2021修订)第五十九条",
      "fbrq": "2021-01-22",
      "xljb_2": "法律",
      "xljb_1": "法律",
      "fgmc": "中华人民共和国行政处罚法(2021修订)",
      "id": "0c15f68cf89e1339125e9f41d5d31c67_59"
    },
    {
      "llm_content": " - 《中华人民共和国行政处罚法(2021修订)》第十一条##　行政法规可以设定除限制人身自由以外的行政处罚。 \n法律对违法行为已经作出行政处罚规定，行政法规需要作出具体规定的，必须在法律规定的给予行政处罚的行为、种类和幅度的范围内规定。 \n法律对违法行为未作出行政处罚规定，行政法规为实施法律，可以补充设定行政处罚。拟补充设定行政处罚的，应当通过听证会、论证会等形式广泛听取意见，并向制定机关作出书面说明。行政法规报送备案时，应当说明补充设定行政处罚的情况。",
      "ft_num": "第十一条",
      "fbbm": "全国人大常委会",
      "ssrq": "2021-07-15",
      "_score": 52.751797,
      "title": "中华人民共和国行政处罚法(2021修订)第十一条",
      "tid": "11",
      "url": "/zxt/statuteDetail/detailPage/0c15f68cf89e1339125e9f41d5d31c67?text=11",
      "content": "　行政法规可以设定除限制人身自由以外的行政处罚。 \n法律对违法行为已经作出行政处罚规定，行政法规需要作出具体规定的，必须在法律规定的给予行政处罚的行为、种类和幅度的范围内规定。 \n法律对违法行为未作出行政处罚规定，行政法规为实施法律，可以补充设定行政处罚。拟补充设定行政处罚的，应当通过听证会、论证会等形式广泛听取意见，并向制定机关作出书面说明。行政法规报送备案时，应当说明补充设定行政处罚的情况。",
      "fwzh": "中华人民共和国主席令第70号",
      "sxx": "现行有效",
      "fgid": "0c15f68cf89e1339125e9f41d5d31c67",
      "ftmc": "中华人民共和国行政处罚法(2021修订)第十一条",
      "fbrq": "2021-01-22",
      "xljb_2": "法律",
      "xljb_1": "法律",
      "fgmc": "中华人民共和国行政处罚法(2021修订)",
      "id": "0c15f68cf89e1339125e9f41d5d31c67_11"
    }
  ],
  "message": "请求成功",
  "status": "success"
}

5.3 失败响应示例（keyword 为空）

{
  "data": null,
  "status": "failed",
  "code": 501,
  "message": "keyword 参数不可为空！"
}

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

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

6. 代码示例

6.1 CURL

curl --location --request POST "https://open.chineselaw.com/open/rh_ft_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_ft_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 RhFtSearchExample {

    static void main(String[] args) throws Exception {
        String apiKey = "你的api_key";
        String url = "https://open.chineselaw.com/open/rh_ft_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_ft_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());