3. 请求参数（Body）

id 与 fgmc 不能同时为空（否则返回 501）。

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

• body 为空 JSON：返回失败 message = "请求参数不能为空"
• id 与 fgmc 同时为空：返回失败（501）`message = "id和法规名称不可同时为空！"

4. 返回信息

• 返回类型：JSON 字符串

• 成功/失败判断：请求响应状态码

• 响应状态码说明

  响应状态码	说明
  200	接口调用成功
  500	程序异常，具体描述见message信息
  429	超流量拦截
  403	鉴权失败 / 黑名单被拒
  400	请求体解析失败/无法解析来源 IP
  422	参数校验异常

4.1 通用返回结构

4.2 返回字段说明（data）

4.2.1 法规详情对象字段

当返回的是法规详情时，data 来自 lawMap 中的法规概要信息（可能包含 content）。

法规详情接口

1. 基本信息

• 接口名称：法规详情接口
• 接口用途：查询法规详情。请求体不能为空，id与fgmc至少传一个；可传refer_date按指定日期定位当时有效版本，未传时返回当前有效版本相关详情。返回法规基础信息、时效性、发布日期、实施日期、发布部门、附件和法规内容。
  • 当传入 id 时：优先按 id 直接查询
  • 当未传 id 时：支持通过 fgmc（法规名称）定位并返回对应详情

2. 请求信息

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

3. 请求参数（Body）

id 与 fgmc 不能同时为空（否则返回 501）。

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

• body 为空 JSON：返回失败 message = "请求参数不能为空"
• id 与 fgmc 同时为空：返回失败（501）`message = "id和法规名称不可同时为空！"

4. 返回信息

• 返回类型：JSON 字符串

• 成功/失败判断：请求响应状态码

• 响应状态码说明

  响应状态码	说明
  200	接口调用成功
  500	程序异常，具体描述见message信息
  429	超流量拦截
  403	鉴权失败 / 黑名单被拒
  400	请求体解析失败/无法解析来源 IP
  422	参数校验异常

4.1 通用返回结构

4.2 返回字段说明（data）

4.2.1 法规详情对象字段

当返回的是法规详情时，data 来自 lawMap 中的法规概要信息（可能包含 content）。

5. 示例

5.1 请求示例（按法规 id 查询）

{
  "id": "aecabfbe6b0843642509a7f1ff865413"
}

5.2 请求示例（按法规名称定查询）

{
  "fgmc": "中华人民共和国刑法",
  "refer_date": "2025-01-01"
}

5.3 成功响应示例（法规详情）

{
  "code": 200,
  "data": {
    "type": "法规",
    "id": "aecabfbe6b0843642509a7f1ff865413",
    "fgid": "aecabfbe6b0843642509a7f1ff865413",
    "url": "/zxt/statuteDetail/detailPage/aecabfbe6b0843642509a7f1ff865413",
    "title": "中华人民共和国刑法(2023修正)",
    "fgmc": "中华人民共和国刑法(2023修正)",
    "content": "……",
    "sxx": "现行有效",
    "xljb_1": "法律",
    "xljb_2": "法律",
    "fbrq": "2023-12-29",
    "ssrq": "2024-03-01"
  },
  "status": "success",
  "message": "请求成功"
}

5.4 失败响应示例（id 与 fgmc 同时为空）

{
  "status": "param verification failed",
  "code": 422,
  "message": "id和法规名称不可同时为空！"
}

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

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

6. 代码示例

6.1 CURL

curl --location --request POST "https://open.chineselaw.com/open/rh_fg_detail" \
--header "X-API-Key: 你的api_key" \
--header "Accept: application/json" \
--header "Content-Type: application/json; charset=utf-8" \
--data-raw "{\"fgmc\": \"中华人民共和国刑法\", \"refer_date\": \"2025-01-01\"}"

6.2 Python

import requests

url = "https://open.chineselaw.com/open/rh_fg_detail"
API_KEY = "你的api_key"
headers = {
    "X-API-Key": API_KEY,
    "Accept": "application/json",
    "Content-Type": "application/json; charset=utf-8",
}
payload = {
    "fgmc": "中华人民共和国刑法",
    "refer_date": "2025-01-01",
}

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 RhFgDetailExample {

    static void main(String[] args) throws Exception {
        String apiKey = "你的api_key";
        String url = "https://open.chineselaw.com/open/rh_fg_detail";
        String body = "{\"fgmc\":\"中华人民共和国刑法\",\"refer_date\":\"2025-01-01\"}";

        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_detail";

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({
    fgmc: "中华人民共和国刑法",
    refer_date: "2025-01-01",
  }),
});

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