检索法规,获取法规信息、引用信息和高亮内容
可按自然语言问题或关键词检索中国法律法规,涵盖法律、行政法规、司法解释及地方法规,并呈现法规元数据标签。用量按搜索意图计量。调用前请完成接入认证。
使用下表中的完整请求地址发起调用。API Key 的创建与管理见接入认证。
将个人 API Key 原文保存到环境变量
复杂的请求示例(过滤字段是and关系)
以下字段填写在 JSON 请求体中。
带分页的请求示例。只需传入
外层响应包含
以下为结构示例,记录内容为合成示例数据:
参数错误等失败响应使用
先检查 HTTP 状态,再检查响应中的
适用场景
- 法条定位:按关键词或问题描述定位具体条文及其上下文。例如:「违约损失赔偿在《民法典》里是哪几条?」
- 司法解释查询:检索司法解释与配套规定,确认适用口径。例如:「这条规定有没有对应的司法解释?」
- 合规依据核查:核对某项要求对应的现行有效规定与地方性规定。例如:「数据出境安全评估现在依据的中央层级规定有哪些?」
- 原文引用:获取条文原文与生效信息,用于文书与制度文件。例如:「把《劳动合同法》第三十九条原文调出来,要带施行日期。」
使用说明引用前请核对来源、效力和适用范围。
接入信息
使用下表中的完整请求地址发起调用。API Key 的创建与管理见接入认证。
| 配置项 | 配置值 |
|---|---|
| 服务名称 | 法规检索 API |
| 正式环境基础地址 | https://farui.cn-beijing.aliyuncs.com |
| 请求路径 | /open/v1/law/search |
| 正式环境请求地址(完整 URL) | https://farui.cn-beijing.aliyuncs.com/open/v1/law/search |
| 请求方法 | POST |
| 请求格式 | Content-Type: application/json |
| 认证方式 | Authorization 填写个人 API Key 原文,同时携带当前 x-acs-date,详见下方请求头 |
请求
请求头
| 请求头 | 填写说明 |
|---|---|
Authorization | 必填,填写 API Key 原文,省略 Bearer 前缀 |
x-acs-date | 必填,填写发起请求时的 UTC 时间,使用 ISO 8601 格式,精确到秒并以 Z 结尾,每次请求重新生成 |
x-acs-version | 必填,填写 2026-10-19 |
Content-Type | JSON 请求体使用 application/json |
curl 请求示例
将个人 API Key 原文保存到环境变量 FARUI_API_KEY。服务基础地址见服务地址。x-acs-date 在每次执行命令时重新生成。
简易的请求示例
请求参数
以下字段填写在 JSON 请求体中。
string
path
required
自然语言问题或检索关键词,不能为空白。
string
path
检索意图标识。长度为 1–128 个字符,可使用
A–Z、a–z、0–9、.、_、: 和 -。object
path
分页与排序参数。缺省时使用第 1 页、每页 10 条。
number
path
default:"1"
从 1 开始的页码。
number
path
default:"10"
每页条数,最大按 50 条处理。
query 即可使用默认分页。
可选检索条件
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
queryKeywords | string[] | 检索关键词列表 | ["盗窃","抢劫"] |
lawFilterAndStatisticTree | object | 法规筛选与统计条件 | {"timeliness":["现行有效"]} |
lawFilterAndStatisticTree
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
potencyLevel | string[] | 效力级别 | ["法律"] |
timeliness | string[] | 时效性 | ["现行有效"] |
issuingOrgan | string[] | 发文机关 | ["最高人民法院"] |
releaseYear | string | 发布年份 | "2020" |
implementYear | string | 实施年份 | "2021" |
使用说明高级筛选和排序字段请使用服务返回的筛选结构中的取值。
响应
外层响应包含 code、success 和 data;失败时还包含 message。先检查 HTTP 状态,再按下表判断业务结果。
| 结果 | 判断方式与处理 |
|---|---|
| 检索成功 | success=true,检索结果在 data.records 中 |
| 无匹配结果 | success=true、data.records=[] 且 data.total=0,表示检索成功但未命中,不属于接入失败 |
| 业务失败 | success=false,查看 code 和 message;data 为空对象,不能仅根据 HTTP 状态判断业务成功 |
响应示例
以下为结构示例,记录内容为合成示例数据:
响应字段
array
required
当前页法规列表,最多 50 条。
number
required
命中总条数。
number
required
本次响应的页码。
number
required
本次响应的每页条数。
number
当前可返回的记录数量。
相关关键词。
string[]
本次查询使用的关键词。
records 条目
object
法规领域信息,包含
lawId、lawName、lawTitle、lawOrder、timeliness、potencyLevel、issuingOrgan、releaseYearMonthDate 和 segmentContent 等字段。object
法规引用信息,包含引用总数和相关法规列表。
object[]
高亮片段,每项包含
field 和 content。string
相似度分数。
data 还可能包含 lawFilterAndStatisticTreeVo、groupingMethodVo、queryParam、roundId、lawName、lawOrder、searchType、searchMethod、question 和 timeliness,用于回传筛选、分组与查询上下文。
失败响应
参数错误等失败响应使用 success=false 和空 data 对象。调用方应先判断 success,不能仅根据 HTTP 状态判定业务成功:
翻页与重试
- 建议从第一次请求起就在 JSON 正文中填写
searchId,以便在未收到响应时用同一标识重试。 - 重试同一请求时沿用原标识和原参数。同一检索词翻页时可沿用原标识,新检索意图使用新标识。该标识用于关联检索意图,服务端仍可能重新检索。积分使用与用量核对见计费与用量。
- 未提供标识时,服务端生成执行标识并通过
X-Farui-Execution-Id返回。若响应丢失且没有原标识,重发可能被视为新检索并产生额外用量。
错误处理
先检查 HTTP 状态,再检查响应中的 success、code 和 message。认证、参数或业务错误的排查方法见错误与排障;重发前核对上方的翻页与重试说明。