# 法规 API 接口文档
> 法律之星开放平台 RESTful API 文档，覆盖标准版、专业版、语义版、法条查询四条产品线。
> 所有接口调用前需先通过「接口登录获取 Token」拿到 `Authorization`。
## 接口总览
### 法规精准查询接口 · 标准版
- `POST` [接口登录获取 Token](/api/auth/login)
- `GET` [法规精准查询](/api/lawData/query)
- `GET` [获取法规详情](/api/lawData/detail)
- `GET` [法规批量下载](/api/lawData/getDetailDownUrlByRids)
- `GET` [效力级别代码字典](/api/lawData/lawLevel3)
- `POST` [适用区域代码字典](/api/lawData/area)
### 法规精准查询接口 · 专业版
- `POST` [接口登录获取 Token](/api/auth/login)
- `GET` [专业版快捷搜索](/api/lawData/professional/query)
- `GET` [专业版高级搜索](/api/lawData/professional/kquery)
- `GET` [专业版法规详情](/api/lawData/professional/detail)
- `GET` [效力级别代码字典](/api/lawData/lawLevel3)
- `POST` [适用区域代码字典](/api/lawData/area)
- `POST` [发文机关代码字典](/api/lawData/depts)
- `GET` [专业版法规批量下载](/api/lawData/professional/getDetailDownUrlByRids)
### 法规语义查询接口
- `POST` [接口登录获取 Token](/api/auth/login)
- `GET` [法规语义查询](/api/lawData/xlquerynew)
- `GET` [语义版法规详情](/api/lawData/xldetail)
- `GET` [语义版获取效力级别代码](/api/lawData/lawLevel3Vector)
### 法条查询接口
- `POST` [接口登录获取Token](/api/auth/login)
- `GET` [法条查询接口](/api/lawData/lawnumberquery)
---
## 接口详情
## 接口登录获取 Token
- **路径**：`POST /api/auth/login`
- **简介**：调用所有业务接口前必须先登录获取 Authorization。
- **所属分类**：standard、professional、semantic
### 请求参数
| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | :-: | --- |
| `appid` | string | 是 | 平台分配的 AppID |
| `appsecret` | string | 是 | 平台分配的密钥 |
### 响应参数
| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `code` | string | 状态码，"200"=成功 |
| `msg` | string | 响应描述，成功时如 "JWT认证成功" |
| `data.Authorization` | string | 后续接口需携带的鉴权 Token |
| `data.AppID` | string | 平台分配的应用 ID |
### 响应示例
```json
{
  "code": "200",
  "msg": "JWT认证成功",
  "data": {
    "Authorization": "eyJ0eXAiOiJKV1QiL...",
    "AppID": "your-appid"
  }
}
```
### 备注说明
Token 有效期约 5 分钟，建议每次调用业务接口前重新获取。或在API返回错误信息时重新获取Token重试
## 法规精准查询
- **路径**：`GET /api/lawData/query`
- **简介**：基于关键词、效力级别、区域等条件分页检索法规列表。
- **所属分类**：standard
### 请求参数
| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | :-: | --- |
| `field` | string | 是 | 排序方式：rDate=发布日期，lawlevel=效力级别 |
| `page` | int | 是 | 页码，从 1 开始 |
| `rows` | int | 是 | 每页条数，最大 50 |
| `keyword` | string | 是 | 查询关键词，多词空格分隔（AND 逻辑） |
| `effective3` | string | 否 | 效力级别代码 |
| `depNumber` | string | 否 | 区域代码，多值逗号分隔 |
| `fileNum` | string | 否 | 发文字号 |
| `depName` | string | 否 | 发文机关 |
| `startDate` | string | 否 | 发布日期开始年，格式 YYYY |
| `endDate` | string | 否 | 发布日期结束年，格式 YYYY |
| `startDate1` | string | 否 | 实施日期开始年，格式 YYYY |
| `endDate1` | string | 否 | 实施日期结束年，格式 YYYY |
| `titleOnly` | string | 否 | 是否仅查询标题：true/false |
| `timelinessnew` | string | 否 | 时效性：0=未实施，1=有效，2=失效，3=已修改，4=草案 |
| `synonym` | string | 否 | 是否开启同义词：1=开启，0=关闭 |
| `improvekey` | string | 否 | 是否兜底分词：1=开启，0=关闭，默认关闭 |
### 响应参数
| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `code` | string | 状态码，"200"=成功 |
| `msg` | string | 错误信息，成功时为空 |
| `data.count` | int | 命中总条数 |
| `data.lawdata` | array | 法规列表数组 |
| `data.lawdata[].lawId` | string | 法规唯一 ID |
| `data.lawdata[].lawName` | string | 法规名称（含高亮标记） |
| `data.lawdata[].issuingOrgan` | string | 发文机关 |
| `data.lawdata[].issuingNo` | string | 发文字号 |
| `data.lawdata[].releaseYearMonthDate` | string | 发布日期 yyyy年MM月dd日 |
| `data.lawdata[].implementYearMonthDate` | string | 实施日期 yyyy年MM月dd日 |
| `data.lawdata[].timeliness` | string | 时效性 |
| `data.pageSize` | int | 每页条数 |
| `data.totalPage` | int | 总页数 |
### 响应示例
```json
{
  "code": "200",
  "msg": "查询成功",
  "data": {
    "lawdata": [
      {
        "lawId": "C15BE8F4872828991BD3A1FA88DDDB3B",
        "lawName": "中华人民共和国劳动合同法",
        "issuingOrgan": " 全国人大常委会",
        "issuingNo": "中华人民共和国主席令第65号",
        "releaseYearMonthDate": "2007年06月29日",
        "implementYearMonthDate": "2008年01月01日",
        "timeliness": "已修改"
      }
    ],
    "count": 1089,
    "pageSize": 10,
    "totalPage": 109
  }
}
```
### 备注说明
关键词命中部分会用 <span> 标签高亮；同义词扩展默认关闭。improvekey=1 时，若直接检索结果不足 50 条，会在 keyword 中提取关键词做分词兜底检索。
## 专业版快捷搜索
- **路径**：`GET /api/lawData/professional/query`
- **简介**：单组关键词搜索，同时匹配标题+正文，支持多条件组合筛选。
- **所属分类**：professional
### 请求参数
| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | :-: | --- |
| `page` | int | 是 | 当前页数 |
| `rows` | int | 是 | 每页条数，1-50 |
| `field` | string | 否 | 排序字段：rDate=日期，lawlevel=效力 |
| `keyword` | string | 否 | 关键词，多个用空格分隔 |
| `effective3` | string | 否 | 法规效力代码，多个用逗号分隔 |
| `timelinessnew` | string | 否 | 时效性 0=未实施，1=有效，2=失效，3=已修改，4=草案 |
| `fileNum` | string | 否 | 文号 |
| `depName` | string | 否 | 发文机关名称 |
| `depNumber` | string | 否 | 发文机关代码，JSON 格式 |
| `areaNumber` | string | 否 | 适用区域代码，JSON 格式 |
| `startDate` | int | 否 | 发布日期起始 yyyyMMdd |
| `endDate` | int | 否 | 发布日期结束 yyyyMMdd |
| `startDate1` | int | 否 | 实施日期起始 yyyyMMdd |
| `endDate1` | int | 否 | 实施日期结束 yyyyMMdd |
| `synonym` | string | 否 | 同义词搜索：0=关闭，1=开启 |
| `improvekey` | string | 否 | 是否兜底分词：1=开启，0=关闭，默认关闭 |
### 响应参数
| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `code` | string | 状态码 |
| `msg` | string | 响应信息 |
| `data.count` | string | 总结果数 |
| `data.lawdata` | array | 法规列表数组 |
| `data.lawdata[].lawId` | string | 法规 ID |
| `data.lawdata[].lawName` | string | 法规标题 |
| `data.lawdata[].issuingOrgan` | string | 发文机关 |
| `data.lawdata[].issuingNo` | string | 文号 |
| `data.lawdata[].releaseYearMonthDate` | string | 发布日期 |
| `data.lawdata[].implementYearMonthDate` | string | 实施日期 |
| `data.lawdata[].timeliness` | string | 时效性 |
### 响应示例
```json
{
  "code": "200",
  "msg": "查询成功",
  "data": {
    "count": "128",
    "pageSize": "10",
    "totalPage": "13",
    "lawdata": [
      {
        "lawId": "9290371FFCFF068ECABB2AFB215CDCEA",
        "lawName": "中华人民共和国民法典",
        "issuingOrgan": "全国人民代表大会",
        "issuingNo": "中华人民共和国主席令第45号",
        "releaseYearMonthDate": "2020年05月28日",
        "implementYearMonthDate": "2021年01月01日",
        "timeliness": "现行有效"
      }
    ]
  }
}
```
## 专业版高级搜索
- **路径**：`GET /api/lawData/professional/kquery`
- **简介**：多组关键词搜索，可指定标题/正文检索，支持且/或逻辑。
- **所属分类**：professional
### 请求参数
| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | :-: | --- |
| `page` | int | 是 | 当前页数 |
| `rows` | int | 是 | 每页条数，1-50 |
| `field` | string | 否 | 排序字段 |
| `searchtype` | int | 否 | 关键词组合：0=且，1=或 |
| `keywords` | string | 否 | 关键词组，格式 "0;修订 决定" |
| `effective3` | string | 否 | 法规效力代码 |
| `timelinessnew` | string | 否 | 时效性，多个用逗号分隔 |
| `fileNum` | string | 否 | 文号 |
| `depName` | string | 否 | 发文机关名称 |
| `depNumber` | string | 否 | 发文机关代码，JSON 格式 |
| `areaNumber` | string | 否 | 适用区域代码，JSON 格式 |
| `startDate` | int | 否 | 发布日期起始 yyyyMMdd |
| `endDate` | int | 否 | 发布日期结束 yyyyMMdd |
| `startDate1` | int | 否 | 实施日期起始 yyyyMMdd |
| `endDate1` | int | 否 | 实施日期结束 yyyyMMdd |
### 响应参数
| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `code` | string | 状态码 |
| `msg` | string | 响应信息 |
| `data` | object | 查询结果，结构与快捷搜索一致 |
### 响应示例
```json
{
  "code": "200",
  "msg": "查询成功",
  "data": {
    "count": "50",
    "lawdata": [...]
  }
}
```
### 备注说明
keywords 参数格式："范围;关键词"，范围 0=标题，1=正文；可传多个 keywords 参数实现多组检索。
## 获取法规详情
- **路径**：`GET /api/lawData/detail`
- **简介**：根据法规 ID 获取全文正文及完整信息。
- **所属分类**：standard
### 请求参数
| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | :-: | --- |
| `rjs8` | string | 是 | 法规 ID，来自查询接口的 lawId |
### 响应参数
| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `code` | string | 状态码，"200"=成功 |
| `msg` | string | 响应信息 |
| `data.lawName` | string | 法规名称 |
| `data.rjs8` | string | 法规 ID |
| `data.issuingOrgan` | string | 发文机关 |
| `data.releaseYearMonthDate` | string | 发布日期 |
| `data.implementYearMonthDate` | string | 实施日期 |
| `data.issuingNo` | string | 发文字号 |
| `data.timeliness` | string | 时效性 |
| `data.lawSourceContent` | string | 法规全文，HTML 格式 |
| `data.enclosure` | array | 附件列表 |
### 响应示例
```json
{
  "code": "200",
  "msg": "查询成功",
  "data": {
    "lawName": "中华人民共和国劳动合同法",
    "rjs8": "C15BE8F4872828991BD3A1FA88DDDB3B",
    "issuingOrgan": " 全国人大常委会",
    "releaseYearMonthDate": "2007年06月29日",
    "implementYearMonthDate": "2008年01月01日",
    "issuingNo": "中华人民共和国主席令第65号",
    "timeliness": "已修改",
    "lawSourceContent": "<p style='text-align:center'><strong>中华人民共和国劳动合同法</strong></p>...",
    "enclosure": []
  }
}
```
## 专业版法规详情
- **路径**：`GET /api/lawData/professional/detail`
- **简介**：通过法规 ID 查询法规全文、沿革、下载地址等信息。
- **所属分类**：professional
### 请求参数
| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | :-: | --- |
| `rjs8` | string | 是 | 法规 ID |
### 响应参数
| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `code` | string | 状态码 |
| `data.lawName` | string | 法规标题 |
| `data.rjs8` | string | 法规 ID |
| `data.lawSourceContent` | string | 法规正文，HTML 格式 |
| `data.downdetailurl` | string | DOCX 下载地址 |
| `data.downdetailurlpdf` | string | PDF 下载地址 |
| `data.hisgroup` | object | 法律沿革 |
| `data.tocItem` | array | 目录结构 |
| `data.enclosure` | array | 附件 |
### 响应示例
```json
{
  "code": "200",
  "msg": "查询成功",
  "data": {
    "lawName": "中华人民共和国民法典",
    "rjs8": "9290371FFCFF068ECABB2AFB215CDCEA",
    "lawSourceContent": "<p>...</p>",
    "downdetailurl": "/api/lawData/detaildownload?data=...",
    "downdetailurlpdf": "/api/lawData/detaildownload?data=...",
    "hisgroup": {},
    "tocItem": [],
    "enclosure": []
  }
}
```
### 备注说明
专业版详情返回额外的沿革信息、目录结构和下载地址。
## 法规批量下载
- **路径**：`GET /api/lawData/getDetailDownUrlByRids`
- **简介**：批量生成法规 DOCX/PDF 压缩包，单次最多 25 篇。
- **所属分类**：standard
### 请求参数
| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | :-: | --- |
| `rids` | string | 是 | 法规 ID 列表，英文逗号分隔，最多 25 个 |
| `type` | int | 是 | 文件格式：0=Word，1=PDF |
### 响应参数
| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `code` | string | 状态码 |
| `data.downloadUrl` | string | 压缩包下载链接 |
### 响应示例
```json
{
  "code": "200",
  "msg": "请求成功",
  "data": {
    "downloadUrl": "https://api.law-star.com/download/xxx.zip"
  }
}
```
## 法规语义查询
- **路径**：`GET /api/lawData/xlquerynew`
- **简介**：基于自然语言语义检索法规，支持向量+关键词混合检索。
- **所属分类**：semantic
### 请求参数
| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | :-: | --- |
| `vector` | string | 否 | 向量检索关键词（核心语义查询） |
| `keyword` | string | 否 | 标题关键词，多值空格分隔 |
| `rows` | int | 否 | 返回条数，默认 10，最大 100 |
| `fbdwFacet` | string | 否 | 发文机关筛选 |
| `lawstatexlsFacet` | string | 否 | 时效性：0=未实施，1=有效，2=失效，4=已修改 |
| `areaFacet` | string | 否 | 适用范围，多值空格分隔 |
| `topicsFacet` | string | 否 | 部委系统筛选 |
| `filenum` | string | 否 | 文号 |
| `xls` | string | 否 | 效力级别代码，多值空格分隔 |
| `rawnumber` | string | 否 | 条款号，仅支持第x条格式 |
| `searchtype` | int | 否 | 优化查询：1=开启（含时效过滤），不传=关闭 |
| `sortype` | int | 否 | 优化排序：1=开启（按效力位阶重排序），不传=关闭 |
| `checkTime` | string | 否 | 校验时间，格式 yyyyMMdd（如 20230601）。传入后只返回在该日期正在生效实施的法规条款，自动过滤当时尚未施行或已失效的版本；不传则返回当前现行有效版本 |
### 响应参数
| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `code` | string | 状态码，"200"=成功 |
| `data.result` | array | 语义匹配结果数组 |
| `data.result[].lawId` | string | 法规 ID（用于查详情） |
| `data.result[].lawName` | string | 法规标题 |
| `data.result[].score` | float | 语义匹配度分数 |
| `data.result[].issuingOrgan` | string | 发布部门 |
| `data.result[].timeliness` | string | 有效性 |
| `data.result[].xls` | string | 效力等级 |
| `data.result[].content` | string | 命中法规切片内容 |
| `data.result[].releaseYearMonthDate` | int | 发布日期 |
| `data.result[].implementYearMonthDate` | int | 实施日期 |
| `data.result[].rawnumber` | string | 条款号 |
### 响应示例
```json
{
  "code": "200",
  "msg": "查询成功",
  "data": {
    "result": [
      {
        "lawId": "C15BE8F4872828991BD3A1FA88DDDB3B",
        "lawName": "中华人民共和国劳动合同法",
        "score": 0.95,
        "issuingOrgan": "全国人大常委会",
        "timeliness": "已修改",
        "xls": "001001002",
        "content": "......",
        "releaseYearMonthDate": 20070629,
        "implementYearMonthDate": 20080101
      }
    ]
  }
}
```
### 备注说明
vector 参数为核心语义查询入口，keyword 为标题关键词辅助筛选；返回结果按语义匹配度排序。searchtype（优化查询）与 sortype（按效力位阶重排序）可同时开启、双开效果最佳。注意 lawstatexlsFacet 时效性取值为：0=未实施，1=有效，2=失效，4=已修改（"已修改"是 4 不是 3）。
## 语义版法规详情
- **路径**：`GET /api/lawData/xldetail`
- **简介**：语义查询后根据法规 ID 获取全文正文。
- **所属分类**：semantic
### 请求参数
| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | :-: | --- |
| `rjs8` | string | 是 | 法规 ID，来自语义查询接口的 lawId |
### 响应参数
| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `code` | string | 状态码 |
| `data.lawName` | string | 法规标题 |
| `data.rjs8` | string | 法规 ID |
| `data.lawSourceContent` | string | 法规全文，HTML 格式 |
| `data.enclosure` | array | 附件列表 |
### 响应示例
```json
{
  "code": "200",
  "msg": "查询成功",
  "data": {
    "lawName": "中华人民共和国劳动合同法",
    "rjs8": "C15BE8F4872828991BD3A1FA88DDDB3B",
    "lawSourceContent": "<p>...</p>",
    "enclosure": []
  }
}
```
## 效力级别代码字典
- **路径**：`GET /api/lawData/lawLevel3`
- **简介**：获取法规效力级别对应的编码，供查询接口筛选使用。
- **所属分类**：standard、professional
### 请求参数
本接口无请求参数。
### 响应参数
| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `code` | string | 状态码 |
| `data` | array | 效力级别树形结构数组 |
| `data[].law_number` | string | 效力级别代码 |
| `data[].law_name` | string | 效力级别名称 |
| `data[].children` | array | 子级别列表 |
### 响应示例
```json
{
  "code": "200",
  "msg": "请求成功",
  "data": [
    {
      "law_number": "001",
      "law_name": "法律",
      "children": [
        { "law_number": "001001", "law_name": "宪法和法律", "children": [...] }
      ]
    }
  ]
}
```
### 备注说明
返回三级嵌套树形结构。语义版使用 lawLevel3Vector 接口，结构类似。
## 适用区域代码字典
- **路径**：`POST /api/lawData/area`
- **简介**：获取法规适用区域对应的编码，供查询接口筛选使用。
- **所属分类**：standard、professional
### 请求参数
本接口无请求参数。
### 响应参数
| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `code` | string | 状态码 |
| `data` | array | 区域树形结构数组 |
| `data[].dep_number` | string | 区域代码 |
| `data[].dep_name` | string | 区域名称 |
| `data[].deptfl` | int | 层级标记：1=省，2=市，0=全国 |
| `data[].children` | array | 子级区域列表 |
### 响应示例
```json
{
  "code": "200",
  "msg": "请求成功",
  "data": [
    {
      "dep_number": "000",
      "dep_name": "全国",
      "deptfl": 0,
      "children": []
    },
    {
      "dep_number": "801",
      "dep_name": "北京市",
      "deptfl": 1,
      "children": [
        { "dep_number": "80101", "dep_name": "北京市东城区", "deptfl": 1, "children": null }
      ]
    }
  ]
}
```
## 发文机关代码字典
- **路径**：`POST /api/lawData/depts`
- **简介**：获取各发文机关对应的编码列表，供专业版筛选使用。
- **所属分类**：professional
### 请求参数
本接口无请求参数。
### 响应参数
| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `code` | string | 状态码 |
| `data` | array | 发文机关列表 |
### 响应示例
```json
{
  "code": "200",
  "msg": "请求成功",
  "data": [
    { "dep_number": "401", "dep_name": "国务院", "deptfl": 1, "children": [...] }
  ]
}
```
### 备注说明
本接口仅专业版提供。
## 专业版法规批量下载
- **路径**：`GET /api/lawData/professional/getDetailDownUrlByRids`
- **简介**：专业版批量生成法规 DOCX/PDF 压缩包，单次最多 25 篇。参数与标准版一致，URL 不同。
- **所属分类**：professional
### 请求参数
| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | :-: | --- |
| `rids` | string | 是 | 法规 ID 列表，英文逗号分隔，最多 25 个 |
| `type` | int | 是 | 文件格式：0=Word，1=PDF |
### 响应参数
| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `code` | string | 状态码 |
| `data.downloadUrl` | string | 压缩包下载链接 |
### 响应示例
```json
{
  "code": "200",
  "msg": "请求成功",
  "data": {
    "downloadUrl": "https://api.law-star.com/download/xxx.zip"
  }
}
```
### 备注说明
请求参数与标准版批量下载完全一致，仅 URL 不同。
## 语义版获取效力级别代码
- **路径**：`GET /api/lawData/lawLevel3Vector`
- **简介**：语义版配套的效力级别代码字典，URL 不同（lawLevel3Vector），结构与标准版一致。
- **所属分类**：semantic
### 请求参数
本接口无请求参数。
### 响应参数
| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `code` | string | 状态码 |
| `data` | array | 效力级别树形结构数组 |
| `data[].law_number` | string | 效力级别代码 |
| `data[].law_name` | string | 效力级别名称 |
| `data[].children` | array | 子级别列表 |
### 响应示例
```json
{
  "code": "200",
  "msg": "请求成功",
  "data": [
    {
      "law_number": "001",
      "law_name": "法律",
      "children": [
        { "law_number": "001001", "law_name": "宪法和法律", "children": [...] }
      ]
    }
  ]
}
```
### 备注说明
返回三级嵌套树形结构，与标准版 lawLevel3 接口结构一致。
## 接口登录获取Token
- **路径**：`POST /api/auth/login`
- **简介**：调用法条查询接口前必须先登录获取 Authorization。
- **所属分类**：lawnumber
### 请求参数
| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | :-: | --- |
| `appid` | string | 是 | 平台分配的 AppID |
| `appsecret` | string | 是 | 平台分配的密钥 |
### 响应参数
| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `code` | string | 状态码，"200"=成功 |
| `msg` | string | 响应描述 |
| `data.Authorization` | string | 后续接口需携带的鉴权 Token |
| `data.AppID` | string | 平台分配的应用 ID |
### 响应示例
```json
{
  "code": "200",
  "msg": "JWT认证成功",
  "data": {
    "Authorization": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
    "AppID": "your-appid"
  }
}
```
### 备注说明
Token 有效期约 5 分钟，建议每次调用业务接口前重新获取。
## 法条查询接口
- **路径**：`GET /api/lawData/lawnumberquery`
- **简介**：基于法规标题关键词和条款号，结合校验日期精确检索法规条款。
- **所属分类**：lawnumber
### 请求参数
| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | :-: | --- |
| `keyword` | string | 是 | 法规标题关键词，多个用空格分隔（AND 逻辑）。如"刑法"、"民法典" |
| `rawnumber` | string | 是 | 条款号，支持中文（如"第一百一十一条"）或数字（如"111"） |
| `checkTime` | string | 否 | 校验日期，格式 yyyyMMdd（如 20250101）。只返回实施日期 ≤ 校验日期且未失效的条款。不填默认当前日期 |
| `rows` | int | 否 | 返回条数，默认 10，最大 100 |
| `areaFacet` | string | 否 | 适用范围（地域名称），如"北京" |
### 响应参数
| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `code` | string | 状态码，"200"=成功 |
| `msg` | string | 响应信息 |
| `data` | array | 法条结果列表（直接是数组，非 data.result 嵌套结构） |
| `data[].xls` | string | 效力等级，如"刑法"、"地方政府规章" |
| `data[].lawId` | string | 法规唯一标识 ID |
| `data[].lawName` | string | 法规标题 |
| `data[].issuingOrgan` | string | 发文机关 |
| `data[].filenum` | string | 文号 |
| `data[].timeliness` | string | 时效性，如"现行有效"、"已失效"、"已修改"。注意是该法规在当前时间的时效性，不是校验时间 |
| `data[].content` | string | 命中条款的原文切片 |
| `data[].implementYearMonthDate` | string | 实施日期（yyyyMMdd 格式） |
| `data[].rawnumber` | string | 命中的条款号，如"第一百一十一条" |
### 响应示例
```json
{
  "code": "200",
  "msg": "查询成功",
  "data": [
    {
      "xls": "刑法",
      "lawId": "ABF317AE13C5B54A9946CD8A3B0DA513",
      "lawName": "中华人民共和国刑法（2023年修正）",
      "issuingOrgan": "全国人民代表大会",
      "filenum": "主席令第83号",
      "timeliness": "现行有效",
      "content": "\n    第一百一十一条  为境外的机构、组织、人员窃取、刺探、收买、非法提供国家秘密或者情报的...",
      "implementYearMonthDate": "20240301",
      "rawnumber": "第一百一十一条"
    }
  ]
}
```
### 备注说明
1. keyword 和 rawnumber 为必填参数，两者组合进行精准检索。
2. checkTime 是实现"时间点校验"的核心参数，用于判断法规在该日期是否正在实施。
3. 该接口不提供法规全文详情权限，仅返回条款级别的切片内容。
4. data 直接是数组，非 data.result 嵌套结构。
5. 接口需要登录认证，请求头需携带 Authorization Token。