API 接入

API 供程序、脚本或自动化工具调用全文搜索。有效的专业会员会优先使用 API / MCP 法条搜索月额度；没有专业会员或当期额度用完后，每次成功搜索消耗 1 点。无需订阅会员也可以使用点数调用。

API 与 MCP 共用同一份专业会员法条搜索额度。额度按订阅月刷新，并非每个自然月 1 日刷新；具体上限、已用量和下次刷新日期可在 App 的订阅会员页面查看。

接入准备

调用地址

POST https://api.flfgsc.cn/v1/search
GET  https://api.flfgsc.cn/v1/user/points

鉴权方式

在请求头中加入您的 API 密钥：

Authorization: Bearer flfgsc_xxxxxxxxxxxxxxxxx
Content-Type: application/json

API 密钥可在 App 内复制。重置密钥后，旧密钥会立即失效，已接入的工具需要同步更新。

搜索接口 `POST /v1/search`

关键词检索与语义检索混合。标题命中的法律本体排在法条结果之前，关键词法条不足时自动补充语义相关条文。

请求参数

调用示例

curl -X POST "https://api.flfgsc.cn/v1/search" \
  -H "Authorization: Bearer flfgsc_xxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "合同解除",
    "limit": 10,
    "category": "法律"
  }'

返回内容

{
  "results": [
    {
      "law": "中华人民共和国民法典（2020年）",
      "category": "法律",
      "url": "https://flfgsc.cn/law/minfadian"
    },
    {
      "law": "中华人民共和国民法典（2020年）",
      "category": "法律",
      "clause": "第五百六十二条　当事人协商一致，可以解除合同。当事人可以约定一方解除合同的事由。解除合同的事由发生时，解除权人可以解除合同。",
      "url": "https://flfgsc.cn/law/minfadian/clause_xxx"
    }
  ],
  "points": {
    "cost": 0,
    "balance": 123
  },
  "quota": {
    "api_search_monthly_used": 18,
    "api_search_monthly_limit": 500,
    "reset_at": "2026-08-07T00:00:00Z"
  }
}

各字段说明（搜索完整成功后才会消耗额度或点数）：

法律本体结果不返回 clause；法条结果会返回 clause。两类结果都在同一个 results 数组内，共用 limit 指定的结果总数。

没有有效专业会员法条搜索权益时不返回 quota。专业会员额度已用完、改为消耗点数时仍会返回 quota，此时已用量等于上限。

点数与额度查询 `GET /v1/user/points`

余额查询不会消耗额度或点数，返回当前点数余额；有效专业会员还会同时返回法条搜索额度快照：

curl "https://api.flfgsc.cn/v1/user/points" \
  -H "Authorization: Bearer flfgsc_xxxxxxxxxxxxxxxxx"

返回示例：

{
  "points": {
    "balance": 123
  },
  "quota": {
    "api_search_monthly_used": 18,
    "api_search_monthly_limit": 500,
    "reset_at": "2026-08-07T00:00:00Z"
  }
}

没有有效专业会员法条搜索权益时，响应中不包含 quota。

常见错误

错误响应会同时返回机器可读的 code 和用户可读的 message，需要给出修正建议时会带 hint：

{
  "code": "INSUFFICIENT_POINTS",
  "message": "点数不足"
}

{
  "code": "INVALID_CATEGORY",
  "message": "搜索范围不支持",
  "hint": "category=xxx；只接受：全部、法律、行政法规、司法解释、部门规章、国家监察委员会、中共中央"
}

请妥善保管 API 密钥，不要放在公开仓库、网页前端代码或截图中。