Skip to main content

法规检索 API

检索法规,获取法规信息、引用信息和高亮内容

可按自然语言问题或关键词检索中国法律法规,涵盖法律、行政法规、司法解释及地方法规,并呈现法规元数据标签。用量按搜索意图计量。调用前请完成接入认证。

适用场景

  • 法条定位:按关键词或问题描述定位具体条文及其上下文。例如:「违约损失赔偿在《民法典》里是哪几条?」
  • 司法解释查询:检索司法解释与配套规定,确认适用口径。例如:「这条规定有没有对应的司法解释?」
  • 合规依据核查:核对某项要求对应的现行有效规定与地方性规定。例如:「数据出境安全评估现在依据的中央层级规定有哪些?」
  • 原文引用:获取条文原文与生效信息,用于文书与制度文件。例如:「把《劳动合同法》第三十九条原文调出来,要带施行日期。」
使用说明引用前请核对来源、效力和适用范围。

接入信息

使用下表中的完整请求地址发起调用。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-TypeJSON 请求体使用 application/json

curl 请求示例

将个人 API Key 原文保存到环境变量 FARUI_API_KEY。服务基础地址见服务地址。x-acs-date 在每次执行命令时重新生成。 简易的请求示例
FARUI_API_BASE_URL='https://farui.cn-beijing.aliyuncs.com'

curl --request POST \
  --url "${FARUI_API_BASE_URL%/}/open/v1/law/search" \
  --header "Authorization: ${FARUI_API_KEY}" \
  --header "x-acs-date: $(date -u '+%Y-%m-%dT%H:%M:%SZ')" \
  --header 'x-acs-version: 2026-10-19' \
  --header 'Content-Type: application/json' \
  --data '{
  "query": "劳动合同解除",
  "searchId": "law-search-001",
  "pageParam": {
    "pageNumber": 1,
    "pageSize": 10
  }
}'
复杂的请求示例(过滤字段是and关系)
FARUI_API_BASE_URL='https://farui.cn-beijing.aliyuncs.com'

curl --request POST \
  --url "${FARUI_API_BASE_URL%/}/open/v1/law/search" \
  --header "Authorization: ${FARUI_API_KEY}" \
  --header "x-acs-date: $(date -u '+%Y-%m-%dT%H:%M:%SZ')" \
  --header 'x-acs-version: 2026-10-19' \
  --header 'Content-Type: application/json' \
  --data '{
    "query": "刑法",
    "queryKeywords": [],
    "lawFilterAndStatisticTree": {
        "potencyLevel": [
            "法律"
        ],
        "timeliness": [
            "现行有效"
        ],
        "issuingOrgan": [
            "全国人民代表大会常务委员会"
        ],
        "releaseYear": "2014",
        "implementYear": "2014"
    },
    "pageParam": {
        "pageNumber": 1,
        "pageSize": 10
    }
}'

请求参数

以下字段填写在 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 即可使用默认分页。
{
  "query": "劳动合同解除",
  "searchId": "law-search-001",
  "pageParam": {
    "pageNumber": 1,
    "pageSize": 10
  }
}

可选检索条件

字段类型说明示例
queryKeywordsstring[]检索关键词列表["盗窃","抢劫"]
lawFilterAndStatisticTreeobject法规筛选与统计条件{"timeliness":["现行有效"]}
lawFilterAndStatisticTree
字段类型说明示例
potencyLevelstring[]效力级别["法律"]
timelinessstring[]时效性["现行有效"]
issuingOrganstring[]发文机关["最高人民法院"]
releaseYearstring发布年份"2020"
implementYearstring实施年份"2021"
使用说明高级筛选和排序字段请使用服务返回的筛选结构中的取值。

响应

外层响应包含 code、success 和 data;失败时还包含 message。先检查 HTTP 状态,再按下表判断业务结果。
结果判断方式与处理
检索成功success=true,检索结果在 data.records 中
无匹配结果success=true、data.records=[] 且 data.total=0,表示检索成功但未命中,不属于接入失败
业务失败success=false,查看 code 和 message;data 为空对象,不能仅根据 HTTP 状态判断业务成功

响应示例

以下为结构示例,记录内容为合成示例数据:
{
  "code": 200,
  "success": true,
  "data": {
    "records": [
      {
        "lawDomain": {
          "lawId": "law-civil-code",
          "lawName": "中华人民共和国民法典",
          "lawTitle": "第五百八十五条",
          "lawOrder": "第五百八十五条",
          "timeliness": "有效",
          "potencyLevel": "法律",
          "issuingOrgan": "全国人民代表大会",
          "releaseYearMonthDate": "2020-05-28",
          "segmentContent": "当事人可以约定违约金。"
        },
        "lawResultReferInfo": {
          "referTotalCount": "0",
          "referOtherLaws": []
        },
        "highLights": [
          {
            "field": "segmentContent",
            "content": "当事人可以约定违约金。"
          }
        ],
        "similarity": "0.92"
      }
    ],
    "total": 1,
    "pageNum": 1,
    "pageSize": 10,
    "currentCount": 1,
    "relatedKeywords": [],
    "queryKeywords": ["违约金"]
  }
}

响应字段

array
required
当前页法规列表,最多 50 条。
number
required
命中总条数。
number
required
本次响应的页码。
number
required
本次响应的每页条数。
number
当前可返回的记录数量。
string[]
相关关键词。
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 状态判定业务成功:
{
  "code": 400,
  "success": false,
  "message": "参数缺失,请检查参数后重试",
  "data": {}
}

翻页与重试

  • 建议从第一次请求起就在 JSON 正文中填写 searchId,以便在未收到响应时用同一标识重试。
  • 重试同一请求时沿用原标识和原参数。同一检索词翻页时可沿用原标识,新检索意图使用新标识。该标识用于关联检索意图,服务端仍可能重新检索。积分使用与用量核对见计费与用量。
  • 未提供标识时,服务端生成执行标识并通过 X-Farui-Execution-Id 返回。若响应丢失且没有原标识,重发可能被视为新检索并产生额外用量。

错误处理

先检查 HTTP 状态,再检查响应中的 success、code 和 message。认证、参数或业务错误的排查方法见错误与排障;重发前核对上方的翻页与重试说明。