# 元典开放平台 AI/Agent 完整文档 > 这是给 LLM、AI Agent、MCP 客户端和自动化测试工具读取的 Markdown 版站点文档。目标是让工具通过静态 Markdown 和 JSON API 理解平台能力，而不是通过 Playwright 操作浏览器页面。 Generated: 2026-05-19T02:52:06.113Z Canonical site: https://open.chineselaw.com API JSON origin: https://apiplatform.legalmind.cn MCP origin used in examples: https://open.chineselaw.com Current catalog size: 35 ## High-Level Purpose 元典开放平台面向法律业务和开发者场景，提供可通过 API Key 调用的法律法规检索、案例文书检索、企业信息查询、法律文本幻觉检测等能力。平台也把部分接口注册为 MCP Streamable HTTP 工具，方便 Codex、Claude、Cursor、Apifox 等 Agent/客户端直接调用。 ## Agent Reading Order 1. Fetch `https://open.chineselaw.com/llms.txt` for the short index. 2. Fetch `https://open.chineselaw.com/llms-full.txt` for this complete Markdown context. 3. Fetch `https://apiplatform.legalmind.cn/api/apis?pageNum=1&pageSize=200&sortBy=latest` for the live catalog. 4. Fetch `https://apiplatform.legalmind.cn/api/apis/{id}` for a specific API. The important fields are `name`, `categoryName`, `routeKey`, `httpMethod`, `requestParams`, `responseParams`, `requestExample`, `responseExample`, and `fullDocument`. 5. Call business endpoints through `https://open.chineselaw.com/open/{routeKey}` with `X-API-Key`. ## Authentication And Calling Rules ### Direct OpenAPI Calls - URL shape: `https://open.chineselaw.com/open/{routeKey}` - API Key header: `X-API-Key: YOUR_API_KEY` - JSON calls should send `Content-Type: application/json; charset=utf-8` and `Accept: application/json`. - GET interfaces put arguments in query string. POST interfaces put arguments in JSON body. - A response with HTTP 200 can still carry a business code such as `401`; inspect the JSON body. ### MCP Streamable HTTP Calls - MCP transport: Streamable HTTP. - Client header: `Authorization: Bearer YOUR_API_KEY`. - JSON-RPC POST Accept header: `Accept: application/json, text/event-stream`, including initialize. - GET SSE listener requests should include `Accept: text/event-stream`. - The backend forwards the bearer credential to the open API as `X-API-Key`. - Category servers are listed below. The compatibility server `/mcp` may expose all tools when enabled. - If `https://open.chineselaw.com/mcp/health` returns HTML instead of JSON, the public reverse proxy is serving the frontend only; use the deployed backend MCP origin or local `http://localhost:8083`. ```json { "mcpServers": { "yuandian-law": { "url": "https://open.chineselaw.com/mcp/law/stream", "headers": { "Accept": "application/json, text/event-stream", "Authorization": "Bearer YOUR_API_KEY" } }, "yuandian-case": { "url": "https://open.chineselaw.com/mcp/case/stream", "headers": { "Accept": "application/json, text/event-stream", "Authorization": "Bearer YOUR_API_KEY" } }, "yuandian-company": { "url": "https://open.chineselaw.com/mcp/company/stream", "headers": { "Accept": "application/json, text/event-stream", "Authorization": "Bearer YOUR_API_KEY" } } } } ``` ## MCP Servers | Server | Category | Streamable HTTP URL | | --- | --- | --- | | yuandian-law | 法律法规 | https://open.chineselaw.com/mcp/law/stream | | yuandian-case | 案例文书 | https://open.chineselaw.com/mcp/case/stream | | yuandian-company | 企业信息 | https://open.chineselaw.com/mcp/company/stream | | yuandian-open-platform | 兼容入口/全部能力 | https://open.chineselaw.com/mcp | ## JSON Discovery Endpoints - Categories: `https://apiplatform.legalmind.cn/api/categories` - API catalog: `https://apiplatform.legalmind.cn/api/apis?pageNum=1&pageSize=200&sortBy=latest` - API detail: `https://apiplatform.legalmind.cn/api/apis/{id}` - Frontend docs page: `https://open.chineselaw.com/docs` - Frontend MCP page: `https://open.chineselaw.com/mcp-config` - Frontend API square: `https://open.chineselaw.com/api-square` ## Categories - 法律法规: id=7; sortWeight=6; catalog=https://apiplatform.legalmind.cn/api/apis?categoryId=7&pageNum=1&pageSize=200&sortBy=latest - 案例文书: id=6; sortWeight=7; catalog=https://apiplatform.legalmind.cn/api/apis?categoryId=6&pageNum=1&pageSize=200&sortBy=latest - 企业信息: id=9; sortWeight=8; catalog=https://apiplatform.legalmind.cn/api/apis?categoryId=9&pageNum=1&pageSize=200&sortBy=latest - 幻觉检测: id=10; sortWeight=10; catalog=https://apiplatform.legalmind.cn/api/apis?categoryId=10&pageNum=1&pageSize=200&sortBy=latest ## Current API Catalog ### 幻觉检测 - [法律幻觉校验接口](https://apiplatform.legalmind.cn/api/apis/42): category=幻觉检测; id=42; routeKey=hall_detect; method=POST; tool=yuandian_hall_detect; endpoint=https://open.chineselaw.com/open/hall_detect; 自动校验文本内容中的法律引用是否正确，系统自动抽取文中引用的法规/法条和案号，与智库比对语义一致性，核验法规时效性，输出"一致/不一致/未命中"判定及权威原文。 可以用来复核、校验、核查法律引用准确性，校验AI帮助撰写包含法律引用的法律文书是否存在幻觉 ### 企业信息 - [企业聚合总览接口](https://apiplatform.legalmind.cn/api/apis/41): category=企业信息; id=41; routeKey=rh_enterpriseAggregationSummary; method=GET; tool=yuandian_rh_enterpriseAggregationSummary; endpoint=https://open.chineselaw.com/open/rh_enterpriseAggregationSummary; 根据企业ID或统一社会信用代码聚合企业总览（对外投资、商标、专利、软件著作权、作品著作权、网站备案、变更记录、失信被执行人、被执行人、开庭公告、法院公告、股权冻结、行政处罚、股权出质、对外担保、经营异常、欠税公告、严重违法），对于非年度统计取结果top 20 - [企业检索接口](https://apiplatform.legalmind.cn/api/apis/19): category=企业信息; id=19; routeKey=rh_enterpriseSearch; method=GET; tool=yuandian_rh_enterpriseSearch; endpoint=https://open.chineselaw.com/open/rh_enterpriseSearch; 根据关键词检索企业名称返回企业候选列表，精准命中优先。 - [企业基本信息接口](https://apiplatform.legalmind.cn/api/apis/40): category=企业信息; id=40; routeKey=rh_enterpriseBaseInfo; method=GET; tool=yuandian_rh_enterpriseBaseInfo; endpoint=https://open.chineselaw.com/open/rh_enterpriseBaseInfo; 根据企业ID或统一社会信用代码查询企业扁平详情（基本信息+股东+十大股东+十大流通股东+核心成员+分支机构）。 - [企业对外投资信息列表接口](https://apiplatform.legalmind.cn/api/apis/39): category=企业信息; id=39; routeKey=rh_enterpriseOutInvest; method=GET; tool=yuandian_rh_enterpriseOutInvest; endpoint=https://open.chineselaw.com/open/rh_enterpriseOutInvest; 根据企业ID或统一社会信用代码查询企业对外投资信息列表，分页查询，每页默认30条。 - [企业商标信息列表接口](https://apiplatform.legalmind.cn/api/apis/38): category=企业信息; id=38; routeKey=rh_enterpriseBrand; method=GET; tool=yuandian_rh_enterpriseBrand; endpoint=https://open.chineselaw.com/open/rh_enterpriseBrand; 根据企业ID或统一社会信用代码查询企业商标信息列表，分页查询，每页默认30条。 - [企业专利信息列表接口](https://apiplatform.legalmind.cn/api/apis/37): category=企业信息; id=37; routeKey=rh_enterprisePatent; method=GET; tool=yuandian_rh_enterprisePatent; endpoint=https://open.chineselaw.com/open/rh_enterprisePatent; 根据企业ID或统一社会信用代码查询企业专利信息列表，分页查询，每页默认30条。 - [企业软件著作权信息列表接口](https://apiplatform.legalmind.cn/api/apis/36): category=企业信息; id=36; routeKey=rh_enterpriseSoftRight; method=GET; tool=yuandian_rh_enterpriseSoftRight; endpoint=https://open.chineselaw.com/open/rh_enterpriseSoftRight; 根据企业ID或统一社会信用代码查询企业软件著作权信息列表，分页查询，每页默认30条。 - [企业作品著作权信息列表接口](https://apiplatform.legalmind.cn/api/apis/35): category=企业信息; id=35; routeKey=rh_enterpriseWorksRight; method=GET; tool=yuandian_rh_enterpriseWorksRight; endpoint=https://open.chineselaw.com/open/rh_enterpriseWorksRight; 根据企业ID或统一社会信用代码查询企业作品著作权信息列表，分页查询，每页默认30条。 - [企业网站备案信息列表接口](https://apiplatform.legalmind.cn/api/apis/34): category=企业信息; id=34; routeKey=rh_enterpriseIcp; method=GET; tool=yuandian_rh_enterpriseIcp; endpoint=https://open.chineselaw.com/open/rh_enterpriseIcp; 根据企业ID或统一社会信用代码查询企业网站备案信息列表，分页查询，每页默认30条。 - [企业变更记录信息列表接口](https://apiplatform.legalmind.cn/api/apis/33): category=企业信息; id=33; routeKey=rh_enterpriseChangeInfo; method=GET; tool=yuandian_rh_enterpriseChangeInfo; endpoint=https://open.chineselaw.com/open/rh_enterpriseChangeInfo; 根据企业ID或统一社会信用代码查询企业变更记录列表，分页查询，每页默认30条。 - [企业涉诉信息统计接口](https://apiplatform.legalmind.cn/api/apis/32): category=企业信息; id=32; routeKey=rh_enterpriseWritAgg; method=GET; tool=yuandian_rh_enterpriseWritAgg; endpoint=https://open.chineselaw.com/open/rh_enterpriseWritAgg; 根据企业ID或统一社会信用代码针对企业涉诉信息，统计不同维度的分布情况（案件类别、案由、文书种类、审判程序、法院层级、结案方式、结案年份、地域、诉讼身份、对手当事人身份） - [企业涉诉文书列表接口](https://apiplatform.legalmind.cn/api/apis/31): category=企业信息; id=31; routeKey=rh_enterpriseWritList; method=GET; tool=yuandian_rh_enterpriseWritList; endpoint=https://open.chineselaw.com/open/rh_enterpriseWritList; 根据企业ID或统一社会信用代码查询企业企业涉诉文书列表，分页查询，每页默认30条。 - [企业开庭公告列表接口](https://apiplatform.legalmind.cn/api/apis/30): category=企业信息; id=30; routeKey=rh_enterpriseCourtSessionNotice; method=GET; tool=yuandian_rh_enterpriseCourtSessionNotice; endpoint=https://open.chineselaw.com/open/rh_enterpriseCourtSessionNotice; 根据企业ID或统一社会信用代码查询企业开庭公告列表，分页查询，每页默认30条。 - [企业法院公告列表接口](https://apiplatform.legalmind.cn/api/apis/29): category=企业信息; id=29; routeKey=rh_enterpriseCourtNotice; method=GET; tool=yuandian_rh_enterpriseCourtNotice; endpoint=https://open.chineselaw.com/open/rh_enterpriseCourtNotice; 根据企业ID或统一社会信用代码查询企业法院公告列表，分页查询，每页默认30条。 - [企业失信被执行人信息列表接口](https://apiplatform.legalmind.cn/api/apis/28): category=企业信息; id=28; routeKey=rh_enterpriseExecutions; method=GET; tool=yuandian_rh_enterpriseExecutions; endpoint=https://open.chineselaw.com/open/rh_enterpriseExecutions; 根据企业ID或统一社会信用代码查询企业失信被执行人列表，分页查询，每页默认30条。 - [企业被执行人信息列表接口](https://apiplatform.legalmind.cn/api/apis/27): category=企业信息; id=27; routeKey=rh_enterpriseExecutedPerson; method=GET; tool=yuandian_rh_enterpriseExecutedPerson; endpoint=https://open.chineselaw.com/open/rh_enterpriseExecutedPerson; 根据企业ID或统一社会信用代码查询企业被执行人列表，分页查询，每页默认30条。 - [企业股权冻结信息列表接口](https://apiplatform.legalmind.cn/api/apis/26): category=企业信息; id=26; routeKey=rh_enterpriseFrozenEquity; method=GET; tool=yuandian_rh_enterpriseFrozenEquity; endpoint=https://open.chineselaw.com/open/rh_enterpriseFrozenEquity; 根据企业ID或统一社会信用代码查询企业股权冻结列表，分页查询，每页默认30条。 - [企业行政处罚信息列表接口](https://apiplatform.legalmind.cn/api/apis/25): category=企业信息; id=25; routeKey=rh_enterprisePunishment; method=GET; tool=yuandian_rh_enterprisePunishment; endpoint=https://open.chineselaw.com/open/rh_enterprisePunishment; 根据企业ID或统一社会信用代码查询企业行政处罚列表，分页查询，每页默认30条。 - [企业股权出质信息列表接口](https://apiplatform.legalmind.cn/api/apis/24): category=企业信息; id=24; routeKey=rh_enterprisePledge; method=GET; tool=yuandian_rh_enterprisePledge; endpoint=https://open.chineselaw.com/open/rh_enterprisePledge; 根据企业ID或统一社会信用代码查询企业股权出质列表，分页查询，每页默认30条。 - [企业对外担保信息列表接口](https://apiplatform.legalmind.cn/api/apis/23): category=企业信息; id=23; routeKey=rh_enterpriseGuaranty; method=GET; tool=yuandian_rh_enterpriseGuaranty; endpoint=https://open.chineselaw.com/open/rh_enterpriseGuaranty; 根据企业ID或统一社会信用代码查询企业对外担保列表，分页查询，每页默认30条。 - [企业经营异常记录列表接口](https://apiplatform.legalmind.cn/api/apis/22): category=企业信息; id=22; routeKey=rh_enterpriseAbnormalOperation; method=GET; tool=yuandian_rh_enterpriseAbnormalOperation; endpoint=https://open.chineselaw.com/open/rh_enterpriseAbnormalOperation; 根据企业ID或统一社会信用代码查询企业经营异常列表，分页查询，每页默认30条。 - [企业欠税公告记录列表接口](https://apiplatform.legalmind.cn/api/apis/21): category=企业信息; id=21; routeKey=rh_enterpriseCorporateTax; method=GET; tool=yuandian_rh_enterpriseCorporateTax; endpoint=https://open.chineselaw.com/open/rh_enterpriseCorporateTax; 根据企业ID或统一社会信用代码查询企业欠税公告列表，分页查询，每页默认30条。 - [企业严重违法记录列表接口](https://apiplatform.legalmind.cn/api/apis/20): category=企业信息; id=20; routeKey=rh_enterpriseSeriousIllegal; method=GET; tool=yuandian_rh_enterpriseSeriousIllegal; endpoint=https://open.chineselaw.com/open/rh_enterpriseSeriousIllegal; 根据企业ID或统一社会信用代码查询企业严重违法列表 - [根据企业 id、统一社会信用代码获取企业详情](https://apiplatform.legalmind.cn/api/apis/15): category=企业信息; id=15; routeKey=rh_company_detail; method=GET; tool=yuandian_rh_company_detail; endpoint=https://open.chineselaw.com/open/rh_company_detail; 在企业库中定位一家企业，并返回该企业的工商登记、成员、分支机构、变更与对外投资、知识产权、涉诉摘要、风险标签等聚合详情。 - [根据企业名称或股票简称查询企业详情](https://apiplatform.legalmind.cn/api/apis/14): category=企业信息; id=14; routeKey=rh_company_info; method=GET; tool=yuandian_rh_company_info; endpoint=https://open.chineselaw.com/open/rh_company_info; 按名称（含全称、曾用名、股票简称等组合检索策略）查询企业，返回最多 `num` 条企业的详情：工商信息、股东/分支、变更与对外投资、知识产权、涉诉、风险等。 ### 法律法规 - [法律法规语义检索接口](https://apiplatform.legalmind.cn/api/apis/17): category=法律法规; id=17; routeKey=law_vector_search; method=POST; tool=yuandian_law_vector_search; endpoint=https://open.chineselaw.com/open/law_vector_search; 对法律法规进行语义检索，支持传入各类筛选项，返回语义相关的法律法规列表。 - [法条详情接口](https://apiplatform.legalmind.cn/api/apis/13): category=法律法规; id=13; routeKey=rh_ft_detail; method=POST; tool=yuandian_rh_ft_detail; endpoint=https://open.chineselaw.com/open/rh_ft_detail; 获取法条的详情信息。 - [法规详情接口](https://apiplatform.legalmind.cn/api/apis/12): category=法律法规; id=12; routeKey=rh_fg_detail; method=POST; tool=yuandian_rh_fg_detail; endpoint=https://open.chineselaw.com/open/rh_fg_detail; 获取法规的详情信息。 - [法条关键词检索接口](https://apiplatform.legalmind.cn/api/apis/11): category=法律法规; id=11; routeKey=rh_ft_search; method=POST; tool=yuandian_rh_ft_search; endpoint=https://open.chineselaw.com/open/rh_ft_search; 根据关键词检索法条内容，并可按法规名称、效力级别、时效性、发布日期/实施日期范围等条件过滤；返回法条列表并补充所属法规的关键信息。 - [法规关键词检索接口](https://apiplatform.legalmind.cn/api/apis/10): category=法律法规; id=10; routeKey=rh_fg_search; method=POST; tool=yuandian_rh_fg_search; endpoint=https://open.chineselaw.com/open/rh_fg_search; 对法规（法规概要/大纲）进行关键词检索与条件过滤，返回法规列表；当传入 `keyword` 时，会返回命中内容的高亮片段（若可获取）。 ### 案例文书 - [案例语义检索接口](https://apiplatform.legalmind.cn/api/apis/16): category=案例文书; id=16; routeKey=case_vector_search; method=POST; tool=yuandian_case_vector_search; endpoint=https://open.chineselaw.com/open/case_vector_search; 对普通案例和权威案例进行语义检索，支持传入各类筛选项，返回语义相关的案例列表。 - [案例详情接口](https://apiplatform.legalmind.cn/api/apis/9): category=案例文书; id=9; routeKey=rh_case_details; method=GET; tool=yuandian_rh_case_details; endpoint=https://open.chineselaw.com/open/rh_case_details; 按类型 `type` 获取“普通案例(ptal)”或“权威案例(qwal)”的详情信息；支持按 `id` 或 `ah` 查询。 - [权威案例关键词检索接口](https://apiplatform.legalmind.cn/api/apis/8): category=案例文书; id=8; routeKey=rh_qwal_search; method=POST; tool=yuandian_rh_qwal_search; endpoint=https://open.chineselaw.com/open/rh_qwal_search; 对“权威案例”库进行多条件/关键词检索，返回命中的案例列表（优先返回要旨/摘要）与命中总数。 - [普通案例关键词检索接口](https://apiplatform.legalmind.cn/api/apis/7): category=案例文书; id=7; routeKey=rh_ptal_search; method=POST; tool=yuandian_rh_ptal_search; endpoint=https://open.chineselaw.com/open/rh_ptal_search; 对“普通案例”库进行多条件/关键词检索，返回命中的案例列表（含内容片段/摘要）与命中总数。 ## API Details ## 法律幻觉校验接口 - Category: 幻觉检测 - ID: 42 - routeKey: `hall_detect` - HTTP method: `POST` - Direct endpoint: `https://open.chineselaw.com/open/hall_detect` - Detail JSON: `https://apiplatform.legalmind.cn/api/apis/42` - MCP tool: `yuandian_hall_detect` - MCP server: `yuandian-open-platform` at `https://open.chineselaw.com/mcp` - Price: 50 POINT/call; chargeType=1 Description: 自动校验文本内容中的法律引用是否正确，系统自动抽取文中引用的法规/法条和案号，与智库比对语义一致性，核验法规时效性，输出"一致/不一致/未命中"判定及权威原文。 可以用来复核、校验、核查法律引用准确性，校验AI帮助撰写包含法律引用的法律文书是否存在幻觉 ### Direct API Authentication ```http X-API-Key: YOUR_API_KEY Accept: application/json Content-Type: application/json; charset=utf-8 ``` ### MCP Authentication ```http Accept: application/json, text/event-stream Authorization: Bearer YOUR_API_KEY ``` ### Full Document # 法律幻觉校验接口文档 ## 1. 基本信息 - **接口名称**：法律幻觉校验接口 - **接口用途**：自动校验文本内容中的法律引用是否正确，系统自动抽取文中引用的法规/法条和案号，与智库比对语义一致性，核验法规时效性，输出"一致/不一致/未命中"判定及权威原文。 可以用来复核、校验、核查法律引用准确性，校验AI帮助撰写包含法律引用的法律文书是否存在幻觉。 ## 2. 请求信息 - **HTTP Method**：POST - **URL**：`https://open.chineselaw.com/open/hall_detect` - **Content-Type**：`application/json; charset=utf-8` - **Accept**：`application/json` - **X-API-Key：**`你的api_key` ## 3. 请求参数（Body） | 字段名 | 类型 | 是否必填 | 说明 | | ------ | ------ | -------: | ---- | | `text` | string | 是 | 待抽取的用户原文文本 | ### 3.1 校验与默认值（按代码） - **缺少 `text` / 类型不对**：返回 422（请求参数校验失败，见“5. 错误返回”） - `text` 不做最小长度校验（但为空字符串会导致抽取结果通常为空） ## 4. 返回信息 - **返回类型**：JSON ### 4.1 成功响应结构（`200`） | 字段名 | 类型 | 说明 | | --- | --- | --- | | `regulations` | array | 抽取到的法规/法条列表 | | `cases` | array | 抽取到的案例列表 | | `highlighted_text` | string | 高亮后的原文（HTML 字符串，已转义，包含 `` 标记） | | `semantic_compare_error` | string \| absent | 语义比对流程异常时可能出现（不一定有） | | `chat_model` | string | 本次调用使用的模型名（从服务端配置回填） | | `request_id` | string | 本次请求 ID（与响应头 `X-Request-ID` 一致） | ## 5. 错误返回（统一异常结构） > 发生校验失败、业务抛错或未处理异常时，接口会返回下述结构（并带 `request_id`；响应头同样会返回 `X-Request-ID`）。 | 字段名 | 类型 | 说明 | | --- | --- | --- | | `success` | boolean | 固定为 `false` | | `error_code` | string | 错误码，如 `VALIDATION_ERROR`、`HTTP_502`、`INTERNAL_ERROR` | | `message` | string | 错误信息 | | `request_id` | string | 请求 ID | | `detail` | any \| absent | 可能存在：校验错误详情、或非字符串的异常详情 | 常见 HTTP 状态码： - **422**：请求参数校验失败（如缺少 `text`） - **502**：上游（外部 Chat/权威来源）调用失败或响应不可解析（以 `HTTP_502` 形式返回） - **500**：服务内部异常（`INTERNAL_ERROR`） ## 6. 返回字段说明 ### 6.1 `regulations[]`（法规/法条对象） > 抽取阶段会给每条法规生成稳定的 `extract_reg_id`；若能命中“权威来源”详情，会补充 `url`、元数据、以及 `think_tank_content`。 > 若仅有法规名、没有具体条号，会标记 `source_no_specific_clause=true`，并跳过语义比对（`semantic_compare.skipped=true`）。 | 字段名 | 类型 | 说明 | | --- | --- | --- | | `name` | string | 法规名称（可能带《》） | | `clause` | string | 法条号（如“第一百条”；可能为空串表示仅法规名） | | `content` | string | 从“用户原文”中逐字摘录的依据片段（模型抽取） | | `extract_reg_id` | string | 服务端生成的 UUID，用于前端对齐与批量语义比对 key | | `url` | string | 命中权威来源时返回的详情页 URL（可为空串） | | `think_tank_content` | string | 命中权威来源时的条文正文（可能为空串） | | `source_no_specific_clause` | boolean | 仅法规名、无具体条号时为 `true` | | `law_exists` | boolean | 仅法规名存在性检索时，法规存在/不存在（可能缺省） | | `think_tank_clause_missing` | boolean | 有条号但权威来源缺失该条时可能为 `true`（可能缺省） | | `publish_date` | string | 统一后的“发布日期”（可能为空串） | | `implement_date` | string | 统一后的“实施日期”（可能为空串） | | `validity_status` | string | 统一后的“时效性/是否有效”（可能为空串） | | `document_number` | string | 统一后的“发文字号”（可能为空串） | | `semantic_compare` | object | “原文摘录(content)” vs “权威来源正文(think_tank_content)”的语义比对结果 | #### 6.1.1 `semantic_compare`（法规语义比对对象） | 字段名 | 类型 | 说明 | | --- | --- | --- | | `结论` | string | 比对结论；无可比文本时通常为“无法判断” | | `语义相似度` | number \| null | 相似度（可能为空） | | `说明` | string | 说明文字 | | `要点` | array | 关键信息点（可能为空数组） | | `skipped` | boolean | 仅法规名无条号时为 `true`（可能缺省） | | `skip_reason` | string | 跳过原因（如 `NO_CLAUSE`，可能缺省） | | `skip_message` | string | 跳过提示（可能缺省） | ### 6.2 `cases[]`（案例对象） > 命中权威来源时，会补充 `url`、`think_tank_content`，并补齐列表展示字段（英文键 + 中文别名键并存）。 | 字段名 | 类型 | 说明 | | --- | --- | --- | | `name` | string | 案例名称（可能为空串） | | `case_number` | string | 案号（服务端会做括号/空白归一化；命中权威来源时可能回填为“官方案号”） | | `content` | string | 从“用户原文”中逐字摘录的依据片段（模型抽取） | | `url` | string | 命中权威来源时返回的案例详情页 URL（可为空串） | | `think_tank_content` | string | 命中权威来源时的“内容：”正文摘录（可为空串） | | `case_type` | string | 案例类型（可为空串） | | `court` | string | 法院（可为空串） | | `judgment_date` | string | 日期（可为空串） | | `basic_facts` | string | 基本案情（可为空串） | | `judgment_key_points` | string | 裁判要点（可为空串） | | `judgment_result` | string | 裁判结果（可为空串） | | `judgment_analysis` | string | 裁判分析过程（可为空串） | | `typical_significance` | string | 典型意义（可为空串） | | `case_commentary` | string | 案例评析（可为空串） | | `案例类型`/`法院`/`日期`/... | string | 以上字段的中文别名（值与英文键一致） | | `案号` | string | `case_number` 的中文别名（值与 `case_number` 对齐） | ### 6.3 `highlighted_text` - **类型**：string（HTML 字符串） - **说明**：对原文进行转义后，在命中的法规/案号等片段外包裹 ``，用于前端着色与悬浮提示。 - 可能包含的 class（示例）：`hl-statute-link`、`hl-case-ref`、`missing-ref`、`case-hit` 等 - 注意：这不是纯文本；如需纯文本请使用原始入参 `text` ## 7. 示例 ### 7.1 请求示例 ```json { "text": "根据《中华人民共和国民法典》第一百二十二条……另参照（2019）苏0206民初3374号的裁判观点……" } ``` ### 7.2 成功响应示例（示意） ```json { "regulations": [ { "name": "《中华人民共和国民法典》", "clause": "第一百二十二条", "content": "……（此处为从用户原文逐字摘录的片段）", "extract_reg_id": "2d2fbb7a-8c3a-4d3c-9a9e-6f3fd1b7c2c1", "url": "https://example.com/xxx", "think_tank_content": "……（此处为权威来源条文正文）", "publish_date": "", "implement_date": "", "validity_status": "", "document_number": "", "semantic_compare": { "结论": "无法判断", "语义相似度": null, "说明": "缺少提取摘录或权威来源正文，无法建立可比关系", "要点": [] } } ], "cases": [ { "name": "", "case_number": "（2019）苏0206民初3374号", "content": "……（逐字摘录）", "url": "https://example.com/case", "think_tank_content": "……（权威来源内容摘录）", "case_type": "", "court": "", "judgment_date": "", "basic_facts": "", "judgment_key_points": "", "judgment_result": "", "judgment_analysis": "", "typical_significance": "", "case_commentary": "", "案例类型": "", "法院": "", "日期": "", "基本案情": "", "裁判要点": "", "裁判结果": "", "裁判分析过程": "", "典型意义": "", "案例评析": "", "案号": "（2019）苏0206民初3374号" } ], "highlighted_text": "……（HTML 字符串，包含 span 标注）", "chat_model": "YOUR_CHAT_MODEL", "request_id": "req_1714460000000_ab12cd34" } ``` ### 7.3 失败响应示例（缺少 text，422） ```json { "success": false, "error_code": "VALIDATION_ERROR", "message": "请求参数校验失败", "request_id": "req_1714460000000_ab12cd34", "detail": [ { "type": "missing", "loc": ["body", "text"], "msg": "Field required", "input": {} } ] } ``` ## 8. 代码示例 ### 8.1 CURL调用示例 ```shell curl --location --request POST 'https://open.chineselaw.com/open/hall_detect' \ --header 'Content-Type: application/json; charset=utf-8' \ --header 'Accept: application/json' \ --header 'X-Request-ID: 你自定义的request_id(可选)' \ --data-raw '{ "text": "根据《中华人民共和国民法典》第一百二十二条……另参照（2019）苏0206民初3374号的裁判观点……" }' ``` ### 8.2 JAVA调用示例 ```python import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.time.Duration; public class ExtractExample { public static void main(String[] args) throws Exception { String apiUrl = "https://open.chineselaw.com/open/hall_detect"; String url = apiUrl; String requestId = "你自定义的request_id(可选)"; String jsonBody = """ { "text": "根据《中华人民共和国民法典》第一百二十二条……另参照（2019）苏0206民初3374号的裁判观点……" } """; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create(url)) .timeout(Duration.ofSeconds(60)) .header("Content-Type", "application/json; charset=utf-8") .header("Accept", "application/json") .header("X-Request-ID", requestId) // 可不传：删掉这一行即可 .POST(HttpRequest.BodyPublishers.ofString(jsonBody)) .build(); HttpClient client = HttpClient.newHttpClient(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode()); System.out.println("X-Request-ID=" + response.headers().firstValue("X-Request-ID").orElse("")); System.out.println(response.body()); } } ``` ### 8.3 PYTHONE调用示例 ```java import requests url = "https://open.chineselaw.com/open/hall_detect/api/extract" headers = { "Content-Type": "application/json; charset=utf-8", "Accept": "application/json", "X-Request-ID": "你自定义的request_id(可选)", } payload = { "text": "根据《中华人民共和国民法典》第一百二十二条……另参照（2019）苏0206民初3374号的裁判观点……" } response = requests.post(url, json=payload, headers=headers, timeout=60) response.raise_for_status() print("X-Request-ID=", response.headers.get("X-Request-ID", "")) print(response.json()) ``` ### 8.3 JAVASCRIPT调用示例 ```javascript const API_URL = "https://open.chineselaw.com/open/hall_detect"; const res = await fetch(`${API_URL}/api/extract`, { method: "POST", headers: { "Content-Type": "application/json; charset=utf-8", "Accept": "application/json", "X-Request-ID": "你自定义的request_id(可选)", }, body: JSON.stringify({ text: "根据《中华人民共和国民法典》第一百二十二条……另参照（2019）苏0206民初3374号的裁判观点……", }), }); if (!res.ok) throw new Error(`HTTP ${res.status}`); console.log("X-Request-ID=", res.headers.get("X-Request-ID") || ""); console.log(await res.json()); ``` --- ## 企业聚合总览接口 - Category: 企业信息 - ID: 41 - routeKey: `rh_enterpriseAggregationSummary` - HTTP method: `GET` - Direct endpoint: `https://open.chineselaw.com/open/rh_enterpriseAggregationSummary` - Detail JSON: `https://apiplatform.legalmind.cn/api/apis/41` - MCP tool: `yuandian_rh_enterpriseAggregationSummary` - MCP server: `yuandian-company` at `https://open.chineselaw.com/mcp/company/stream` - Price: 10 POINT/call; chargeType=1 Description: 根据企业ID或统一社会信用代码聚合企业总览（对外投资、商标、专利、软件著作权、作品著作权、网站备案、变更记录、失信被执行人、被执行人、开庭公告、法院公告、股权冻结、行政处罚、股权出质、对外担保、经营异常、欠税公告、严重违法），对于非年度统计取结果top 20 ### Direct API Authentication ```http X-API-Key: YOUR_API_KEY Accept: application/json ``` ### MCP Authentication ```http Accept: application/json, text/event-stream Authorization: Bearer YOUR_API_KEY ``` ### Full Document # 企业聚合总览接口 ## 1. 基本信息 - **接口名称**：企业聚合总览 - **接口用途**：根据企业ID或统一社会信用代码聚合企业总览（对外投资、商标、专利、软件著作权、作品著作权、网站备案、变更记录、失信被执行人、被执行人、开庭公告、法院公告、股权冻结、行政处罚、股权出质、对外担保、经营异常、欠税公告、严重违法），对于非年度统计取结果top 20 ## 2. 请求信息 - **HTTP Method**：GET - **URL**：`https://open.chineselaw.com/open/rh_enterpriseAggregationSummary` ## 3. 请求参数（Query） | 参数名 | 类型 | 是否必填 | 说明 | | ---------- | ------ | -------- | ---------------- | | `id` | string | 否 | 企业ID | | `tyshxydm` | string | 否 | 统一社会信用代码 | > `id` 与 `tyshxydm` 不能同时为空。 ## 4. 请求示例 ```Plain GET https://open.chineselaw.com/open/rh_enterpriseAggregationSummary?id=a80a4cc8-9954-4dd3-bcaf-aebb99487b14 ``` ## 5. 响应说明 ### **5.1 通用返回结构** | 字段名 | 类型 | 说明 | | --------- | ------ | ------------------------- | | `status` | string | `success` / `notFound` 等 | | `code` | number | 成功 200 | | `message` | string | 提示信息 | | `data` | object | 数据结果 | ### 5.2 **`data`** **对象说明（概要）** | 字段名 | 类型 | 说明 | | ------------------ | ------ | -------------------- | | `id` | string | 企业ID | | `name` | string | 企业名称 | | `对外投资统计` | object | 对外投资信息聚合 | | `商标统计` | object | 商标信息聚合 | | `专利统计` | object | 专利信息聚合 | | `软件著作权统计` | object | 软件著作权信息聚合 | | `变更记录统计` | object | 变更记录信息聚合 | | `作品著作权统计` | object | 作品著作权信息聚合 | | `网站备案统计` | object | 网站备案信息聚合 | | `失信被执行人统计` | object | 失信被执行人信息聚合 | | `被执行人统计` | object | 执行被执行人信息聚合 | | `开庭公告统计` | object | 开庭公告信息聚合 | | `法院公告统计` | object | 法法院公告信息聚合 | | `股权冻结统计` | object | 股权冻结信息聚合 | | `行政处罚统计` | object | 行政行政处罚信息聚合 | | `股权出质统计` | object | 股权出质信息聚合 | | `对外担保统计` | object | 对外担保信息聚合 | | `经营异常统计` | object | 经营异常信息聚合 | | `欠税公告统计` | object | 欠税公告信息聚合 | | `严重违法统计` | object | 严重违法信息聚合 | ## 6. 响应示例 ```JSON { "code": 200, "data": { "id": "a80a4cc8-9954-4dd3-bcaf-aebb99487b14", "name": "北京百度网讯科技有限公司", "对外投资统计": { "投资年份": [ { "key": "2021", "count": 9 }, { "key": "2014", "count": 8 }, { "key": "2010", "count": 7 }, { "key": "2012", "count": 7 }, { "key": "2015", "count": 7 }, { "key": "2016", "count": 6 }, { "key": "2020", "count": 6 }, { "key": "2011", "count": 5 }, { "key": "2022", "count": 5 }, { "key": "2013", "count": 4 }, { "key": "2017", "count": 4 }, { "key": "2019", "count": 4 }, { "key": "2023", "count": 4 }, { "key": "2025", "count": 4 }, { "key": "2002", "count": 2 }, { "key": "2004", "count": 2 }, { "key": "2007", "count": 2 }, { "key": "2008", "count": 2 }, { "key": "2009", "count": 2 }, { "key": "2018", "count": 2 }, { "key": "2024", "count": 2 }, { "key": "1994", "count": 1 }, { "key": "2000", "count": 1 }, { "key": "2003", "count": 1 }, { "key": "2006", "count": 1 } ], "投资经营状态": [ { "key": "存续（在营、开业、在册）", "count": 80 }, { "key": "注销", "count": 16 }, { "key": "在营（开业）企业", "count": 1 }, { "key": "责令关闭", "count": 1 } ], "总数": 98 }, "商标统计": { "类别": [ { "key": "通讯服务", "count": 1001 }, { "key": "设计研究", "count": 57 }, { "key": "科学仪器", "count": 43 }, { "key": "广告销售", "count": 42 }, { "key": "教育娱乐", "count": 32 }, { "key": "金融物管", "count": 15 }, { "key": "社会法律", "count": 11 }, { "key": "餐饮住宿", "count": 7 }, { "key": "家具", "count": 5 }, { "key": "皮革皮具", "count": 5 }, { "key": "厨房洁具", "count": 4 }, { "key": "布料床单", "count": 4 }, { "key": "运输贮藏", "count": 4 }, { "key": "办公品", "count": 3 }, { "key": "地毯席垫", "count": 3 }, { "key": "手工器械", "count": 3 }, { "key": "日化用品", "count": 3 }, { "key": "建筑修理", "count": 2 }, { "key": "方便食品", "count": 2 }, { "key": "服装鞋帽", "count": 2 } ], "流程状态": [ { "key": "注册", "count": 525 }, { "key": "已注册", "count": 215 }, { "key": "申请被驳回、不予受理等，该商标已失效", "count": 169 }, { "key": "注册商标", "count": 165 }, { "key": "注册公告", "count": 112 }, { "key": "注册申请中", "count": 39 }, { "key": "等待实质审查", "count": 15 }, { "key": "初审公告", "count": 6 }, { "key": "商标续展中", "count": 6 }, { "key": "注册商标被撤销", "count": 6 }, { "key": "", "count": 5 }, { "key": "注册商标被权利人注销", "count": 3 }, { "key": "撤销/无效宣告申请审查中", "count": 2 }, { "key": "驳回复审中", "count": 2 }, { "key": "0", "count": 1 }, { "key": "商标无效", "count": 1 }, { "key": "无效程序中", "count": 1 } ], "总数": 1273 }, "专利统计": { "申请公布年份": [], "总数": 23163 }, "软件著作权统计": { "批准年份": [ { "key": "2021", "count": 198 }, { "key": "2022", "count": 146 }, { "key": "2023", "count": 109 }, { "key": "2019", "count": 89 }, { "key": "2024", "count": 80 }, { "key": "2020", "count": 79 }, { "key": "2018", "count": 47 }, { "key": "2025", "count": 39 }, { "key": "2015", "count": 29 }, { "key": "2013", "count": 28 }, { "key": "2016", "count": 24 }, { "key": "2014", "count": 16 }, { "key": "2012", "count": 13 }, { "key": "2010", "count": 10 }, { "key": "2017", "count": 9 }, { "key": "2026", "count": 5 }, { "key": "2002", "count": 1 } ], "是否公开": { "公开": 10, "不公开": 912 }, "总数": 922 }, "作品著作权统计": { "类别": [ { "key": "摄影", "count": 315518 }, { "key": "文字", "count": 4491 }, { "key": "美术", "count": 306 }, { "key": "类似摄制电影方法创作的作品", "count": 15 }, { "key": "其他", "count": 9 } ], "总数": 320339 }, "网站备案统计": { "单位性质": [ { "key": "企业", "count": 306 } ], "总数": 306 }, "失信被执行人统计": { "省份": [], "执行法院": [], "行为具体情形": [], "履行情况": [], "总数": 0 }, "被执行人统计": { "立案年份": [], "执行状态": [], "执行法院": [], "总数": 0 }, "开庭公告统计": { "公告年份": [ { "key": "2022", "count": 158 }, { "key": "2023", "count": 147 }, { "key": "2025", "count": 108 }, { "key": "2019", "count": 107 }, { "key": "2020", "count": 106 }, { "key": "2024", "count": 106 }, { "key": "2021", "count": 93 }, { "key": "2018", "count": 41 }, { "key": "2017", "count": 26 }, { "key": "2015", "count": 22 }, { "key": "2014", "count": 12 }, { "key": "2016", "count": 8 }, { "key": "2026", "count": 5 }, { "key": "2006", "count": 2 }, { "key": "2007", "count": 1 }, { "key": "2009", "count": 1 } ], "案由": [ { "key": "侵害作品信息网络传播权纠纷", "count": 64 }, { "key": "侵害商标权纠纷", "count": 55 }, { "key": "不正当竞争纠纷", "count": 48 }, { "key": "名誉权纠纷", "count": 19 }, { "key": "网络侵权责任纠纷", "count": 19 }, { "key": "著作权权属、侵权纠纷", "count": 19 }, { "key": "审判长/主审人:", "count": 12 }, { "key": "案由:侵害商标权纠纷&承办部门:商事审判庭&审判长/主审人:薛广文", "count": 9 }, { "key": "河北新天第装饰工程有限公司诉北京百度网讯科技有限公司网络侵权责任纠纷", "count": 7 }, { "key": "网络服务合同纠纷", "count": 7 }, { "key": "侵害计算机软件著作权纠纷", "count": 6 }, { "key": "案由:侵害商标权纠纷&承办部门:商事审判庭&审判长/主审人:史雅丽", "count": 6 }, { "key": "案由:其他不正当竞争纠纷&承办部门:执行裁判庭&审判长/主审人:金立寅", "count": 6 }, { "key": "侵害外观设计专利权纠纷", "count": 5 }, { "key": "侵权责任纠纷", "count": 5 }, { "key": "原告:青岛薇薇新娘婚纱摄影有限公司;被告:双流区薇薇新娘婚纱摄影店,北京百度网讯科技有限公司", "count": 5 }, { "key": "案由:侵害商标权纠纷&承办部门:商事审判庭&审判长/主审人:谭映红", "count": 5 }, { "key": "案由:侵害商标权纠纷&承办部门:商事审判庭&审判长/主审人:郭海娜", "count": 5 }, { "key": "案由:侵害商标权纠纷&承办部门:民事审判庭&审判长/主审人:张晓莉", "count": 5 }, { "key": "案由:侵害商标权纠纷&承办部门:知识产权审判庭&审判长/主审人:林抒蔚", "count": 5 } ], "审理法院": [ { "key": "上海市浦东新区人民法院", "count": 94 }, { "key": "北京互联网法院", "count": 54 }, { "key": "重庆自由贸易试验区人民法院", "count": 43 }, { "key": "北京市第一中级人民法院", "count": 38 }, { "key": "上海市徐汇区人民法院", "count": 37 }, { "key": "北京市海淀区人民法院", "count": 30 }, { "key": "上海市嘉定区人民法院", "count": 29 }, { "key": "天津市和平区人民法院", "count": 28 }, { "key": "瑞安市人民法院", "count": 28 }, { "key": "上海市杨浦区人民法院", "count": 24 }, { "key": "上海市宝山区人民法院", "count": 23 }, { "key": "上海市闵行区人民法院", "count": 22 }, { "key": "北京知识产权法院", "count": 21 }, { "key": "上海市崇明区人民法院", "count": 20 }, { "key": "宁波市鄞州区人民法院", "count": 19 }, { "key": "上海知识产权法院", "count": 18 }, { "key": "上海市普陀区人民法院", "count": 17 }, { "key": "上海市松江区人民法院", "count": 15 }, { "key": "天津市第三中级人民法院", "count": 15 }, { "key": "杭州互联网法院", "count": 15 } ], "起诉方": 111, "应诉方": 1063, "总数": 1173 }, "法院公告统计": { "公告年份": [ { "key": "2020", "count": 46 }, { "key": "2021", "count": 39 }, { "key": "2019", "count": 31 }, { "key": "2018", "count": 20 }, { "key": "2022", "count": 19 }, { "key": "2023", "count": 15 }, { "key": "2017", "count": 8 }, { "key": "2024", "count": 5 } ], "公告类型": [ { "key": "起诉状副本及开庭传票", "count": 109 }, { "key": "裁判文书", "count": 59 }, { "key": "开庭传票", "count": 8 }, { "key": "其他", "count": 4 }, { "key": "送达公告", "count": 3 }, { "key": "起诉状、上诉状副本", "count": 2 }, { "key": "判决公告", "count": 1 }, { "key": "裁定公告", "count": 1 } ], "法院": [ { "key": "北京市海淀区人民法院", "count": 116 }, { "key": "北京知识产权法院", "count": 12 }, { "key": "北京互联网法院", "count": 6 }, { "key": "南京铁路运输法院", "count": 3 }, { "key": "重庆市第五中级人民法院", "count": 3 }, { "key": "重庆自由贸易试验区人民法院", "count": 3 }, { "key": "高邮市人民法院", "count": 3 }, { "key": "北京市朝阳区人民法院", "count": 2 }, { "key": "厦门市思明区人民法院", "count": 2 }, { "key": "江苏省盐城市中级人民法院", "count": 2 }, { "key": "福州市晋安区人民法院", "count": 2 }, { "key": "西安市长安区人民法院", "count": 2 }, { "key": "重庆市渝中区人民法院", "count": 2 }, { "key": "重庆市渝北区人民法院", "count": 2 }, { "key": "陕西省西安市中级人民法院", "count": 2 }, { "key": "三亚市城郊人民法院", "count": 1 }, { "key": "上海市浦东新区人民法院", "count": 1 }, { "key": "北京市高级人民法院", "count": 1 }, { "key": "北海市海城区人民法院", "count": 1 }, { "key": "南京市江宁区人民法院", "count": 1 } ], "起诉方": 76, "应诉方": 111, "总数": 187 }, "股权冻结统计": { "类型": [], "状态": [], "执行事项": [], "执行法院": [], "总数": 0 }, "行政处罚统计": { "处罚年份": [], "决定机关": [], "总数": 0 }, "股权出质统计": { "状态": [ { "key": "有效", "count": 10 }, { "key": "注销", "count": 3 } ], "总数": 13 }, "对外担保统计": { "主债权种类": [], "保证的方式": [], "主债权数额极值": { "max": null, "min": null }, "总数": 0 }, "经营异常统计": { "列入经营异常名录原因": [], "移出经营异常名录原因": [], "总数": 0 }, "欠税公告统计": { "欠税税种": [], "总数": 0 }, "严重违法统计": { "类别": [], "是否移除": [], "总数": 0 }, "变更记录统计": { "变更年份": [ { "key": "2019", "count": 11 }, { "key": "2017", "count": 7 }, { "key": "2011", "count": 3 }, { "key": "2018", "count": 3 }, { "key": "2020", "count": 3 }, { "key": "2012", "count": 2 }, { "key": "2014", "count": 2 }, { "key": "2016", "count": 2 }, { "key": "2022", "count": 2 }, { "key": "2013", "count": 1 }, { "key": "2015", "count": 1 }, { "key": "2023", "count": 1 } ], "变更项目": [ { "key": "经营范围", "count": 25 }, { "key": "投资人", "count": 4 }, { "key": "注册资本", "count": 4 }, { "key": "董事（理事）、经理、监事", "count": 4 }, { "key": "营业期限", "count": 1 } ], "总数": 38 } }, "message": "请求成功", "status": "success" } ``` ## 7. 代码示例 ### 7.1 CURL ```shell curl --location --request GET 'https://open.chineselaw.com/open/rh_enterpriseAggregationSummary?id=a80a4cc8-9954-4dd3-bcaf-aebb99487b14' \ --header 'X-API-Key: 你的api_key' \ --header 'Accept: application/json' ``` ### 7.2 Python ```python import requests url = "https://open.chineselaw.com/open/rh_enterpriseAggregationSummary" API_KEY = "你的api_key" headers = { "X-API-Key": API_KEY, "Accept": "application/json", } params = { 'id': 'a80a4cc8-9954-4dd3-bcaf-aebb99487b14', } response = requests.get(url, params=params, headers=headers, timeout=60) response.raise_for_status() print(response.json()) ``` ### 7.3 Java ```java import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.time.Duration; public class EnterpriseAggregationSummaryExample { public static void main(String[] args) throws Exception { String apiKey = "你的api_key"; String url = "https://open.chineselaw.com/open/rh_enterpriseAggregationSummary?id=a80a4cc8-9954-4dd3-bcaf-aebb99487b14"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create(url)) .timeout(Duration.ofSeconds(60)) .header("X-API-Key", apiKey) .header("Accept", "application/json") .GET() .build(); HttpClient client = HttpClient.newHttpClient(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode()); System.out.println(response.body()); } } ``` ### 7.4 JavaScript ```javascript const API_KEY = "你的api_key"; const url = new URL("https://open.chineselaw.com/open/rh_enterpriseAggregationSummary"); url.searchParams.set('id', 'a80a4cc8-9954-4dd3-bcaf-aebb99487b14'); const res = await fetch(url, { method: "GET", headers: { "X-API-Key": API_KEY, "Accept": "application/json", }, }); if (!res.ok) throw new Error(`HTTP ${res.status}`); console.log(await res.json()); ``` --- ## 企业检索接口 - Category: 企业信息 - ID: 19 - routeKey: `rh_enterpriseSearch` - HTTP method: `GET` - Direct endpoint: `https://open.chineselaw.com/open/rh_enterpriseSearch` - Detail JSON: `https://apiplatform.legalmind.cn/api/apis/19` - MCP tool: `yuandian_rh_enterpriseSearch` - MCP server: `yuandian-company` at `https://open.chineselaw.com/mcp/company/stream` - Price: 1 POINT/call; chargeType=1 Description: 根据关键词检索企业名称返回企业候选列表，精准命中优先。 ### Direct API Authentication ```http X-API-Key: YOUR_API_KEY Accept: application/json ``` ### MCP Authentication ```http Accept: application/json, text/event-stream Authorization: Bearer YOUR_API_KEY ``` ### Full Document # 企业检索接口 ## 1. 基本信息 - **接口名称**：企业检索接口 - **接口用途**：根据关键词检索企业名称返回企业候选列表，精准命中优先。 ## 2. 请求信息 - **HTTP Method**：GET - **URL**：`https://open.chineselaw.com/open/rh_enterpriseSearch` ## 3. 请求参数（Query） | 参数名 | 类型 | 是否必填 | 说明 | | ------- | ------ | -------- | -------------------------------------------- | | `name` | string | 是 | 企业名称 | | `top_k` | int | 否 | 返回条数，默认10，范围1~50，越界按默认值处理 | ## 4. 请求示例 ``` GET https://open.chineselaw.com/open/rh_enterpriseSearch?name=百度网讯&top_k=10 ``` ## 5. 响应说明 ### **5.1 通用返回结构** | 字段名 | 类型 | 说明 | | --------- | ------ | ------------------------- | | `status` | string | `success` / `notFound` 等 | | `code` | number | 成功 200 | | `message` | string | 提示信息 | | `data` | object | 数据结果 | ### 5.2 **`data` 对象说明** | 字段名 | 类型 | 说明 | | ------------------ | ------ | ---------------- | | `id` | string | 企业ID | | `企业名称` | string | 企业名称 | | `统一社会信用代码` | string | 统一社会信用代码 | ## 6. 响应示例 ```JSON { "code": 200, "data": [ { "id": "a80a4cc8-9954-4dd3-bcaf-aebb99487b14", "统一社会信用代码": "91110000802100433B", "企业名称": "北京百度网讯科技有限公司" }, { "id": "63df0ffb-2c04-4a87-955a-dd4af21e62bb", "统一社会信用代码": "914403006748096152", "企业名称": "北京百度网讯科技有限公司深圳分公司" }, { "id": "7362097b-ee0c-4aa5-b14d-7a499c5283f7", "统一社会信用代码": "914419006751765224", "企业名称": "北京百度网讯科技有限公司东莞分公司" }, { "id": "eb462768-37b5-4d60-b55e-9ffc25c1cd37", "统一社会信用代码": "91440101675657502F", "企业名称": "北京百度网讯科技有限公司广州分公司" }, { "id": "68e55e77-06b6-4e6f-a0d2-0115e4ed298b", "统一社会信用代码": "91310114674598440W", "企业名称": "北京百度网讯科技有限公司上海分公司" }, { "id": "12a600b2-79c1-4b9f-b96b-40045c749f7e", "统一社会信用代码": "91350102MA2XW3LD3F", "企业名称": "福州百度网讯网络科技有限公司" }, { "id": "f6afc0e6-2ee1-4c7e-b106-21ffc27f6505", "统一社会信用代码": "91610131592209907Q", "企业名称": "北京百度网讯科技有限公司西安分公司" }, { "id": "7489b383-b2d1-485a-8cc8-c68203074f10", "统一社会信用代码": "91500000588927949C", "企业名称": "北京百度网讯科技有限公司重庆分公司" }, { "id": "308177f3-9f0a-4c0e-bd5f-0bcc70557669", "统一社会信用代码": "91320104070740629E", "企业名称": "北京百度网讯科技有限公司南京分公司" }, { "id": "c751d3b8-e48a-475d-b11f-492bed03d0ae", "统一社会信用代码": "", "企业名称": "北京百度网讯科技有限公司佛山分公司" } ], "message": "请求成功", "status": "success" } ``` --- ## 企业基本信息接口 - Category: 企业信息 - ID: 40 - routeKey: `rh_enterpriseBaseInfo` - HTTP method: `GET` - Direct endpoint: `https://open.chineselaw.com/open/rh_enterpriseBaseInfo` - Detail JSON: `https://apiplatform.legalmind.cn/api/apis/40` - MCP tool: `yuandian_rh_enterpriseBaseInfo` - MCP server: `yuandian-company` at `https://open.chineselaw.com/mcp/company/stream` - Price: 10 POINT/call; chargeType=1 Description: 根据企业ID或统一社会信用代码查询企业扁平详情（基本信息+股东+十大股东+十大流通股东+核心成员+分支机构）。 ### Direct API Authentication ```http X-API-Key: YOUR_API_KEY Accept: application/json ``` ### MCP Authentication ```http Accept: application/json, text/event-stream Authorization: Bearer YOUR_API_KEY ``` ### Full Document # 企业基本信息接口 ## 1. 基本信息 - **接口名称**：企业基本信息接口 - **接口用途**：根据企业ID或统一社会信用代码查询企业扁平详情（基本信息+股东+十大股东+十大流通股东+核心成员+分支机构）。 ## 2. 请求信息 - **HTTP Method**：GET - **URL**：`https://open.chineselaw.com/open/rh_enterpriseBaseInfo` ## 3. 请求参数（Query） | 参数名 | 类型 | 是否必填 | 说明 | | ---------- | ------ | -------- | ---------------- | | `id` | string | 否 | 企业ID | | `tyshxydm` | string | 否 | 统一社会信用代码 | > `id` 与 `tyshxydm` 不能同时为空。 ## 4. 请求示例 ``` GET https://open.chineselaw.com/open/rh_enterpriseBaseInfo?id=a80a4cc8-9954-4dd3-bcaf-aebb99487b14 ``` ## 5. 响应说明 ### **5.1 通用返回结构** | 字段名 | 类型 | 说明 | | --------- | ------ | ------------------------- | | `status` | string | `success` / `notFound` 等 | | `code` | number | 成功 200 | | `message` | string | 提示信息 | | `data` | object | 数据结果 | ## 6. 响应示例 ```JSON { "code": 200, "data": { "id": "a80a4cc8-9954-4dd3-bcaf-aebb99487b14", "企业名称": "北京百度网讯科技有限公司", "法定代表人": "梁志祥", "注册资本": "1342128万人民币", "工商注册号": "110108002734659", "组织机构码": "802100433", "统一社会信用代码": "91110000802100433B", "企业类型": "有限责任公司(自然人投资或控股)", "行业": "科技推广和应用服务业", "成立日期": "2001年06月05日", "营业期限": "2001年06月05日~未公开", "核准日期": "2025年12月04日", "登记机关": "北京市海淀区市场监督管理局", "注册地址": "北京市海淀区上地十街10号百度大厦2层", "经营状态": "存续", "经营范围": "一般项目：技术服务、技术开发、技术咨询、技术交流、技术转让、技术推广；计算机软硬件及辅助设备零售；计算机软硬件及辅助设备批发；软件开发；计算机系统服务；信息系统集成服务；数据处理服务；数字内容制作服务（不含出版发行）；广告制作；广告发布；广告设计、代理；信息技术咨询服务；企业管理咨询；社会经济咨询服务；教育咨询服务（不含涉许可审批的教育培训活动）；健康咨询服务（不含诊疗服务）；专业设计服务；市场营销策划；会议及展览服务；票务代理服务；翻译服务；法律咨询（不含依法须律师事务所执业许可的业务）；人力资源服务（不含职业中介活动、劳务派遣服务）；软件销售；电子产品销售；电子元器件批发；电子元器件零售；机械设备租赁；家用电器销售；机械设备销售；五金产品批发；五金产品零售；玩具、动漫及游艺用品销售；游艺用品及室内游艺器材销售；照相机及器材销售；化妆品批发；化妆品零售；个人卫生用品销售；体育用品及器材批发；体育用品及器材零售；针纺织品销售；服装服饰零售；服装服饰批发；鞋帽零售；鞋帽批发；日用品销售；日用品批发；珠宝首饰零售；珠宝首饰批发；工艺美术品及礼仪用品销售（象牙及其制品除外）；工艺美术品及收藏品批发（象牙及其制品除外）；钟表销售；眼镜销售（不含隐形眼镜）；玩具销售；办公用品销售；摩托车及零配件零售；摩托车及零配件批发；仪器仪表销售；家具销售；塑料制品销售；建筑材料销售；通讯设备销售；食品销售（仅销售预包装食品）；保健食品（预包装）销售；货物进出口；技术进出口；进出口代理；汽车零部件及配件制造；汽车零配件零售；汽车零配件批发；汽车销售；第一类医疗器械销售；第二类医疗器械销售。（除依法须经批准的项目外，凭营业执照依法自主开展经营活动）许可项目：基础电信业务；第一类增值电信业务；第二类增值电信业务；网络文化经营；出版物零售；出版物批发；演出经纪；职业中介活动；广播电视节目制作经营；信息网络传播视听节目；互联网新闻信息服务；测绘服务。（依法须经批准的项目，经相关部门批准后方可开展经营活动，具体经营项目以相关部门批准文件或许可证件为准）（不得从事国家和本市产业政策禁止和限制类项目的经营活动。）", "股东信息": [ { "股东名称": "崔珊珊", "股东类型": "自然人股东", "出资比例": 0, "认缴出资额": "", "实缴出资额": "", "参股日期": "2019年08月20日" }, { "股东名称": "李彦宏", "股东类型": "自然人股东", "出资比例": 0, "认缴出资额": "", "实缴出资额": "" } ], "核心成员": [ { "姓名": "李彦宏", "职务": "执行董事" }, { "姓名": "梁志祥", "职务": "经理" }, { "姓名": "崔珊珊", "职务": "监事" }, { "姓名": "贝淑艳", "职务": "财务负责人" } ], "分支机构": [ { "分支机构名称": "北京百度网讯科技有限公司东莞分公司", "经营状态": "存续（在营、开业、在册）", "负责人": "郭丽霞", "成立日期": "2008年05月15日" }, { "分支机构名称": "北京百度网讯科技有限公司南京分公司", "经营状态": "注销", "负责人": "赵坤", "成立日期": "2013年07月25日" }, { "分支机构名称": "北京百度网讯科技有限公司广州分公司", "经营状态": "存续", "负责人": "郭丽霞", "成立日期": "2008年05月20日" }, { "分支机构名称": "北京百度网讯科技有限公司深圳分公司", "经营状态": "存续", "负责人": "郭丽霞", "成立日期": "2008年04月18日" }, { "分支机构名称": "北京百度网讯科技有限公司上海分公司", "经营状态": "存续（在营、开业、在册）", "负责人": "郭丽霞", "成立日期": "2008年05月05日" }, { "分支机构名称": "北京百度网讯科技有限公司重庆分公司", "经营状态": "注销", "负责人": "向海龙", "成立日期": "2012年01月11日" }, { "分支机构名称": "北京百度网讯科技有限公司西安分公司", "经营状态": "注销", "负责人": "向海龙", "成立日期": "2012年03月02日" }, { "分支机构名称": "北京百度网讯科技有限公司佛山分公司", "经营状态": "注销", "负责人": "刘计平", "成立日期": "2008年04月29日" }, { "分支机构名称": "北京百度网讯科技有限公司哈尔滨分公司", "经营状态": "注销", "负责人": "向海龙", "成立日期": "2012年05月08日" } ] }, "message": "请求成功", "status": "success" } ``` ## 7. 代码示例 ### 7.1 CURL ```shell curl --location --request GET 'https://open.chineselaw.com/open/rh_enterpriseBaseInfo?id=a80a4cc8-9954-4dd3-bcaf-aebb99487b14' \ --header 'X-API-Key: 你的api_key' \ --header 'Accept: application/json' ``` ### 7.2 Python ```python import requests url = "https://open.chineselaw.com/open/rh_enterpriseBaseInfo" API_KEY = "你的api_key" headers = { "X-API-Key": API_KEY, "Accept": "application/json", } params = { 'id': 'a80a4cc8-9954-4dd3-bcaf-aebb99487b14', } response = requests.get(url, params=params, headers=headers, timeout=60) response.raise_for_status() print(response.json()) ``` ### 7.3 Java ```java import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.time.Duration; public class EnterpriseBaseInfoExample { public static void main(String[] args) throws Exception { String apiKey = "你的api_key"; String url = "https://open.chineselaw.com/open/rh_enterpriseBaseInfo?id=a80a4cc8-9954-4dd3-bcaf-aebb99487b14"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create(url)) .timeout(Duration.ofSeconds(60)) .header("X-API-Key", apiKey) .header("Accept", "application/json") .GET() .build(); HttpClient client = HttpClient.newHttpClient(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode()); System.out.println(response.body()); } } ``` ### 7.4 JavaScript ```javascript const API_KEY = "你的api_key"; const url = new URL("https://open.chineselaw.com/open/rh_enterpriseBaseInfo"); url.searchParams.set('id', 'a80a4cc8-9954-4dd3-bcaf-aebb99487b14'); const res = await fetch(url, { method: "GET", headers: { "X-API-Key": API_KEY, "Accept": "application/json", }, }); if (!res.ok) throw new Error(`HTTP ${res.status}`); console.log(await res.json()); ``` --- ## 企业对外投资信息列表接口 - Category: 企业信息 - ID: 39 - routeKey: `rh_enterpriseOutInvest` - HTTP method: `GET` - Direct endpoint: `https://open.chineselaw.com/open/rh_enterpriseOutInvest` - Detail JSON: `https://apiplatform.legalmind.cn/api/apis/39` - MCP tool: `yuandian_rh_enterpriseOutInvest` - MCP server: `yuandian-company` at `https://open.chineselaw.com/mcp/company/stream` - Price: 5 POINT/call; chargeType=1 Description: 根据企业ID或统一社会信用代码查询企业对外投资信息列表，分页查询，每页默认30条。 ### Direct API Authentication ```http X-API-Key: YOUR_API_KEY Accept: application/json ``` ### MCP Authentication ```http Accept: application/json, text/event-stream Authorization: Bearer YOUR_API_KEY ``` ### Full Document # 企业对外投资信息列表接口 ## 1. 基本信息 - **接口名称**：企业对外投资信息列表接口 - **接口用途**：根据企业ID或统一社会信用代码查询企业对外投资信息列表，分页查询，每页默认30条。 ## 2. 请求信息 - **HTTP Method**：GET - **URL**：`https://open.chineselaw.com/open/rh_enterpriseOutInvest` ## 3. 请求参数（Query） | 参数名 | 类型 | 是否必填 | 说明 | | ---------- | ------ | -------- | ---------------- | | `id` | string | 否 | 企业ID | | `tyshxydm` | string | 否 | 统一社会信用代码 | | `pageNo` | int | 否 | 页码，默认1 | > `id` 与 `tyshxydm` 不能同时为空。 ## 4. 请求示例 ``` GET https://open.chineselaw.com/open/rh_enterpriseOutInvest?id=a80a4cc8-9954-4dd3-bcaf-aebb99487b14&pageNo=1 ``` ## 5. 响应说明 ### **5.1 通用返回结构** | 字段名 | 类型 | 说明 | | --------- | ------ | ------------------------- | | `status` | string | `success` / `notFound` 等 | | `code` | number | 成功 200 | | `message` | string | 提示信息 | | `data` | object | 数据结果 | ### 5.2 **`data` 对象说明（概要）** | 字段名 | 类型 | 说明 | | ---------- | -------- | ---------------- | | `id` | string | 企业ID | | `name` | string | 企业名称 | | `total` | number | 总数 | | `pageNo` | number | 当前结果页码 | | `pageSize` | number | 每页结果列表数量 | | `hasMore` | boolean | 是否还有下一页 | | `list` | object[] | 当前结果列表 | ## 6. 响应示例 ```JSON { "code": 200, "data": { "id": "a80a4cc8-9954-4dd3-bcaf-aebb99487b14", "name": "北京百度网讯科技有限公司", "total": 98, "pageNo": 1, "pageSize": 50, "hasMore": true, "list": [ { "被投资企业名称": "北京麟行科技有限公司", "被投资企业法定代表人": "沈阳", "注册资本": "100万元人民币元人民币", "出资比例": 1, "成立日期": "2025年08月15日", "经营状态": "存续（在营、开业、在册）" }, { "被投资企业名称": "百度智能云（海阳）科技有限公司", "被投资企业法定代表人": "王晓靓", "注册资本": "1000万元人民币元人民币", "出资比例": 1, "成立日期": "2025年05月28日", "经营状态": "存续（在营、开业、在册）" } ... ] }, "message": "请求成功", "status": "success" } ``` ## 7. 代码示例 ### 7.1 CURL ```shell curl --location --request GET 'https://open.chineselaw.com/open/rh_enterpriseOutInvest?id=a80a4cc8-9954-4dd3-bcaf-aebb99487b14&pageNo=1' \ --header 'X-API-Key: 你的api_key' \ --header 'Accept: application/json' ``` ### 7.2 Python ```python import requests url = "https://open.chineselaw.com/open/rh_enterpriseOutInvest" API_KEY = "你的api_key" headers = { "X-API-Key": API_KEY, "Accept": "application/json", } params = { 'id': 'a80a4cc8-9954-4dd3-bcaf-aebb99487b14', 'pageNo': '1', } response = requests.get(url, params=params, headers=headers, timeout=60) response.raise_for_status() print(response.json()) ``` ### 7.3 Java ```java import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.time.Duration; public class EnterpriseOutInvestExample { public static void main(String[] args) throws Exception { String apiKey = "你的api_key"; String url = "https://open.chineselaw.com/open/rh_enterpriseOutInvest?id=a80a4cc8-9954-4dd3-bcaf-aebb99487b14&pageNo=1"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create(url)) .timeout(Duration.ofSeconds(60)) .header("X-API-Key", apiKey) .header("Accept", "application/json") .GET() .build(); HttpClient client = HttpClient.newHttpClient(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode()); System.out.println(response.body()); } } ``` ### 7.4 JavaScript ```javascript const API_KEY = "你的api_key"; const url = new URL("https://open.chineselaw.com/open/rh_enterpriseOutInvest"); url.searchParams.set('id', 'a80a4cc8-9954-4dd3-bcaf-aebb99487b14'); url.searchParams.set('pageNo', '1'); const res = await fetch(url, { method: "GET", headers: { "X-API-Key": API_KEY, "Accept": "application/json", }, }); if (!res.ok) throw new Error(`HTTP ${res.status}`); console.log(await res.json()); ``` --- ## 企业商标信息列表接口 - Category: 企业信息 - ID: 38 - routeKey: `rh_enterpriseBrand` - HTTP method: `GET` - Direct endpoint: `https://open.chineselaw.com/open/rh_enterpriseBrand` - Detail JSON: `https://apiplatform.legalmind.cn/api/apis/38` - MCP tool: `yuandian_rh_enterpriseBrand` - MCP server: `yuandian-company` at `https://open.chineselaw.com/mcp/company/stream` - Price: 5 POINT/call; chargeType=1 Description: 根据企业ID或统一社会信用代码查询企业商标信息列表，分页查询，每页默认30条。 ### Direct API Authentication ```http X-API-Key: YOUR_API_KEY Accept: application/json ``` ### MCP Authentication ```http Accept: application/json, text/event-stream Authorization: Bearer YOUR_API_KEY ``` ### Full Document # 企业商标信息列表接口 ## 1. 基本信息 - **接口名称**：企业商标信息列表接口 - **接口用途**：根据企业ID或统一社会信用代码查询企业商标信息列表，分页查询，每页默认30条。 ## 2. 请求信息 - **HTTP Method**：GET - **URL**：`https://open.chineselaw.com/open/rh_enterpriseBrand` ## 3. 请求参数（Query） | 参数名 | 类型 | 是否必填 | 说明 | | ---------- | ------ | -------- | ---------------- | | `id` | string | 否 | 企业ID | | `tyshxydm` | string | 否 | 统一社会信用代码 | | `pageNo` | int | 否 | 页码，默认1 | > `id` 与 `tyshxydm` 不能同时为空。 ## 4. 请求示例 ``` GET https://open.chineselaw.com/open/rh_enterpriseBrand?id=a80a4cc8-9954-4dd3-bcaf-aebb99487b14&pageNo=1 ``` ## 5. 响应说明 ### **5.1 通用返回结构** | 字段名 | 类型 | 说明 | | --------- | ------ | ------------------------- | | `status` | string | `success` / `notFound` 等 | | `code` | number | 成功 200 | | `message` | string | 提示信息 | | `data` | object | 数据结果 | ### 5.2 **`data` 对象说明（概要）** | 字段名 | 类型 | 说明 | | ---------- | -------- | ---------------- | | `id` | string | 企业ID | | `name` | string | 企业名称 | | `total` | number | 总数 | | `pageNo` | number | 当前结果页码 | | `pageSize` | number | 每页结果列表数量 | | `hasMore` | boolean | 是否还有下一页 | | `list` | object[] | 当前结果列表 | ## 6. 响应示例 ```JSON { "code": 200, "data": { "id": "a80a4cc8-9954-4dd3-bcaf-aebb99487b14", "name": "北京百度网讯科技有限公司", "total": 1273, "pageNo": 1, "pageSize": 50, "hasMore": true, "list": [ { "商标名称": "百度书城 百度", "商标logo": "https://winhc-trademark.oss-cn-shanghai.aliyuncs.com/81/66/ee/d5/ef/83/3f/6d/15550723/38.jpg", "注册号": "15550723", "类别": "通讯服务", "流程状态": "已注册", "专用权期限开始日期": "2025年12月07日", "专用权期限结束日期": "2035年12月06日" }, { "商标名称": "百度理财 百度", "商标logo": "https://winhc-trademark.oss-cn-shanghai.aliyuncs.com/41/ae/6b/a5/5e/91/24/27/15163475/38.jpg", "注册号": "15163475", "类别": "通讯服务", "流程状态": "已注册", "专用权期限开始日期": "2025年11月28日", "专用权期限结束日期": "2035年11月27日" } ... ] }, "message": "请求成功", "status": "success" } ``` ## 7. 代码示例 ### 7.1 CURL ```shell curl --location --request GET 'https://open.chineselaw.com/open/rh_enterpriseBrand?id=a80a4cc8-9954-4dd3-bcaf-aebb99487b14&pageNo=1' \ --header 'X-API-Key: 你的api_key' \ --header 'Accept: application/json' ``` ### 7.2 Python ```python import requests url = "https://open.chineselaw.com/open/rh_enterpriseBrand" API_KEY = "你的api_key" headers = { "X-API-Key": API_KEY, "Accept": "application/json", } params = { 'id': 'a80a4cc8-9954-4dd3-bcaf-aebb99487b14', 'pageNo': '1', } response = requests.get(url, params=params, headers=headers, timeout=60) response.raise_for_status() print(response.json()) ``` ### 7.3 Java ```java import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.time.Duration; public class EnterpriseBrandExample { public static void main(String[] args) throws Exception { String apiKey = "你的api_key"; String url = "https://open.chineselaw.com/open/rh_enterpriseBrand?id=a80a4cc8-9954-4dd3-bcaf-aebb99487b14&pageNo=1"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create(url)) .timeout(Duration.ofSeconds(60)) .header("X-API-Key", apiKey) .header("Accept", "application/json") .GET() .build(); HttpClient client = HttpClient.newHttpClient(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode()); System.out.println(response.body()); } } ``` ### 7.4 JavaScript ```javascript const API_KEY = "你的api_key"; const url = new URL("https://open.chineselaw.com/open/rh_enterpriseBrand"); url.searchParams.set('id', 'a80a4cc8-9954-4dd3-bcaf-aebb99487b14'); url.searchParams.set('pageNo', '1'); const res = await fetch(url, { method: "GET", headers: { "X-API-Key": API_KEY, "Accept": "application/json", }, }); if (!res.ok) throw new Error(`HTTP ${res.status}`); console.log(await res.json()); ``` --- ## 企业专利信息列表接口 - Category: 企业信息 - ID: 37 - routeKey: `rh_enterprisePatent` - HTTP method: `GET` - Direct endpoint: `https://open.chineselaw.com/open/rh_enterprisePatent` - Detail JSON: `https://apiplatform.legalmind.cn/api/apis/37` - MCP tool: `yuandian_rh_enterprisePatent` - MCP server: `yuandian-company` at `https://open.chineselaw.com/mcp/company/stream` - Price: 5 POINT/call; chargeType=1 Description: 根据企业ID或统一社会信用代码查询企业专利信息列表，分页查询，每页默认30条。 ### Direct API Authentication ```http X-API-Key: YOUR_API_KEY Accept: application/json ``` ### MCP Authentication ```http Accept: application/json, text/event-stream Authorization: Bearer YOUR_API_KEY ``` ### Full Document # 企业专利信息列表接口 ## 1. 基本信息 - **接口名称**：企业专利信息列表接口 - **接口用途**：根据企业ID或统一社会信用代码查询企业专利信息列表，分页查询，每页默认30条。 ## 2. 请求信息 - **HTTP Method**：GET - **URL**：`https://open.chineselaw.com/open/rh_enterprisePatent` ## 3. 请求参数（Query） | 参数名 | 类型 | 是否必填 | 说明 | | ---------- | ------ | -------- | ---------------- | | `id` | string | 否 | 企业ID | | `tyshxydm` | string | 否 | 统一社会信用代码 | | `pageNo` | int | 否 | 页码，默认1 | > `id` 与 `tyshxydm` 不能同时为空。 ## 4. 请求示例 ``` GET https://open.chineselaw.com/open/rh_enterprisePatent?id=078361f3-cee8-48c1-9af0-dcba3fa9a492&pageNo=1 ``` ## 5. 响应说明 ### **5.1 通用返回结构** | 字段名 | 类型 | 说明 | | --------- | ------ | ------------------------- | | `status` | string | `success` / `notFound` 等 | | `code` | number | 成功 200 | | `message` | string | 提示信息 | | `data` | object | 数据结果 | ### 5.2 **`data` 对象说明（概要）** | 字段名 | 类型 | 说明 | | ---------- | -------- | ---------------- | | `id` | string | 企业ID | | `name` | string | 企业名称 | | `total` | number | 总数 | | `pageNo` | number | 当前结果页码 | | `pageSize` | number | 每页结果列表数量 | | `hasMore` | boolean | 是否还有下一页 | | `list` | object[] | 当前结果列表 | ## 6. 响应示例 ```JSON { "code": 200, "data": { "id": "a80a4cc8-9954-4dd3-bcaf-aebb99487b14", "name": "北京百度网讯科技有限公司", "total": 23163, "pageNo": 1, "pageSize": 50, "hasMore": true, "list": [ { "申请公布号": "CN121743868A", "专利名称": "大模型的训练方法、问答方法、装置、设备以及存储介质", "申请号": "CN202511864451.4", "分类号": "[\"G06F18/214\",\"G06F18/2415\",\"G06N5/04\",\"G06N3/0895\",\"G06N3/091\"]", "发明人": "[\"文祎琳\",\"陈沐晗\",\"吕中厚\",\"包沉浮\",\"王国秋\",\"田伟娟\",\"侯金昌\",\"韩淼\"]", "申请人": [ "北京百度网讯科技有限公司" ], "申请日期": "2025-12-10", "申请公布日期": "2026-03-27", "代理机构": "北京易光知识产权代理有限公司", "代理人": "[\"阎敏\",\"陈晓欣\"]", "地址": "北京市海淀区上地十街10号百度大厦2层", "摘要": "本公开提供了大模型的训练方法、问答方法、装置、设备以及存储介质，涉及计算机技术领域，尤其涉及深度学习、大模型、智能问答、安全检测等技术领域。具体实现方案为：确定训练样本集合，该训练样本集合包含正样本和负样本；该正样本包括第一提示信息、与该第一提示信息对应的第一答案信息、第一思维链和第一标签中的至少之一；该负样本包括第二提示信息、与该第二提示信息对应的第二答案信息和第二标签中的至少之一；根据训练提示，利用该正样本和该负样本，确定目标损失函数；利用该目标损失函数，对待训练的第一大模型进行训练，以得到训练完成的第二大模型。本公开能够提升大模型对生成内容进行安全检测的准确性。" } ... ] }, "message": "请求成功", "status": "success" } ``` ## 7. 代码示例 ### 7.1 CURL ```shell curl --location --request GET 'https://open.chineselaw.com/open/rh_enterprisePatent?id=078361f3-cee8-48c1-9af0-dcba3fa9a492&pageNo=1' \ --header 'X-API-Key: 你的api_key' \ --header 'Accept: application/json' ``` ### 7.2 Python ```python import requests url = "https://open.chineselaw.com/open/rh_enterprisePatent" API_KEY = "你的api_key" headers = { "X-API-Key": API_KEY, "Accept": "application/json", } params = { 'id': '078361f3-cee8-48c1-9af0-dcba3fa9a492', 'pageNo': '1', } response = requests.get(url, params=params, headers=headers, timeout=60) response.raise_for_status() print(response.json()) ``` ### 7.3 Java ```java import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.time.Duration; public class EnterprisePatentExample { public static void main(String[] args) throws Exception { String apiKey = "你的api_key"; String url = "https://open.chineselaw.com/open/rh_enterprisePatent?id=078361f3-cee8-48c1-9af0-dcba3fa9a492&pageNo=1"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create(url)) .timeout(Duration.ofSeconds(60)) .header("X-API-Key", apiKey) .header("Accept", "application/json") .GET() .build(); HttpClient client = HttpClient.newHttpClient(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode()); System.out.println(response.body()); } } ``` ### 7.4 JavaScript ```javascript const API_KEY = "你的api_key"; const url = new URL("https://open.chineselaw.com/open/rh_enterprisePatent"); url.searchParams.set('id', '078361f3-cee8-48c1-9af0-dcba3fa9a492'); url.searchParams.set('pageNo', '1'); const res = await fetch(url, { method: "GET", headers: { "X-API-Key": API_KEY, "Accept": "application/json", }, }); if (!res.ok) throw new Error(`HTTP ${res.status}`); console.log(await res.json()); ``` --- ## 企业软件著作权信息列表接口 - Category: 企业信息 - ID: 36 - routeKey: `rh_enterpriseSoftRight` - HTTP method: `GET` - Direct endpoint: `https://open.chineselaw.com/open/rh_enterpriseSoftRight` - Detail JSON: `https://apiplatform.legalmind.cn/api/apis/36` - MCP tool: `yuandian_rh_enterpriseSoftRight` - MCP server: `yuandian-company` at `https://open.chineselaw.com/mcp/company/stream` - Price: 5 POINT/call; chargeType=1 Description: 根据企业ID或统一社会信用代码查询企业软件著作权信息列表，分页查询，每页默认30条。 ### Direct API Authentication ```http X-API-Key: YOUR_API_KEY Accept: application/json ``` ### MCP Authentication ```http Accept: application/json, text/event-stream Authorization: Bearer YOUR_API_KEY ``` ### Full Document # 企业软件著作权信息列表接口 ## 1. 基本信息 - **接口名称**：企业软件著作权信息列表接口 - **接口用途**：根据企业ID或统一社会信用代码查询企业软件著作权信息列表，分页查询，每页默认30条。 ## 2. 请求信息 - **HTTP Method**：GET - **URL**：`https://open.chineselaw.com/open/rh_enterpriseSoftRight` ## 3. 请求参数（Query） | 参数名 | 类型 | 是否必填 | 说明 | | ---------- | ------ | -------- | ---------------- | | `id` | string | 否 | 企业ID | | `tyshxydm` | string | 否 | 统一社会信用代码 | | `pageNo` | int | 否 | 页码，默认1 | > `id` 与 `tyshxydm` 不能同时为空。 ## 4. 请求示例 ``` GET https://open.chineselaw.com/open/rh_enterpriseSoftRight?id=078361f3-cee8-48c1-9af0-dcba3fa9a492&pageNo=1 ``` ## 5. 响应说明 ### **5.1 通用返回结构** | 字段名 | 类型 | 说明 | | --------- | ------ | ------------------------- | | `status` | string | `success` / `notFound` 等 | | `code` | number | 成功 200 | | `message` | string | 提示信息 | | `data` | object | 数据结果 | ### 5.2 **`data` 对象说明（概要）** | 字段名 | 类型 | 说明 | | ---------- | -------- | ---------------- | | `id` | string | 企业ID | | `name` | string | 企业名称 | | `total` | number | 总数 | | `pageNo` | number | 当前结果页码 | | `pageSize` | number | 每页结果列表数量 | | `hasMore` | boolean | 是否还有下一页 | | `list` | object[] | 当前结果列表 | ## 6. 响应示例 ```JSON { "code": 200, "data": { "id": "a80a4cc8-9954-4dd3-bcaf-aebb99487b14", "name": "北京百度网讯科技有限公司", "total": 922, "pageNo": 1, "pageSize": 50, "hasMore": true, "list": [ { "软件全称": "交通运营助手平台", "软件简称": "运营助手", "登记号": "2026SR0423878", "版本号": "V2.9", "著作权人（国籍）": "北京百度网讯科技有限公司", "登记日期": "2026年03月12日" }, { "软件全称": "城市级信控场景优化系统", "软件简称": "信控场景优化", "登记号": "2026SR0425278", "版本号": "V1.0", "著作权人（国籍）": "北京百度网讯科技有限公司", "登记日期": "2026年03月12日" } ... ] }, "message": "请求成功", "status": "success" } ``` ## 7. 代码示例 ### 7.1 CURL ```shell curl --location --request GET 'https://open.chineselaw.com/open/rh_enterpriseSoftRight?id=078361f3-cee8-48c1-9af0-dcba3fa9a492&pageNo=1' \ --header 'X-API-Key: 你的api_key' \ --header 'Accept: application/json' ``` ### 7.2 Python ```python import requests url = "https://open.chineselaw.com/open/rh_enterpriseSoftRight" API_KEY = "你的api_key" headers = { "X-API-Key": API_KEY, "Accept": "application/json", } params = { 'id': '078361f3-cee8-48c1-9af0-dcba3fa9a492', 'pageNo': '1', } response = requests.get(url, params=params, headers=headers, timeout=60) response.raise_for_status() print(response.json()) ``` ### 7.3 Java ```java import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.time.Duration; public class EnterpriseSoftRightExample { public static void main(String[] args) throws Exception { String apiKey = "你的api_key"; String url = "https://open.chineselaw.com/open/rh_enterpriseSoftRight?id=078361f3-cee8-48c1-9af0-dcba3fa9a492&pageNo=1"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create(url)) .timeout(Duration.ofSeconds(60)) .header("X-API-Key", apiKey) .header("Accept", "application/json") .GET() .build(); HttpClient client = HttpClient.newHttpClient(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode()); System.out.println(response.body()); } } ``` ### 7.4 JavaScript ```javascript const API_KEY = "你的api_key"; const url = new URL("https://open.chineselaw.com/open/rh_enterpriseSoftRight"); url.searchParams.set('id', '078361f3-cee8-48c1-9af0-dcba3fa9a492'); url.searchParams.set('pageNo', '1'); const res = await fetch(url, { method: "GET", headers: { "X-API-Key": API_KEY, "Accept": "application/json", }, }); if (!res.ok) throw new Error(`HTTP ${res.status}`); console.log(await res.json()); ``` --- ## 企业作品著作权信息列表接口 - Category: 企业信息 - ID: 35 - routeKey: `rh_enterpriseWorksRight` - HTTP method: `GET` - Direct endpoint: `https://open.chineselaw.com/open/rh_enterpriseWorksRight` - Detail JSON: `https://apiplatform.legalmind.cn/api/apis/35` - MCP tool: `yuandian_rh_enterpriseWorksRight` - MCP server: `yuandian-company` at `https://open.chineselaw.com/mcp/company/stream` - Price: 5 POINT/call; chargeType=1 Description: 根据企业ID或统一社会信用代码查询企业作品著作权信息列表，分页查询，每页默认30条。 ### Direct API Authentication ```http X-API-Key: YOUR_API_KEY Accept: application/json ``` ### MCP Authentication ```http Accept: application/json, text/event-stream Authorization: Bearer YOUR_API_KEY ``` ### Full Document # 企业作品著作权信息列表接口 ## 1. 基本信息 - **接口名称**：企业作品著作权信息列表接口 - **接口用途**：根据企业ID或统一社会信用代码查询企业作品著作权信息列表，分页查询，每页默认30条。 ## 2. 请求信息 - **HTTP Method**：GET - **URL**：`https://open.chineselaw.com/open/rh_enterpriseWorksRight` ## 3. 请求参数（Query） | 参数名 | 类型 | 是否必填 | 说明 | | ---------- | ------ | -------- | ---------------- | | `id` | string | 否 | 企业ID | | `tyshxydm` | string | 否 | 统一社会信用代码 | | `pageNo` | int | 否 | 页码，默认1 | > `id` 与 `tyshxydm` 不能同时为空。 ## 4. 请求示例 ``` GET https://open.chineselaw.com/open/rh_enterpriseWorksRight?id=078361f3-cee8-48c1-9af0-dcba3fa9a492&pageNo=1 ``` ## 5. 响应说明 ### **5.1 通用返回结构** | 字段名 | 类型 | 说明 | | --------- | ------ | ------------------------- | | `status` | string | `success` / `notFound` 等 | | `code` | number | 成功 200 | | `message` | string | 提示信息 | | `data` | object | 数据结果 | ### 5.2 **`data` 对象说明（概要）** | 字段名 | 类型 | 说明 | | ---------- | -------- | ---------------- | | `id` | string | 企业ID | | `name` | string | 企业名称 | | `total` | number | 总数 | | `pageNo` | number | 当前结果页码 | | `pageSize` | number | 每页结果列表数量 | | `hasMore` | boolean | 是否还有下一页 | | `list` | object[] | 当前结果列表 | ## 6. 响应示例 ```JSON { "code": 200, "data": { "id": "a80a4cc8-9954-4dd3-bcaf-aebb99487b14", "name": "北京百度网讯科技有限公司", "total": 320339, "pageNo": 1, "pageSize": 50, "hasMore": false, "list": [ { "作品名称": "百度健康doctorclaw产品logo", "登记号": "国作登字-2026-F-00074177", "类别": "美术", "登记日期": "2026年03月30日" }, { "作品名称": "百度健康Dr.claw产品logo", "登记号": "国作登字-2026-F-00074179", "类别": "美术", "登记日期": "2026年03月30日" } ... ] }, "message": "请求成功", "status": "success" } ``` ## 7. 代码示例 ### 7.1 CURL ```shell curl --location --request GET 'https://open.chineselaw.com/open/rh_enterpriseWorksRight?id=078361f3-cee8-48c1-9af0-dcba3fa9a492&pageNo=1' \ --header 'X-API-Key: 你的api_key' \ --header 'Accept: application/json' ``` ### 7.2 Python ```python import requests url = "https://open.chineselaw.com/open/rh_enterpriseWorksRight" API_KEY = "你的api_key" headers = { "X-API-Key": API_KEY, "Accept": "application/json", } params = { 'id': '078361f3-cee8-48c1-9af0-dcba3fa9a492', 'pageNo': '1', } response = requests.get(url, params=params, headers=headers, timeout=60) response.raise_for_status() print(response.json()) ``` ### 7.3 Java ```java import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.time.Duration; public class EnterpriseWorksRightExample { public static void main(String[] args) throws Exception { String apiKey = "你的api_key"; String url = "https://open.chineselaw.com/open/rh_enterpriseWorksRight?id=078361f3-cee8-48c1-9af0-dcba3fa9a492&pageNo=1"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create(url)) .timeout(Duration.ofSeconds(60)) .header("X-API-Key", apiKey) .header("Accept", "application/json") .GET() .build(); HttpClient client = HttpClient.newHttpClient(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode()); System.out.println(response.body()); } } ``` ### 7.4 JavaScript ```javascript const API_KEY = "你的api_key"; const url = new URL("https://open.chineselaw.com/open/rh_enterpriseWorksRight"); url.searchParams.set('id', '078361f3-cee8-48c1-9af0-dcba3fa9a492'); url.searchParams.set('pageNo', '1'); const res = await fetch(url, { method: "GET", headers: { "X-API-Key": API_KEY, "Accept": "application/json", }, }); if (!res.ok) throw new Error(`HTTP ${res.status}`); console.log(await res.json()); ``` --- ## 企业网站备案信息列表接口 - Category: 企业信息 - ID: 34 - routeKey: `rh_enterpriseIcp` - HTTP method: `GET` - Direct endpoint: `https://open.chineselaw.com/open/rh_enterpriseIcp` - Detail JSON: `https://apiplatform.legalmind.cn/api/apis/34` - MCP tool: `yuandian_rh_enterpriseIcp` - MCP server: `yuandian-company` at `https://open.chineselaw.com/mcp/company/stream` - Price: 5 POINT/call; chargeType=1 Description: 根据企业ID或统一社会信用代码查询企业网站备案信息列表，分页查询，每页默认30条。 ### Direct API Authentication ```http X-API-Key: YOUR_API_KEY Accept: application/json ``` ### MCP Authentication ```http Accept: application/json, text/event-stream Authorization: Bearer YOUR_API_KEY ``` ### Full Document # 企业网站备案信息列表接口 ## 1. 基本信息 - **接口名称**：企业网站备案信息列表接口 - **接口用途**：根据企业ID或统一社会信用代码查询企业网站备案信息列表，分页查询，每页默认30条。 ## 2. 请求信息 - **HTTP Method**：GET - **URL**：`https://open.chineselaw.com/open/rh_enterpriseIcp` ## 3. 请求参数（Query） | 参数名 | 类型 | 是否必填 | 说明 | | ---------- | ------ | -------- | ---------------- | | `id` | string | 否 | 企业ID | | `tyshxydm` | string | 否 | 统一社会信用代码 | | `pageNo` | int | 否 | 页码，默认1 | > `id` 与 `tyshxydm` 不能同时为空。 ## 4. 请求示例 ``` GET https://open.chineselaw.com/open/rh_enterpriseIcp?id=a80a4cc8-9954-4dd3-bcaf-aebb99487b14&pageNo=1 ``` ## 5. 响应说明 ### **5.1 通用返回结构** | 字段名 | 类型 | 说明 | | --------- | ------ | ------------------------- | | `status` | string | `success` / `notFound` 等 | | `code` | number | 成功 200 | | `message` | string | 提示信息 | | `data` | object | 数据结果 | ### 5.2 **`data` 对象说明（概要）** | 字段名 | 类型 | 说明 | | ---------- | -------- | ---------------- | | `id` | string | 企业ID | | `name` | string | 企业名称 | | `total` | number | 总数 | | `pageNo` | number | 当前结果页码 | | `pageSize` | number | 每页结果列表数量 | | `hasMore` | boolean | 是否还有下一页 | | `list` | object[] | 当前结果列表 | ## 6. 响应示例 ```JSON { "code": 200, "data": { "id": "a80a4cc8-9954-4dd3-bcaf-aebb99487b14", "name": "北京百度网讯科技有限公司", "total": 306, "pageNo": 1, "pageSize": 50, "hasMore": true, "list": [ { "审核时间": "2025年03月04日", "网站名称": "", "网站首页": "", "域名": "ytjh666.com", "备案号": "", "单位性质": "企业" }, { "审核时间": "2025年01月07日", "网站名称": "", "网站首页": "", "域名": "aistudio-app.com", "备案号": "", "单位性质": "企业" } ... ] }, "message": "请求成功", "status": "success" } ``` ## 7. 代码示例 ### 7.1 CURL ```shell curl --location --request GET 'https://open.chineselaw.com/open/rh_enterpriseIcp?id=a80a4cc8-9954-4dd3-bcaf-aebb99487b14&pageNo=1' \ --header 'X-API-Key: 你的api_key' \ --header 'Accept: application/json' ``` ### 7.2 Python ```python import requests url = "https://open.chineselaw.com/open/rh_enterpriseIcp" API_KEY = "你的api_key" headers = { "X-API-Key": API_KEY, "Accept": "application/json", } params = { 'id': 'a80a4cc8-9954-4dd3-bcaf-aebb99487b14', 'pageNo': '1', } response = requests.get(url, params=params, headers=headers, timeout=60) response.raise_for_status() print(response.json()) ``` ### 7.3 Java ```java import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.time.Duration; public class EnterpriseIcpExample { public static void main(String[] args) throws Exception { String apiKey = "你的api_key"; String url = "https://open.chineselaw.com/open/rh_enterpriseIcp?id=a80a4cc8-9954-4dd3-bcaf-aebb99487b14&pageNo=1"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create(url)) .timeout(Duration.ofSeconds(60)) .header("X-API-Key", apiKey) .header("Accept", "application/json") .GET() .build(); HttpClient client = HttpClient.newHttpClient(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode()); System.out.println(response.body()); } } ``` ### 7.4 JavaScript ```javascript const API_KEY = "你的api_key"; const url = new URL("https://open.chineselaw.com/open/rh_enterpriseIcp"); url.searchParams.set('id', 'a80a4cc8-9954-4dd3-bcaf-aebb99487b14'); url.searchParams.set('pageNo', '1'); const res = await fetch(url, { method: "GET", headers: { "X-API-Key": API_KEY, "Accept": "application/json", }, }); if (!res.ok) throw new Error(`HTTP ${res.status}`); console.log(await res.json()); ``` --- ## 企业变更记录信息列表接口 - Category: 企业信息 - ID: 33 - routeKey: `rh_enterpriseChangeInfo` - HTTP method: `GET` - Direct endpoint: `https://open.chineselaw.com/open/rh_enterpriseChangeInfo` - Detail JSON: `https://apiplatform.legalmind.cn/api/apis/33` - MCP tool: `yuandian_rh_enterpriseChangeInfo` - MCP server: `yuandian-company` at `https://open.chineselaw.com/mcp/company/stream` - Price: 5 POINT/call; chargeType=1 Description: 根据企业ID或统一社会信用代码查询企业变更记录列表，分页查询，每页默认30条。 ### Direct API Authentication ```http X-API-Key: YOUR_API_KEY Accept: application/json ``` ### MCP Authentication ```http Accept: application/json, text/event-stream Authorization: Bearer YOUR_API_KEY ``` ### Full Document # 企业变更记录信息列表接口 ## 1. 基本信息 - **接口名称**：企业变更记录信息列表接口 - **接口用途**：根据企业ID或统一社会信用代码查询企业变更记录列表，分页查询，每页默认30条。 ## 2. 请求信息 - **HTTP Method**：GET - **URL**：`https://open.chineselaw.com/open/rh_enterpriseChangeInfo` ## 3. 请求参数（Query） | 参数名 | 类型 | 是否必填 | 说明 | | ---------- | ------ | -------- | ---------------- | | `id` | string | 否 | 企业ID | | `tyshxydm` | string | 否 | 统一社会信用代码 | | `pageNo` | int | 否 | 页码，默认1 | > `id` 与 `tyshxydm` 不能同时为空。 ## 4. 请求示例 ``` GET https://open.chineselaw.com/open/rh_enterpriseChangeInfo?id=a80a4cc8-9954-4dd3-bcaf-aebb99487b14&pageNo=1 ``` ## 5. 响应说明 ### **5.1 通用返回结构** | 字段名 | 类型 | 说明 | | --------- | ------ | ------------------------- | | `status` | string | `success` / `notFound` 等 | | `code` | number | 成功 200 | | `message` | string | 提示信息 | | `data` | object | 数据结果 | ### 5.2 **`data` 对象说明（概要）** | 字段名 | 类型 | 说明 | | ---------- | -------- | ---------------- | | `id` | string | 企业ID | | `name` | string | 企业名称 | | `total` | number | 总数 | | `pageNo` | number | 当前结果页码 | | `pageSize` | number | 每页结果列表数量 | | `hasMore` | boolean | 是否还有下一页 | | `list` | object[] | 当前结果列表 | ## 6. 响应示例 ```JSON { "code": 200, "data": { "id": "a80a4cc8-9954-4dd3-bcaf-aebb99487b14", "name": "北京百度网讯科技有限公司", "total": 38, "pageNo": 1, "pageSize": 50 "hasMore": false, "list": [ { "变更时间": "2023年06月25日", "变更项目": "经营范围", "变更前内容": "一般项目：技术服务、技术开发、技术咨询、技术交流、技术转让、技术推广；计算机软硬件及辅助设备零售；软件开发；计算机系统服务；信息系统集成服务；数据处理服务；数字内容制作服务（不含出版发行）；软件销售；计算机软硬件及辅助设备批发；电子产品销售；电子元器件批发；电子元器件零售；机械设备租赁；广告制作；广告发布；广告设计、代理；专业设计服务；市场营销策划；会议及展览服务；信息技术咨询服务；企业管理咨询；社会经济咨询服务；家用电器销售；机械设备销售；五金产品批发；五金产品零售；玩具、动漫及游艺用品销售；游艺用品及室内游艺器材销售；照相机及器材销售；化妆品批发；化妆品零售；个人卫生用品销售；体育用品及器材批发；体育用品及器材零售；针纺织品销售；服装服饰零售；服装服饰批发；鞋帽零售；鞋帽批发；日用品销售；日用品批发；珠宝首饰零售；珠宝首饰批发；工艺美术品及礼仪用品销售（象牙及其制品除外）；工艺美术品及收藏品批发（象牙及其制品除外）；钟表销售；眼镜销售（不含隐形眼镜）；玩具销售；办公用品销售；摩托车及零配件零售；摩托车及零配件批发；仪器仪表销售；家具销售；塑料制品销售；建筑材料销售；通讯设备销售；食品销售（仅销售预包装食品）；保健食品（预包装）销售；货物进出口；技术进出口；进出口代理；汽车零部件及配件制造；汽车零配件零售；汽车零配件批发；汽车销售；健康咨询服务（不含诊疗服务）；票务代理服务；翻译服务；第一类医疗器械销售；第二类医疗器械销售。（除依法须经批准的项目外，凭营业执照依法自主开展经营活动）许可项目：基础电信业务；第一类增值电信业务；第二类增值电信业务；网络文化经营；出版物零售；出版物批发；演出经纪；职业中介活动；广播电视节目制作经营；信息网络传播视听节目；互联网新闻信息服务；测绘服务。（依法须经批准的项目，经相关部门批准后方可开展经营活动，具体经营项目以相关部门批准文件或许可证件为准）（不得从事国家和本市产业政策禁止和限制类项目的经营活动。）", "变更后内容": "一般项目：技术服务、技术开发、技术咨询、技术交流、技术转让、技术推广；计算机软硬件及辅助设备零售；软件开发；计算机系统服务；信息系统集成服务；数据处理服务；数字内容制作服务（不含出版发行）；软件销售；计算机软硬件及辅助设备批发；电子产品销售；电子元器件批发；电子元器件零售；机械设备租赁；广告制作；广告发布；广告设计、代理；专业设计服务；市场营销策划；会议及展览服务；信息技术咨询服务；企业管理咨询；社会经济咨询服务；家用电器销售；机械设备销售；五金产品零售；五金产品批发；玩具、动漫及游艺用品销售；游艺用品及室内游艺器材销售；针纺织品销售；照相机及器材销售；化妆品批发；化妆品零售；个人卫生用品销售；体育用品及器材批发；体育用品及器材零售；服装服饰零售；服装服饰批发；鞋帽零售；鞋帽批发；日用品销售；日用品批发；珠宝首饰批发；珠宝首饰零售；工艺美术品及礼仪用品销售（象牙及其制品除外）；工艺美术品及收藏品批发（象牙及其制品除外）；钟表销售；眼镜销售（不含隐形眼镜）；玩具销售；办公用品销售；摩托车及零配件零售；摩托车及零配件批发；仪器仪表销售；家具销售；塑料制品销售；建筑材料销售；通讯设备销售；食品销售（仅销售预包装食品）；保健食品（预包装）销售；货物进出口；技术进出口；进出口代理；汽车零配件批发；汽车零配件零售；汽车零部件及配件制造；汽车销售；健康咨询服务（不含诊疗服务）；票务代理服务；翻译服务；第一类医疗器械销售；第二类医疗器械销售；教育咨询服务（不含涉许可审批的教育培训活动）；人力资源服务（不含职业中介活动、劳务派遣服务）。（除依法须经批准的项目外，凭营业执照依法自主开展经营活动）许可项目：第一类增值电信业务；第二类增值电信业务；网络文化经营；出版物零售；出版物批发；演出经纪；职业中介活动；广播电视节目制作经营；信息网络传播视听节目；互联网新闻信息服务；测绘服务。（依法须经批准的项目，经相关部门批准后方可开展经营活动，具体经营项目以相关部门批准文件或许可证件为准）（不得从事国家和本市产业政策禁止和限制类项目的经营活动。）" }, { "变更时间": "2022年12月26日", "变更项目": "经营范围", "变更前内容": "一般项目：技术服务、技术开发、技术咨询、技术交流、技术转让、技术推广；计算机软硬件及辅助设备零售；软件开发；计算机系统服务；信息系统集成服务；数据处理服务；软件销售；计算机软硬件及辅助设备批发；电子产品销售；电子元器件批发；电子元器件零售；机械设备租赁；广告制作；广告发布；广告设计、代理；专业设计服务；市场营销策划；会议及展览服务；信息技术咨询服务；企业管理咨询；社会经济咨询服务；家用电器销售；机械设备销售；五金产品批发；五金产品零售；玩具、动漫及游艺用品销售；游艺用品及室内游艺器材销售；照相机及器材销售；化妆品批发；化妆品零售；个人卫生用品销售；体育用品及器材批发；体育用品及器材零售；针纺织品销售；服装服饰零售；鞋帽批发；鞋帽零售；日用品销售；日用品批发；珠宝首饰批发；珠宝首饰零售；第二类医疗器械销售；工艺美术品及礼仪用品销售（象牙及其制品除外）；工艺美术品及收藏品批发（象牙及其制品除外）；钟表销售；眼镜销售（不含隐形眼镜）；玩具销售；摩托车及零配件零售；摩托车及零配件批发；仪器仪表销售；塑料制品销售；建筑材料销售；通讯设备销售；保健食品（预包装）销售；货物进出口；技术进出口；进出口代理；办公用品销售；家具销售；第一类医疗器械销售；汽车零配件零售；汽车零配件批发；汽车销售；健康咨询服务（不含诊疗服务）；票务代理服务；数字内容制作服务（不含出版发行）；翻译服务；食品销售（仅销售预包装食品）。（除依法须经批准的项目外，凭营业执照依法自主开展经营活动）许可项目：基础电信业务；第一类增值电信业务；第二类增值电信业务；网络文化经营；出版物零售；出版物批发；演出经纪；职业中介活动；广播电视节目制作经营；信息网络传播视听节目；互联网新闻信息服务；测绘服务。（依法须经批准的项目，经相关部门批准后方可开展经营活动，具体经营项目以相关部门批准文件或许可证件为准）（不得从事国家和本市产业政策禁止和限制类项目的经营活动。）", "变更后内容": "一般项目：技术服务、技术开发、技术咨询、技术交流、技术转让、技术推广；计算机软硬件及辅助设备零售；软件开发；计算机系统服务；信息系统集成服务；数据处理服务；数字内容制作服务（不含出版发行）；软件销售；计算机软硬件及辅助设备批发；电子产品销售；电子元器件批发；电子元器件零售；机械设备租赁；广告制作；广告发布；广告设计、代理；专业设计服务；市场营销策划；会议及展览服务；信息技术咨询服务；企业管理咨询；社会经济咨询服务；家用电器销售；机械设备销售；五金产品批发；五金产品零售；玩具、动漫及游艺用品销售；游艺用品及室内游艺器材销售；照相机及器材销售；化妆品批发；化妆品零售；个人卫生用品销售；体育用品及器材批发；体育用品及器材零售；针纺织品销售；服装服饰零售；服装服饰批发；鞋帽零售；鞋帽批发；日用品销售；日用品批发；珠宝首饰零售；珠宝首饰批发；工艺美术品及礼仪用品销售（象牙及其制品除外）；工艺美术品及收藏品批发（象牙及其制品除外）；钟表销售；眼镜销售（不含隐形眼镜）；玩具销售；办公用品销售；摩托车及零配件零售；摩托车及零配件批发；仪器仪表销售；家具销售；塑料制品销售；建筑材料销售；通讯设备销售；食品销售（仅销售预包装食品）；保健食品（预包装）销售；货物进出口；技术进出口；进出口代理；汽车零部件及配件制造；汽车零配件零售；汽车零配件批发；汽车销售；健康咨询服务（不含诊疗服务）；票务代理服务；翻译服务；第一类医疗器械销售；第二类医疗器械销售。（除依法须经批准的项目外，凭营业执照依法自主开展经营活动）许可项目：基础电信业务；第一类增值电信业务；第二类增值电信业务；网络文化经营；出版物零售；出版物批发；演出经纪；职业中介活动；广播电视节目制作经营；信息网络传播视听节目；互联网新闻信息服务；测绘服务。（依法须经批准的项目，经相关部门批准后方可开展经营活动，具体经营项目以相关部门批准文件或许可证件为准）（不得从事国家和本市产业政策禁止和限制类项目的经营活动。）" } ... ] }, "message": "请求成功", "status": "success" } ``` ## 7. 代码示例 ### 7.1 CURL ```shell curl --location --request GET 'https://open.chineselaw.com/open/rh_enterpriseChangeInfo?id=a80a4cc8-9954-4dd3-bcaf-aebb99487b14&pageNo=1' \ --header 'X-API-Key: 你的api_key' \ --header 'Accept: application/json' ``` ### 7.2 Python ```python import requests url = "https://open.chineselaw.com/open/rh_enterpriseChangeInfo" API_KEY = "你的api_key" headers = { "X-API-Key": API_KEY, "Accept": "application/json", } params = { 'id': 'a80a4cc8-9954-4dd3-bcaf-aebb99487b14', 'pageNo': '1', } response = requests.get(url, params=params, headers=headers, timeout=60) response.raise_for_status() print(response.json()) ``` ### 7.3 Java ```java import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.time.Duration; public class EnterpriseChangeInfoExample { public static void main(String[] args) throws Exception { String apiKey = "你的api_key"; String url = "https://open.chineselaw.com/open/rh_enterpriseChangeInfo?id=a80a4cc8-9954-4dd3-bcaf-aebb99487b14&pageNo=1"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create(url)) .timeout(Duration.ofSeconds(60)) .header("X-API-Key", apiKey) .header("Accept", "application/json") .GET() .build(); HttpClient client = HttpClient.newHttpClient(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode()); System.out.println(response.body()); } } ``` ### 7.4 JavaScript ```javascript const API_KEY = "你的api_key"; const url = new URL("https://open.chineselaw.com/open/rh_enterpriseChangeInfo"); url.searchParams.set('id', 'a80a4cc8-9954-4dd3-bcaf-aebb99487b14'); url.searchParams.set('pageNo', '1'); const res = await fetch(url, { method: "GET", headers: { "X-API-Key": API_KEY, "Accept": "application/json", }, }); if (!res.ok) throw new Error(`HTTP ${res.status}`); console.log(await res.json()); ``` --- ## 企业涉诉信息统计接口 - Category: 企业信息 - ID: 32 - routeKey: `rh_enterpriseWritAgg` - HTTP method: `GET` - Direct endpoint: `https://open.chineselaw.com/open/rh_enterpriseWritAgg` - Detail JSON: `https://apiplatform.legalmind.cn/api/apis/32` - MCP tool: `yuandian_rh_enterpriseWritAgg` - MCP server: `yuandian-company` at `https://open.chineselaw.com/mcp/company/stream` - Price: 10 POINT/call; chargeType=1 Description: 根据企业ID或统一社会信用代码针对企业涉诉信息，统计不同维度的分布情况（案件类别、案由、文书种类、审判程序、法院层级、结案方式、结案年份、地域、诉讼身份、对手当事人身份） ### Direct API Authentication ```http X-API-Key: YOUR_API_KEY Accept: application/json ``` ### MCP Authentication ```http Accept: application/json, text/event-stream Authorization: Bearer YOUR_API_KEY ``` ### Full Document # 企业涉诉信息统计接口 ## 1. 基本信息 - **接口名称**：企业涉诉信息统计接口 - **接口用途**：根据企业ID或统一社会信用代码针对企业涉诉信息，统计不同维度的分布情况（案件类别、案由、文书种类、审判程序、法院层级、结案方式、结案年份、地域、诉讼身份、对手当事人身份）。 ## 2. 请求信息 - **HTTP Method**：GET - **URL**：`https://open.chineselaw.com/open/rh_enterpriseWritAgg` ## 3. 请求参数（Query） | 参数名 | 类型 | 是否必填 | 说明 | | ---------- | ------ | -------- | ---------------- | | `id` | string | 否 | 企业ID | | `tyshxydm` | string | 否 | 统一社会信用代码 | > `id` 与 `tyshxydm` 不能同时为空。 ## 4. 请求示例 ``` GET https://open.chineselaw.com/open/rh_enterpriseWritAgg?id=a80a4cc8-9954-4dd3-bcaf-aebb99487b14 ``` ## 5. 响应说明 ### **5.1 通用返回结构** | 字段名 | 类型 | 说明 | | --------- | ------ | ------------------------- | | `status` | string | `success` / `notFound` 等 | | `code` | number | 成功 200 | | `message` | string | 提示信息 | | `data` | object | 数据结果 | ### 5.2 **`data` 对象说明（概要）** | 字段名 | 类型 | 说明 | | ------- | ------ | -------- | | `id` | string | 企业ID | | `name` | string | 企业名称 | | `total` | number | 总数 | ## 6. 响应示例 ```JSON { "code": 200, "data": { "id": "a80a4cc8-9954-4dd3-bcaf-aebb99487b14", "name": "北京百度网讯科技有限公司", "total": 6923, "案件类别": [ { "key": "民事案件", "count": 6163 }, { "key": "管辖案件", "count": 680 }, { "key": "行政案件", "count": 44 }, { "key": "执行案件", "count": 35 }, { "key": "国际司法协助案件", "count": 1 } ], "一级案由": [ { "key": "知识产权与竞争纠纷", "count": 5542 }, { "key": "人格权纠纷", "count": 374 }, { "key": "合同、准合同纠纷", "count": 368 }, { "key": "侵权责任纠纷", "count": 278 }, { "key": "民事", "count": 31 }, { "key": "专利", "count": 28 }, { "key": "劳动争议、人事争议", "count": 17 }, { "key": "物权纠纷", "count": 14 }, { "key": "与公司、证券、保险、票据等有关的民事纠纷", "count": 6 }, { "key": "专利行政登记", "count": 3 }, { "key": "特殊诉讼程序案件案由", "count": 2 }, { "key": "监察行政处罚行政登记行政许可", "count": 2 }, { "key": "非讼程序案件案由", "count": 2 }, { "key": "食品药品行政处罚行政登记行政许可", "count": 2 }, { "key": "专利行政处理", "count": 1 }, { "key": "专利行政救助行政许可行政处理", "count": 1 }, { "key": "工商行政处罚", "count": 1 }, { "key": "监察行政处罚", "count": 1 }, { "key": "监察行政救助行政复议", "count": 1 } ], "二级案由": [ { "key": "知识产权权属、侵权纠纷", "count": 4775 }, { "key": "人格权纠纷", "count": 374 }, { "key": "合同纠纷", "count": 319 }, { "key": "侵权责任纠纷", "count": 278 }, { "key": "不正当竞争纠纷", "count": 46 }, { "key": "知识产权合同纠纷", "count": 38 }, { "key": "专利", "count": 28 }, { "key": "合同、无因管理、不当得利", "count": 26 }, { "key": "物权保护纠纷", "count": 14 }, { "key": "与公司有关的纠纷", "count": 6 }, { "key": "专利行政登记", "count": 3 }, { "key": "执行程序中的异议之诉", "count": 2 }, { "key": "监察行政处罚行政登记行政许可", "count": 2 }, { "key": "知识产权与竞争", "count": 2 }, { "key": "食品药品行政处罚行政登记行政许可", "count": 2 }, { "key": "专利行政处理", "count": 1 }, { "key": "专利行政救助行政许可行政处理", "count": 1 }, { "key": "仲裁程序案件", "count": 1 }, { "key": "劳动争议", "count": 1 }, { "key": "垄断纠纷", "count": 1 } ], "文书种类": [ { "key": "裁定书", "count": 4875 }, { "key": "判决书", "count": 2047 }, { "key": "决定书", "count": 1 } ], "审判程序": [ { "key": "一审案件", "count": 5149 }, { "key": "二审案件", "count": 1004 }, { "key": "再审审查案件", "count": 42 }, { "key": "普通执行", "count": 33 }, { "key": "再审案件", "count": 5 }, { "key": "非诉财产保全审查案件", "count": 4 }, { "key": "执行异议", "count": 2 }, { "key": "特别程序案件", "count": 1 }, { "key": "督促案件", "count": 1 }, { "key": "非诉行为保全审查案件", "count": 1 } ], "法院层级": [ { "key": "基层", "count": 4292 }, { "key": "中级", "count": 2267 }, { "key": "高级", "count": 349 }, { "key": "最高", "count": 15 } ], "结案方式": [ { "key": "准予撤诉", "count": 2368 }, { "key": "判决", "count": 1431 }, { "key": "维持", "count": 654 }, { "key": "按撤诉处理", "count": 503 }, { "key": "裁定移送其他法院管辖", "count": 317 }, { "key": "其他", "count": 254 }, { "key": "准予撤回起诉并撤销一审判决", "count": 142 }, { "key": "准予撤回上诉", "count": 99 }, { "key": "与本院其他案件并案审理", "count": 32 }, { "key": "终结本次执行", "count": 23 }, { "key": "按撤回上诉处理", "count": 19 }, { "key": "改判（含变更原判决）", "count": 19 }, { "key": "驳回起诉", "count": 19 }, { "key": "裁定驳回再审申请", "count": 17 }, { "key": "发回重审", "count": 8 }, { "key": "终结", "count": 7 }, { "key": "改判", "count": 5 }, { "key": "撤销原判并驳回起诉", "count": 2 }, { "key": "本院提审", "count": 2 }, { "key": "驳回申请", "count": 2 } ], "结案年份": [ { "key": "2019", "count": 1239 }, { "key": "2018", "count": 1114 }, { "key": "2020", "count": 1097 }, { "key": "2017", "count": 878 }, { "key": "2021", "count": 813 }, { "key": "2022", "count": 617 }, { "key": "2016", "count": 359 }, { "key": "2023", "count": 349 }, { "key": "2014", "count": 200 }, { "key": "2015", "count": 189 }, { "key": "2013", "count": 47 }, { "key": "2024", "count": 11 }, { "key": "2011", "count": 3 }, { "key": "2008", "count": 2 }, { "key": "2025", "count": 2 }, { "key": "2012", "count": 1 } ], "地域": [ { "key": "北京", "count": 3395 }, { "key": "广东", "count": 1109 }, { "key": "上海", "count": 621 }, { "key": "河南", "count": 447 }, { "key": "江苏", "count": 325 }, { "key": "重庆", "count": 149 }, { "key": "浙江", "count": 145 }, { "key": "湖南", "count": 96 }, { "key": "河北", "count": 94 }, { "key": "山东", "count": 93 }, { "key": "湖北", "count": 59 }, { "key": "四川", "count": 57 }, { "key": "陕西", "count": 51 }, { "key": "天津", "count": 40 }, { "key": "福建", "count": 40 }, { "key": "安徽", "count": 37 }, { "key": "海南", "count": 34 }, { "key": "辽宁", "count": 34 }, { "key": "江西", "count": 29 }, { "key": "最高", "count": 15 } ], "诉讼身份": [ { "key": "应诉方", "count": 5307 }, { "key": "起诉方", "count": 1541 }, { "key": "第三方", "count": 75 } ], "对方当事人身份": [ { "key": "法人", "count": 5118 }, { "key": "自然人", "count": 2140 }, { "key": "非法人组织", "count": 352 } ] }, "message": "请求成功", "status": "success" } ``` ## 7. 代码示例 ### 7.1 CURL ```shell curl --location --request GET 'https://open.chineselaw.com/open/rh_enterpriseWritAgg?id=a80a4cc8-9954-4dd3-bcaf-aebb99487b14' \ --header 'X-API-Key: 你的api_key' \ --header 'Accept: application/json' ``` ### 7.2 Python ```python import requests url = "https://open.chineselaw.com/open/rh_enterpriseWritAgg" API_KEY = "你的api_key" headers = { "X-API-Key": API_KEY, "Accept": "application/json", } params = { 'id': 'a80a4cc8-9954-4dd3-bcaf-aebb99487b14', } response = requests.get(url, params=params, headers=headers, timeout=60) response.raise_for_status() print(response.json()) ``` ### 7.3 Java ```java import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.time.Duration; public class EnterpriseWritAggExample { public static void main(String[] args) throws Exception { String apiKey = "你的api_key"; String url = "https://open.chineselaw.com/open/rh_enterpriseWritAgg?id=a80a4cc8-9954-4dd3-bcaf-aebb99487b14"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create(url)) .timeout(Duration.ofSeconds(60)) .header("X-API-Key", apiKey) .header("Accept", "application/json") .GET() .build(); HttpClient client = HttpClient.newHttpClient(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode()); System.out.println(response.body()); } } ``` ### 7.4 JavaScript ```javascript const API_KEY = "你的api_key"; const url = new URL("https://open.chineselaw.com/open/rh_enterpriseWritAgg"); url.searchParams.set('id', 'a80a4cc8-9954-4dd3-bcaf-aebb99487b14'); const res = await fetch(url, { method: "GET", headers: { "X-API-Key": API_KEY, "Accept": "application/json", }, }); if (!res.ok) throw new Error(`HTTP ${res.status}`); console.log(await res.json()); ``` --- ## 企业涉诉文书列表接口 - Category: 企业信息 - ID: 31 - routeKey: `rh_enterpriseWritList` - HTTP method: `GET` - Direct endpoint: `https://open.chineselaw.com/open/rh_enterpriseWritList` - Detail JSON: `https://apiplatform.legalmind.cn/api/apis/31` - MCP tool: `yuandian_rh_enterpriseWritList` - MCP server: `yuandian-company` at `https://open.chineselaw.com/mcp/company/stream` - Price: 10 POINT/call; chargeType=1 Description: 根据企业ID或统一社会信用代码查询企业企业涉诉文书列表，分页查询，每页默认30条。 ### Direct API Authentication ```http X-API-Key: YOUR_API_KEY Accept: application/json ``` ### MCP Authentication ```http Accept: application/json, text/event-stream Authorization: Bearer YOUR_API_KEY ``` ### Full Document # 企业涉诉文书列表接口 ## 1. 基本信息 - **接口名称**：企业涉诉文书列表接口 - **接口用途**：根据企业ID或统一社会信用代码查询企业企业涉诉文书列表，分页查询，每页默认30条。 ## 2. 请求信息 - **HTTP Method**：GET - **URL**：`https://open.chineselaw.com/open/rh_enterpriseWritList` ## 3. 请求参数（Query） | 参数名 | 类型 | 是否必填 | 说明 | | ---------- | ------ | -------- | ------------------------------------------------------ | | `id` | string | 否 | 企业ID（主表 `legal_insight_qyfx_company` 文档 `_id`） | | `tyshxydm` | string | 否 | 统一社会信用代码 | | `pageNo` | int | 否 | 页码，默认 1 | `id` 与 `tyshxydm` 至少传其一。 ## 4. 请求示例 ``` GET https://open.chineselaw.com/open/rh_enterpriseWritList?id=a80a4cc8-9954-4dd3-bcaf-aebb99487b14&pageNo=1 ``` ## 5. 响应说明 ### **5.1 通用返回结构** | 字段名 | 类型 | 说明 | | --------- | ------ | ------------------------- | | `status` | string | `success` / `notFound` 等 | | `code` | number | 成功 200 | | `message` | string | 提示信息 | | `data` | object | 数据结果 | ### 5.2 **`data` 对象说明（概要）** | 字段名 | 类型 | 说明 | | ---------- | -------- | ---------------- | | `id` | string | 企业ID | | `name` | string | 企业名称 | | `total` | number | 总数 | | `pageNo` | number | 当前结果页码 | | `pageSize` | number | 每页结果列表数量 | | `hasMore` | boolean | 是否还有下一页 | | `list` | object[] | 当前结果列表 | ## 6. 响应示例 ```JSON { "code": 200, "data": { "id": "a80a4cc8-9954-4dd3-bcaf-aebb99487b14", "name": "北京百度网讯科技有限公司", "total": 120, "pageNo": 1, "pageSize": 50, "hasMore": true, "list": [ { "文书id": "xxx", "标题": "……", "案号": "（2024）京0105民初123号", "时间": "2024-06-01", "案由": "侵害商标权纠纷", "审判程序": "一审", "文书种类": "判决书", "起诉方": ["甲公司"], "应诉方": ["乙公司"], "第三方": [], "裁判结果": "……" } ... ] }, "message": "请求成功", "status": "success" } ``` ## 7. 代码示例 ### 7.1 CURL ```shell curl --location --request GET 'https://open.chineselaw.com/open/rh_enterpriseWritList?id=a80a4cc8-9954-4dd3-bcaf-aebb99487b14&pageNo=1' \ --header 'X-API-Key: 你的api_key' \ --header 'Accept: application/json' ``` ### 7.2 Python ```python import requests url = "https://open.chineselaw.com/open/rh_enterpriseWritList" API_KEY = "你的api_key" headers = { "X-API-Key": API_KEY, "Accept": "application/json", } params = { 'id': 'a80a4cc8-9954-4dd3-bcaf-aebb99487b14', 'pageNo': '1', } response = requests.get(url, params=params, headers=headers, timeout=60) response.raise_for_status() print(response.json()) ``` ### 7.3 Java ```java import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.time.Duration; public class EnterpriseWritListExample { public static void main(String[] args) throws Exception { String apiKey = "你的api_key"; String url = "https://open.chineselaw.com/open/rh_enterpriseWritList?id=a80a4cc8-9954-4dd3-bcaf-aebb99487b14&pageNo=1"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create(url)) .timeout(Duration.ofSeconds(60)) .header("X-API-Key", apiKey) .header("Accept", "application/json") .GET() .build(); HttpClient client = HttpClient.newHttpClient(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode()); System.out.println(response.body()); } } ``` ### 7.4 JavaScript ```javascript const API_KEY = "你的api_key"; const url = new URL("https://open.chineselaw.com/open/rh_enterpriseWritList"); url.searchParams.set('id', 'a80a4cc8-9954-4dd3-bcaf-aebb99487b14'); url.searchParams.set('pageNo', '1'); const res = await fetch(url, { method: "GET", headers: { "X-API-Key": API_KEY, "Accept": "application/json", }, }); if (!res.ok) throw new Error(`HTTP ${res.status}`); console.log(await res.json()); ``` --- ## 企业开庭公告列表接口 - Category: 企业信息 - ID: 30 - routeKey: `rh_enterpriseCourtSessionNotice` - HTTP method: `GET` - Direct endpoint: `https://open.chineselaw.com/open/rh_enterpriseCourtSessionNotice` - Detail JSON: `https://apiplatform.legalmind.cn/api/apis/30` - MCP tool: `yuandian_rh_enterpriseCourtSessionNotice` - MCP server: `yuandian-company` at `https://open.chineselaw.com/mcp/company/stream` - Price: 5 POINT/call; chargeType=1 Description: 根据企业ID或统一社会信用代码查询企业开庭公告列表，分页查询，每页默认30条。 ### Direct API Authentication ```http X-API-Key: YOUR_API_KEY Accept: application/json ``` ### MCP Authentication ```http Accept: application/json, text/event-stream Authorization: Bearer YOUR_API_KEY ``` ### Full Document # 企业开庭公告列表接口 ## 1. 基本信息 - **接口名称**：企业开庭公告列表接口 - **接口用途**：根据企业ID或统一社会信用代码查询企业开庭公告列表，分页查询，每页默认30条。 ## 2. 请求信息 - **HTTP Method**：GET - **URL**：`https://open.chineselaw.com/open/rh_enterpriseCourtSessionNotice` ## 3. 请求参数（Query） | 参数名 | 类型 | 是否必填 | 说明 | | ---------- | ------ | -------- | ---------------- | | `id` | string | 否 | 企业ID | | `tyshxydm` | string | 否 | 统一社会信用代码 | | `pageNo` | int | 否 | 页码，默认1 | > `id` 与 `tyshxydm` 不能同时为空。 ## 4. 请求示例 ``` GET https://open.chineselaw.com/open/rh_enterpriseCourtSessionNotice?id=902490e5-1c92-46a3-9032-7eda9b2ff335&pageNo=1 ``` ## 5. 响应说明 ### **5.1 通用返回结构** | 字段名 | 类型 | 说明 | | --------- | ------ | ------------------------- | | `status` | string | `success` / `notFound` 等 | | `code` | number | 成功 200 | | `message` | string | 提示信息 | | `data` | object | 数据结果 | ### 5.2 **`data` 对象说明（概要）** | 字段名 | 类型 | 说明 | | ---------- | -------- | ---------------- | | `id` | string | 企业ID | | `name` | string | 企业名称 | | `total` | number | 总数 | | `pageNo` | number | 当前结果页码 | | `pageSize` | number | 每页结果列表数量 | | `hasMore` | boolean | 是否还有下一页 | | `list` | object[] | 当前结果列表 | ## 6. 响应示例 ```JSON { "code": 200, "data": { "id": "902490e5-1c92-46a3-9032-7eda9b2ff335", "name": "上海苗发金属材料有限公司", "total": 3, "pageNo": 1, "pageSize": 50, "hasMore": false, "list": [ { "起诉方": [ "上海苗发金属材料有限公司" ], "应诉方": [ "被褚昔彭", "祝高松", "余文珍", "高雪芬" ], "审理时间": "2024年08月26日", "审理法院": "海宁市人民法院" }, { "起诉方": [ "上海苗发金属材料有限公司" ], "应诉方": [ "海宁市远东环保设备科技有限公司", "褚列平", "褚昔彭" ], "案由": "案由:买卖合同纠纷&承办部门:商事审判庭&审判长/主审人:王经珍", "审理时间": "2023年08月14日", "审理法院": "上海市宝山区人民法院" }, { "起诉方": [ "上海苗发金属材料有限公司" ], "应诉方": [ "海宁市远东环保设备科技有限公司", "褚列平", "诸昔彭" ], "案由": "案由:买卖合同纠纷&承办部门:商事审判庭&审判长/主审人:王经珍", "审理时间": "2023年07月13日", "审理法院": "上海市宝山区人民法院" } ] }, "message": "请求成功", "status": "success" } ``` ## 7. 代码示例 ### 7.1 CURL ```shell curl --location --request GET 'https://open.chineselaw.com/open/rh_enterpriseCourtSessionNotice?id=902490e5-1c92-46a3-9032-7eda9b2ff335&pageNo=1' \ --header 'X-API-Key: 你的api_key' \ --header 'Accept: application/json' ``` ### 7.2 Python ```python import requests url = "https://open.chineselaw.com/open/rh_enterpriseCourtSessionNotice" API_KEY = "你的api_key" headers = { "X-API-Key": API_KEY, "Accept": "application/json", } params = { 'id': '902490e5-1c92-46a3-9032-7eda9b2ff335', 'pageNo': '1', } response = requests.get(url, params=params, headers=headers, timeout=60) response.raise_for_status() print(response.json()) ``` ### 7.3 Java ```java import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.time.Duration; public class EnterpriseCourtSessionNoticeExample { public static void main(String[] args) throws Exception { String apiKey = "你的api_key"; String url = "https://open.chineselaw.com/open/rh_enterpriseCourtSessionNotice?id=902490e5-1c92-46a3-9032-7eda9b2ff335&pageNo=1"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create(url)) .timeout(Duration.ofSeconds(60)) .header("X-API-Key", apiKey) .header("Accept", "application/json") .GET() .build(); HttpClient client = HttpClient.newHttpClient(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode()); System.out.println(response.body()); } } ``` ### 7.4 JavaScript ```javascript const API_KEY = "你的api_key"; const url = new URL("https://open.chineselaw.com/open/rh_enterpriseCourtSessionNotice"); url.searchParams.set('id', '902490e5-1c92-46a3-9032-7eda9b2ff335'); url.searchParams.set('pageNo', '1'); const res = await fetch(url, { method: "GET", headers: { "X-API-Key": API_KEY, "Accept": "application/json", }, }); if (!res.ok) throw new Error(`HTTP ${res.status}`); console.log(await res.json()); ``` --- ## 企业法院公告列表接口 - Category: 企业信息 - ID: 29 - routeKey: `rh_enterpriseCourtNotice` - HTTP method: `GET` - Direct endpoint: `https://open.chineselaw.com/open/rh_enterpriseCourtNotice` - Detail JSON: `https://apiplatform.legalmind.cn/api/apis/29` - MCP tool: `yuandian_rh_enterpriseCourtNotice` - MCP server: `yuandian-company` at `https://open.chineselaw.com/mcp/company/stream` - Price: 5 POINT/call; chargeType=1 Description: 根据企业ID或统一社会信用代码查询企业法院公告列表，分页查询，每页默认30条。 ### Direct API Authentication ```http X-API-Key: YOUR_API_KEY Accept: application/json ``` ### MCP Authentication ```http Accept: application/json, text/event-stream Authorization: Bearer YOUR_API_KEY ``` ### Full Document # 企业法院公告列表接口 ## 1. 基本信息 - **接口名称**：企业法院公告列表接口 - **接口用途**：根据企业ID或统一社会信用代码查询企业法院公告列表，分页查询，每页默认30条。 ## 2. 请求信息 - **HTTP Method**：GET - **URL**：`https://open.chineselaw.com/open/rh_enterpriseCourtNotice` ## 3. 请求参数（Query） | 参数名 | 类型 | 是否必填 | 说明 | | ---------- | ------ | -------- | ---------------- | | `id` | string | 否 | 企业ID | | `tyshxydm` | string | 否 | 统一社会信用代码 | | `pageNo` | int | 否 | 页码，默认1 | > `id` 与 `tyshxydm` 不能同时为空。 ## 4. 请求示例 ``` GET https://open.chineselaw.com/open/rh_enterpriseCourtNotice?id=a418bc20-09b4-480e-ae69-58719e189b77&pageNo=1 ``` ## 5. 响应说明 ### **5.1 通用返回结构** | 字段名 | 类型 | 说明 | | --------- | ------ | ------------------------- | | `status` | string | `success` / `notFound` 等 | | `code` | number | 成功 200 | | `message` | string | 提示信息 | | `data` | object | 数据结果 | ### 5.2 **`data` 对象说明（概要）** | 字段名 | 类型 | 说明 | | ---------- | -------- | ---------------- | | `id` | string | 企业ID | | `name` | string | 企业名称 | | `total` | number | 总数 | | `pageNo` | number | 当前结果页码 | | `pageSize` | number | 每页结果列表数量 | | `hasMore` | boolean | 是否还有下一页 | | `list` | object[] | 当前结果列表 | ## 6. 响应示例 ```JSON { "code": 200, "data": { "id": "a418bc20-09b4-480e-ae69-58719e189b77", "name": "云南三君入围文化传播有限公司", "total": 4, "pageNo": 1, "pageSize": 50, "hasMore": false, "list": [ { "起诉方": [ "廖鑫羽" ], "应诉方": [ "云南三君入围文化传播有限公司" ], "审理法院": "昆明市西山区人民法院", "公告内容": "

本院受理原告廖鑫羽与被告云南三君入围文化传播有限公司追索劳动报酬纠纷一案，案号：（2022）云0112民初2866号，原告请求判决：一、被告支付原告截至2021年8月20日欠发工资2431.8元及资金占用利息；二、本案诉讼费用由被告承担。因无法采用《中华人民共和国民事诉讼法》规定的其他方式进行送达，现依法向你公告送达起诉状副本、应诉讼通知书、举证通知书（一）、举证通知书（二）、当事人诉讼权利义务告知书及开庭传票。自本公告发出之日起，经过30日即视为送达，提出答辩状及举证期的期限为公告送达期满后的15日，并定于期满后的第七日上午9时20分（遇法定节假日顺延）在本院第十二号法庭公开开庭审理，逾期将依法缺席裁判。

" } ... ] }, "message": "请求成功", "status": "success" } ``` ## 7. 代码示例 ### 7.1 CURL ```shell curl --location --request GET 'https://open.chineselaw.com/open/rh_enterpriseCourtNotice?id=a418bc20-09b4-480e-ae69-58719e189b77&pageNo=1' \ --header 'X-API-Key: 你的api_key' \ --header 'Accept: application/json' ``` ### 7.2 Python ```python import requests url = "https://open.chineselaw.com/open/rh_enterpriseCourtNotice" API_KEY = "你的api_key" headers = { "X-API-Key": API_KEY, "Accept": "application/json", } params = { 'id': 'a418bc20-09b4-480e-ae69-58719e189b77', 'pageNo': '1', } response = requests.get(url, params=params, headers=headers, timeout=60) response.raise_for_status() print(response.json()) ``` ### 7.3 Java ```java import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.time.Duration; public class EnterpriseCourtNoticeExample { public static void main(String[] args) throws Exception { String apiKey = "你的api_key"; String url = "https://open.chineselaw.com/open/rh_enterpriseCourtNotice?id=a418bc20-09b4-480e-ae69-58719e189b77&pageNo=1"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create(url)) .timeout(Duration.ofSeconds(60)) .header("X-API-Key", apiKey) .header("Accept", "application/json") .GET() .build(); HttpClient client = HttpClient.newHttpClient(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode()); System.out.println(response.body()); } } ``` ### 7.4 JavaScript ```javascript const API_KEY = "你的api_key"; const url = new URL("https://open.chineselaw.com/open/rh_enterpriseCourtNotice"); url.searchParams.set('id', 'a418bc20-09b4-480e-ae69-58719e189b77'); url.searchParams.set('pageNo', '1'); const res = await fetch(url, { method: "GET", headers: { "X-API-Key": API_KEY, "Accept": "application/json", }, }); if (!res.ok) throw new Error(`HTTP ${res.status}`); console.log(await res.json()); ``` --- ## 企业失信被执行人信息列表接口 - Category: 企业信息 - ID: 28 - routeKey: `rh_enterpriseExecutions` - HTTP method: `GET` - Direct endpoint: `https://open.chineselaw.com/open/rh_enterpriseExecutions` - Detail JSON: `https://apiplatform.legalmind.cn/api/apis/28` - MCP tool: `yuandian_rh_enterpriseExecutions` - MCP server: `yuandian-company` at `https://open.chineselaw.com/mcp/company/stream` - Price: 5 POINT/call; chargeType=1 Description: 根据企业ID或统一社会信用代码查询企业失信被执行人列表，分页查询，每页默认30条。 ### Direct API Authentication ```http X-API-Key: YOUR_API_KEY Accept: application/json ``` ### MCP Authentication ```http Accept: application/json, text/event-stream Authorization: Bearer YOUR_API_KEY ``` ### Full Document # 企业失信被执行人信息列表接口 ## 1. 基本信息 - **接口名称**：企业失信被执行人信息列表接口 - **接口用途**：根据企业ID或统一社会信用代码查询企业失信被执行人列表，分页查询，每页默认30条。 ## 2. 请求信息 - **HTTP Method**：GET - **URL**：`https://open.chineselaw.com/open/rh_enterpriseExecutions` ## 3. 请求参数（Query） | 参数名 | 类型 | 是否必填 | 说明 | | ---------- | ------ | -------- | ---------------- | | `id` | string | 否 | 企业ID | | `tyshxydm` | string | 否 | 统一社会信用代码 | | `pageNo` | int | 否 | 页码，默认1 | > `id` 与 `tyshxydm` 不能同时为空。 ## 4. 请求示例 ``` GET https://open.chineselaw.com/open/rh_enterpriseExecutions?id=340fd09d-ead5-465b-b2c6-f448a3ce138f&pageNo=1 ``` ## 5. 响应说明 ### **5.1 通用返回结构** | 字段名 | 类型 | 说明 | | --------- | ------ | ------------------------- | | `status` | string | `success` / `notFound` 等 | | `code` | number | 成功 200 | | `message` | string | 提示信息 | | `data` | object | 数据结果 | ### 5.2 **`data` 对象说明（概要）** | 字段名 | 类型 | 说明 | | ---------- | -------- | ---------------- | | `id` | string | 企业ID | | `name` | string | 企业名称 | | `total` | number | 总数 | | `pageNo` | number | 当前结果页码 | | `pageSize` | number | 每页结果列表数量 | | `hasMore` | boolean | 是否还有下一页 | | `list` | object[] | 当前结果列表 | ## 6. 响应示例 ```JSON { "code": 200, "data": { "id": "340fd09d-ead5-465b-b2c6-f448a3ce138f", "name": "柳州创食餐饮管理有限公司", "total": 1, "pageNo": 1, "pageSize": 50, "hasMore": false, "list": [ { "失信被执行人": "柳州创食餐饮管理有限公司", "法定代表人": "", "组织结构代码": "MA5N137B5", "省份": "广西", "执行依据文书号": "（2023）桂0202民初2915号", "案号": "（2024）桂0202执589号", "做出执行依据单位": "柳州市城中区人民法院", "执行法院": "柳州市城中区人民法院", "执行标的（元）": "0", "被执行人的履行情况": "全部未履行", "立案时间": "2024年01月22日", "发布时间": "2024年06月27日", "失信被执行人行为具体情形": "有履行能力而拒不履行生效法律文书确定义务", "生效法律文书确定的义务": "详见申请书" } ] }, "message": "请求成功", "status": "success" } ``` ## 7. 代码示例 ### 7.1 CURL ```shell curl --location --request GET 'https://open.chineselaw.com/open/rh_enterpriseExecutions?id=340fd09d-ead5-465b-b2c6-f448a3ce138f&pageNo=1' \ --header 'X-API-Key: 你的api_key' \ --header 'Accept: application/json' ``` ### 7.2 Python ```python import requests url = "https://open.chineselaw.com/open/rh_enterpriseExecutions" API_KEY = "你的api_key" headers = { "X-API-Key": API_KEY, "Accept": "application/json", } params = { 'id': '340fd09d-ead5-465b-b2c6-f448a3ce138f', 'pageNo': '1', } response = requests.get(url, params=params, headers=headers, timeout=60) response.raise_for_status() print(response.json()) ``` ### 7.3 Java ```java import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.time.Duration; public class EnterpriseExecutionsExample { public static void main(String[] args) throws Exception { String apiKey = "你的api_key"; String url = "https://open.chineselaw.com/open/rh_enterpriseExecutions?id=340fd09d-ead5-465b-b2c6-f448a3ce138f&pageNo=1"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create(url)) .timeout(Duration.ofSeconds(60)) .header("X-API-Key", apiKey) .header("Accept", "application/json") .GET() .build(); HttpClient client = HttpClient.newHttpClient(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode()); System.out.println(response.body()); } } ``` ### 7.4 JavaScript ```javascript const API_KEY = "你的api_key"; const url = new URL("https://open.chineselaw.com/open/rh_enterpriseExecutions"); url.searchParams.set('id', '340fd09d-ead5-465b-b2c6-f448a3ce138f'); url.searchParams.set('pageNo', '1'); const res = await fetch(url, { method: "GET", headers: { "X-API-Key": API_KEY, "Accept": "application/json", }, }); if (!res.ok) throw new Error(`HTTP ${res.status}`); console.log(await res.json()); ``` --- ## 企业被执行人信息列表接口 - Category: 企业信息 - ID: 27 - routeKey: `rh_enterpriseExecutedPerson` - HTTP method: `GET` - Direct endpoint: `https://open.chineselaw.com/open/rh_enterpriseExecutedPerson` - Detail JSON: `https://apiplatform.legalmind.cn/api/apis/27` - MCP tool: `yuandian_rh_enterpriseExecutedPerson` - MCP server: `yuandian-company` at `https://open.chineselaw.com/mcp/company/stream` - Price: 5 POINT/call; chargeType=1 Description: 根据企业ID或统一社会信用代码查询企业被执行人列表，分页查询，每页默认30条。 ### Direct API Authentication ```http X-API-Key: YOUR_API_KEY Accept: application/json ``` ### MCP Authentication ```http Accept: application/json, text/event-stream Authorization: Bearer YOUR_API_KEY ``` ### Full Document # 企业被执行人信息列表接口 ## 1. 基本信息 - **接口名称**：企业被执行人信息列表接口 - **接口用途**：根据企业ID或统一社会信用代码查询企业被执行人列表，分页查询，每页默认30条。 ## 2. 请求信息 - **HTTP Method**：GET - **URL**：`https://open.chineselaw.com/open/rh_enterpriseExecutedPerson` ## 3. 请求参数（Query） | 参数名 | 类型 | 是否必填 | 说明 | | ---------- | ------ | -------- | ---------------- | | `id` | string | 否 | 企业ID | | `tyshxydm` | string | 否 | 统一社会信用代码 | | `pageNo` | int | 否 | 页码，默认1 | > `id` 与 `tyshxydm` 不能同时为空。 ## 4. 请求示例 ``` GET https://open.chineselaw.com/open/rh_enterpriseExecutedPerson?id=027f6725-24ff-4200-bfc4-e7b197f5e66f&pageNo=1 ``` ## 5. 响应说明 ### **5.1 通用返回结构** | 字段名 | 类型 | 说明 | | --------- | ------ | ------------------------- | | `status` | string | `success` / `notFound` 等 | | `code` | number | 成功 200 | | `message` | string | 提示信息 | | `data` | object | 数据结果 | ### 5.2 **`data` 对象说明（概要）** | 字段名 | 类型 | 说明 | | ---------- | -------- | ---------------- | | `id` | string | 企业ID | | `name` | string | 企业名称 | | `total` | number | 总数 | | `pageNo` | number | 当前结果页码 | | `pageSize` | number | 每页结果列表数量 | | `hasMore` | boolean | 是否还有下一页 | | `list` | object[] | 当前结果列表 | ## 6. 响应示例 ```JSON { "code": 200, "data": { "id": "027f6725-24ff-4200-bfc4-e7b197f5e66f", "name": "浙江富茂建设工程有限公司", "total": 7, "pageNo": 1, "pageSize": 50, "hasMore": false, "list": [ { "立案日期": "2025年06月16日", "被执行人": "浙江富茂建设工程有限公司", "执行标的（元）": "71100", "执行状态": "已结案", "案号": "（2025）浙0113执3439号", "执行法院": "杭州市临平区人民法院" }, { "立案日期": "2025年06月16日", "被执行人": "浙江富茂建设工程有限公司", "执行标的（元）": "25217", "执行状态": "已结案", "案号": "（2025）浙0113执3435号", "执行法院": "杭州市临平区人民法院" } ... ] }, "message": "请求成功", "status": "success" } ``` ## 7. 代码示例 ### 7.1 CURL ```shell curl --location --request GET 'https://open.chineselaw.com/open/rh_enterpriseExecutedPerson?id=027f6725-24ff-4200-bfc4-e7b197f5e66f&pageNo=1' \ --header 'X-API-Key: 你的api_key' \ --header 'Accept: application/json' ``` ### 7.2 Python ```python import requests url = "https://open.chineselaw.com/open/rh_enterpriseExecutedPerson" API_KEY = "你的api_key" headers = { "X-API-Key": API_KEY, "Accept": "application/json", } params = { 'id': '027f6725-24ff-4200-bfc4-e7b197f5e66f', 'pageNo': '1', } response = requests.get(url, params=params, headers=headers, timeout=60) response.raise_for_status() print(response.json()) ``` ### 7.3 Java ```java import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.time.Duration; public class EnterpriseExecutedPersonExample { public static void main(String[] args) throws Exception { String apiKey = "你的api_key"; String url = "https://open.chineselaw.com/open/rh_enterpriseExecutedPerson?id=027f6725-24ff-4200-bfc4-e7b197f5e66f&pageNo=1"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create(url)) .timeout(Duration.ofSeconds(60)) .header("X-API-Key", apiKey) .header("Accept", "application/json") .GET() .build(); HttpClient client = HttpClient.newHttpClient(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode()); System.out.println(response.body()); } } ``` ### 7.4 JavaScript ```javascript const API_KEY = "你的api_key"; const url = new URL("https://open.chineselaw.com/open/rh_enterpriseExecutedPerson"); url.searchParams.set('id', '027f6725-24ff-4200-bfc4-e7b197f5e66f'); url.searchParams.set('pageNo', '1'); const res = await fetch(url, { method: "GET", headers: { "X-API-Key": API_KEY, "Accept": "application/json", }, }); if (!res.ok) throw new Error(`HTTP ${res.status}`); console.log(await res.json()); ``` --- ## 企业股权冻结信息列表接口 - Category: 企业信息 - ID: 26 - routeKey: `rh_enterpriseFrozenEquity` - HTTP method: `GET` - Direct endpoint: `https://open.chineselaw.com/open/rh_enterpriseFrozenEquity` - Detail JSON: `https://apiplatform.legalmind.cn/api/apis/26` - MCP tool: `yuandian_rh_enterpriseFrozenEquity` - MCP server: `yuandian-company` at `https://open.chineselaw.com/mcp/company/stream` - Price: 5 POINT/call; chargeType=1 Description: 根据企业ID或统一社会信用代码查询企业股权冻结列表，分页查询，每页默认30条。 ### Direct API Authentication ```http X-API-Key: YOUR_API_KEY Accept: application/json ``` ### MCP Authentication ```http Accept: application/json, text/event-stream Authorization: Bearer YOUR_API_KEY ``` ### Full Document # 企业股权冻结信息列表接口 ## 1. 基本信息 - **接口名称**：企业股权冻结信息列表接口 - **接口用途**：根据企业ID或统一社会信用代码查询企业股权冻结列表，分页查询，每页默认30条。 ## 2. 请求信息 - **HTTP Method**：GET - **URL**：`https://open.chineselaw.com/open/rh_enterpriseFrozenEquity` ## 3. 请求参数（Query） | 参数名 | 类型 | 是否必填 | 说明 | | ---------- | ------ | -------- | ---------------- | | `id` | string | 否 | 企业ID | | `tyshxydm` | string | 否 | 统一社会信用代码 | | `pageNo` | int | 否 | 页码，默认1 | > `id` 与 `tyshxydm` 不能同时为空。 ## 4. 请求示例 ``` GET https://open.chineselaw.com/open/rh_enterpriseFrozenEquity?id=051f2aad-809c-4f1b-9122-72164f957fb9&pageNo=1 ``` ## 5. 响应说明 ### **5.1 通用返回结构** | 字段名 | 类型 | 说明 | | --------- | ------ | ------------------------- | | `status` | string | `success` / `notFound` 等 | | `code` | number | 成功 200 | | `message` | string | 提示信息 | | `data` | object | 数据结果 | ### 5.2 **`data` 对象说明（概要）** | 字段名 | 类型 | 说明 | | ---------- | -------- | ---------------- | | `id` | string | 企业ID | | `name` | string | 企业名称 | | `total` | number | 总数 | | `pageNo` | number | 当前结果页码 | | `pageSize` | number | 每页结果列表数量 | | `hasMore` | boolean | 是否还有下一页 | | `list` | object[] | 当前结果列表 | ## 6. 响应示例 ```JSON { "code": 200, "data": { "id": "051f2aad-809c-4f1b-9122-72164f957fb9", "name": "易如优汽车服务（佛山）有限公司", "total": 1, "pageNo": 1, "pageSize": 50, "hasMore": false, "list": [ { "被执行人": "", "执行法院": "广东省佛山市禅城区人民法院", "执行裁定文书号": "（2022）粤0604执12169号", "执行通知书文号": "（2022）粤0604执12169号", "执行事项": "陈光挺持有的易如优汽车服务（佛山）有限公司51%股权份额（认缴出资额510000元）", "股权数额": "51万", "类型": "股权冻结", "状态": "股权冻结|冻结", "冻结开始时间": "2022年09月27日", "冻结结束时间": "2025年09月26日", "冻结期限": "1095天" } ] }, "message": "请求成功", "status": "success" } ``` ## 7. 代码示例 ### 7.1 CURL ```shell curl --location --request GET 'https://open.chineselaw.com/open/rh_enterpriseFrozenEquity?id=051f2aad-809c-4f1b-9122-72164f957fb9&pageNo=1' \ --header 'X-API-Key: 你的api_key' \ --header 'Accept: application/json' ``` ### 7.2 Python ```python import requests url = "https://open.chineselaw.com/open/rh_enterpriseFrozenEquity" API_KEY = "你的api_key" headers = { "X-API-Key": API_KEY, "Accept": "application/json", } params = { 'id': '051f2aad-809c-4f1b-9122-72164f957fb9', 'pageNo': '1', } response = requests.get(url, params=params, headers=headers, timeout=60) response.raise_for_status() print(response.json()) ``` ### 7.3 Java ```java import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.time.Duration; public class EnterpriseFrozenEquityExample { public static void main(String[] args) throws Exception { String apiKey = "你的api_key"; String url = "https://open.chineselaw.com/open/rh_enterpriseFrozenEquity?id=051f2aad-809c-4f1b-9122-72164f957fb9&pageNo=1"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create(url)) .timeout(Duration.ofSeconds(60)) .header("X-API-Key", apiKey) .header("Accept", "application/json") .GET() .build(); HttpClient client = HttpClient.newHttpClient(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode()); System.out.println(response.body()); } } ``` ### 7.4 JavaScript ```javascript const API_KEY = "你的api_key"; const url = new URL("https://open.chineselaw.com/open/rh_enterpriseFrozenEquity"); url.searchParams.set('id', '051f2aad-809c-4f1b-9122-72164f957fb9'); url.searchParams.set('pageNo', '1'); const res = await fetch(url, { method: "GET", headers: { "X-API-Key": API_KEY, "Accept": "application/json", }, }); if (!res.ok) throw new Error(`HTTP ${res.status}`); console.log(await res.json()); ``` --- ## 企业行政处罚信息列表接口 - Category: 企业信息 - ID: 25 - routeKey: `rh_enterprisePunishment` - HTTP method: `GET` - Direct endpoint: `https://open.chineselaw.com/open/rh_enterprisePunishment` - Detail JSON: `https://apiplatform.legalmind.cn/api/apis/25` - MCP tool: `yuandian_rh_enterprisePunishment` - MCP server: `yuandian-company` at `https://open.chineselaw.com/mcp/company/stream` - Price: 5 POINT/call; chargeType=1 Description: 根据企业ID或统一社会信用代码查询企业行政处罚列表，分页查询，每页默认30条。 ### Direct API Authentication ```http X-API-Key: YOUR_API_KEY Accept: application/json ``` ### MCP Authentication ```http Accept: application/json, text/event-stream Authorization: Bearer YOUR_API_KEY ``` ### Full Document # 企业行政处罚信息列表接口 ## 1. 基本信息 - **接口名称**：企业行政处罚信息列表接口 - **接口用途**：根据企业ID或统一社会信用代码查询企业行政处罚列表，分页查询，每页默认30条。 ## 2. 请求信息 - **HTTP Method**：GET - **URL**：`https://open.chineselaw.com/open/rh_enterprisePunishment` ## 3. 请求参数（Query） | 参数名 | 类型 | 是否必填 | 说明 | | ---------- | ------ | -------- | ---------------- | | `id` | string | 否 | 企业ID | | `tyshxydm` | string | 否 | 统一社会信用代码 | | `pageNo` | int | 否 | 页码，默认1 | > `id` 与 `tyshxydm` 不能同时为空。 ## 4. 请求示例 ``` GET https://open.chineselaw.com/open/rh_enterprisePunishment?id=40bc5788-881d-11ef-8e2b-5254000c39cb&pageNo=1 ``` ## 5. 响应说明 ### **5.1 通用返回结构** | 字段名 | 类型 | 说明 | | --------- | ------ | ------------------------- | | `status` | string | `success` / `notFound` 等 | | `code` | number | 成功 200 | | `message` | string | 提示信息 | | `data` | object | 数据结果 | ### 5.2 **`data` 对象说明（概要）** | 字段名 | 类型 | 说明 | | ---------- | -------- | ---------------- | | `id` | string | 企业ID | | `name` | string | 企业名称 | | `total` | number | 总数 | | `pageNo` | number | 当前结果页码 | | `pageSize` | number | 每页结果列表数量 | | `hasMore` | boolean | 是否还有下一页 | | `list` | object[] | 当前结果列表 | ## 6. 响应示例 ```JSON { "code": 200, "data": { "id": "40bc5788-881d-11ef-8e2b-5254000c39cb", "name": "张家港市辰驰贸易有限公司", "total": 1, "pageNo": 1, "pageSize": 50, "hasMore": false, "list": [ { "处罚日期": "2025年09月17日", "处罚事由": "经查,当事人于2025年7月25日从台铃科技股份有限公司购进涉案电动自行车,据当事人所述,上述13个型号的电动自行车购进时鞍座样式与合格证一致。因消费者存在长鞍座电动自行车的购买需求,当事人为了便于销售,自行从网上采购加长鞍座及配件,并对涉案电动自行车进行改装,拆除原有的短鞍座,并将加长鞍座及配件安装至电动自行车原鞍座位置。当事人未留存加长鞍座及配件的采购票据。2025年8月5日,本局执法人员对当事人位于张家港市杨舍镇东南大道勤星路2号百信物流园1号楼PB-5的仓库进行现场检查,现场查见303辆电动自行车(共13个型号),经现场比对电动自行车产品合格证外观简图,上述303辆电动自行车的鞍座与合格证不一致。现场对上述303辆电动自行车的车架号和车身标签进行拍照取证,对各型号的电动自行车外观进行拍照取证并测量其鞍座长度,经测量,鞍座长度均超过350mm。各型号电动自行车名称、数量见下表:序号产品名称产品型号数量(辆)1超能S?赤兔2025EBK12E版TDT7S101Z252小锐鹰优享KQ12E版TDT7S005Z73菲畅EB超能KQ12E版TDT7S013Z384优骏2025EB超能KQ12E版TDT7S104Z565超能S?封神EBKQ12E版TDT7S097Z36超能6?蝴蝶EBKQ12E版TDT7S076Z77优骏EB超能KQ12E版KS新TDT7S006Z18优享2.0EB超能KQ12E版TDT7S003Z49超能6?繁花EBKQ12E版TDT7S063Z2010超能6?明星EBKQ12E版TDT7S021-1Z911狂飙侠超能KL24E版TDT749-1Z112妙恋EB优享KQ12C版TDT7S016Z4013星河2025EB优跑KQ12E版TDT7S117Z92总计3032025年8月14日,本局执法人员对当事人位于张家港市杨舍镇乘航西路106室的经营场所开展现场检查,现场查见当事人经营场所内有电动自行车待售,现场比对电动自行车合格证,合格证外观简图与电动自行车外观一致。当事人采用进货价格(空车)加电池价格加利润幅度的方式确定销售定价,其中,狂飙侠超能KL24E版(产品型号TDT749-1Z)使用的是锂电池(电池型号DZ48N-24EM),每辆电动自行车配有1组锂电池;其余12个型号的电动自行车电池均为铅酸电池(电池型号6DZF-12),每辆电动自行车配有4块该铅酸电池。因当事人改装的电动自行车尚未销售,303辆电动自行车的货值总计334850元,无违法所得。案发后当事人积极整改违法行为,将上述303辆电动自行车退回厂家并恢复与合格证一致。经查询江苏省市场监督数智化平台综合执法系统3.0,当事人未受到过我局的行政处罚。", "决定文书号": "张市监处罚（2025）X00084号", "决定机关": "张家港市市场监督管理局", "处罚行为类型": "生产、销售不符合保障人体健康和人身、财产安全的国家标准、行业标准的产品行为", "处罚内容": "综上,当事人上述行为违法了《中华人民共和国产品质量法》第二十六条第二款第(一)项的规定,依据《中华人民共和国产品质量法》第四十九条的规定,结合自由裁量权,决定对当事人作出如下行政处罚:1.罚款100455元。", "处罚依据": "《中华人民共和国产品质量法》第四十九条、第六十条《江苏省惩治生产销售假冒伪劣商品行为条例》第十九条第一款《江苏省惩治生产销售假冒伪劣商品行为条例》第二十五条" } ] }, "message": "请求成功", "status": "success" } ``` ## 7. 代码示例 ### 7.1 CURL ```shell curl --location --request GET 'https://open.chineselaw.com/open/rh_enterprisePunishment?id=40bc5788-881d-11ef-8e2b-5254000c39cb&pageNo=1' \ --header 'X-API-Key: 你的api_key' \ --header 'Accept: application/json' ``` ### 7.2 Python ```python import requests url = "https://open.chineselaw.com/open/rh_enterprisePunishment" API_KEY = "你的api_key" headers = { "X-API-Key": API_KEY, "Accept": "application/json", } params = { 'id': '40bc5788-881d-11ef-8e2b-5254000c39cb', 'pageNo': '1', } response = requests.get(url, params=params, headers=headers, timeout=60) response.raise_for_status() print(response.json()) ``` ### 7.3 Java ```java import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.time.Duration; public class EnterprisePunishmentExample { public static void main(String[] args) throws Exception { String apiKey = "你的api_key"; String url = "https://open.chineselaw.com/open/rh_enterprisePunishment?id=40bc5788-881d-11ef-8e2b-5254000c39cb&pageNo=1"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create(url)) .timeout(Duration.ofSeconds(60)) .header("X-API-Key", apiKey) .header("Accept", "application/json") .GET() .build(); HttpClient client = HttpClient.newHttpClient(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode()); System.out.println(response.body()); } } ``` ### 7.4 JavaScript ```javascript const API_KEY = "你的api_key"; const url = new URL("https://open.chineselaw.com/open/rh_enterprisePunishment"); url.searchParams.set('id', '40bc5788-881d-11ef-8e2b-5254000c39cb'); url.searchParams.set('pageNo', '1'); const res = await fetch(url, { method: "GET", headers: { "X-API-Key": API_KEY, "Accept": "application/json", }, }); if (!res.ok) throw new Error(`HTTP ${res.status}`); console.log(await res.json()); ``` --- ## 企业股权出质信息列表接口 - Category: 企业信息 - ID: 24 - routeKey: `rh_enterprisePledge` - HTTP method: `GET` - Direct endpoint: `https://open.chineselaw.com/open/rh_enterprisePledge` - Detail JSON: `https://apiplatform.legalmind.cn/api/apis/24` - MCP tool: `yuandian_rh_enterprisePledge` - MCP server: `yuandian-company` at `https://open.chineselaw.com/mcp/company/stream` - Price: 5 POINT/call; chargeType=1 Description: 根据企业ID或统一社会信用代码查询企业股权出质列表，分页查询，每页默认30条。 ### Direct API Authentication ```http X-API-Key: YOUR_API_KEY Accept: application/json ``` ### MCP Authentication ```http Accept: application/json, text/event-stream Authorization: Bearer YOUR_API_KEY ``` ### Full Document # 企业股权出质信息列表接口 ## 1. 基本信息 - **接口名称**：企业股权出质信息列表接口 - **接口用途**：根据企业ID或统一社会信用代码查询企业股权出质列表，分页查询，每页默认30条。 ## 2. 请求信息 - **HTTP Method**：GET - **URL**：`https://open.chineselaw.com/open/rh_enterprisePledge` ## 3. 请求参数（Query） | 参数名 | 类型 | 是否必填 | 说明 | | ---------- | ------ | -------- | ---------------- | | `id` | string | 否 | 企业ID | | `tyshxydm` | string | 否 | 统一社会信用代码 | | `pageNo` | int | 否 | 页码，默认1 | > `id` 与 `tyshxydm` 不能同时为空。 ## 4. 请求示例 ``` GET https://open.chineselaw.com/open/rh_enterprisePledge?id=240aea9b-7a97-4704-8d42-8ca91a071756&pageNo=1 ``` ## 5. 响应说明 ### **5.1 通用返回结构** | 字段名 | 类型 | 说明 | | --------- | ------ | ------------------------- | | `status` | string | `success` / `notFound` 等 | | `code` | number | 成功 200 | | `message` | string | 提示信息 | | `data` | object | 数据结果 | ### 5.2 **`data` 对象说明（概要）** | 字段名 | 类型 | 说明 | | ---------- | -------- | ---------------- | | `id` | string | 企业ID | | `name` | string | 企业名称 | | `total` | number | 总数 | | `pageNo` | number | 当前结果页码 | | `pageSize` | number | 每页结果列表数量 | | `hasMore` | boolean | 是否还有下一页 | | `list` | object[] | 当前结果列表 | ## 6. 响应示例 ```JSON { "code": 200, "data": { "id": "240aea9b-7a97-4704-8d42-8ca91a071756", "name": "北京凯奥斯科技有限公司", "total": 3, "pageNo": 1, "pageSize": 50, "hasMore": false, "list": [ { "登记日": "2021年12月27日", "登记编号": "91110105MA04D5XU0J_0001", "状态": "有效", "出质股权数额": "7.9", "出质人": "吕博森", "质权人": "北京英飞特斯科技有限公司", "标的方": "北京凯奥斯科技有限公司" } ] }, "message": "请求成功", "status": "success" } ``` ## 7. 代码示例 ### 7.1 CURL ```shell curl --location --request GET 'https://open.chineselaw.com/open/rh_enterprisePledge?id=240aea9b-7a97-4704-8d42-8ca91a071756&pageNo=1' \ --header 'X-API-Key: 你的api_key' \ --header 'Accept: application/json' ``` ### 7.2 Python ```python import requests url = "https://open.chineselaw.com/open/rh_enterprisePledge" API_KEY = "你的api_key" headers = { "X-API-Key": API_KEY, "Accept": "application/json", } params = { 'id': '240aea9b-7a97-4704-8d42-8ca91a071756', 'pageNo': '1', } response = requests.get(url, params=params, headers=headers, timeout=60) response.raise_for_status() print(response.json()) ``` ### 7.3 Java ```java import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.time.Duration; public class EnterprisePledgeExample { public static void main(String[] args) throws Exception { String apiKey = "你的api_key"; String url = "https://open.chineselaw.com/open/rh_enterprisePledge?id=240aea9b-7a97-4704-8d42-8ca91a071756&pageNo=1"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create(url)) .timeout(Duration.ofSeconds(60)) .header("X-API-Key", apiKey) .header("Accept", "application/json") .GET() .build(); HttpClient client = HttpClient.newHttpClient(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode()); System.out.println(response.body()); } } ``` ### 7.4 JavaScript ```javascript const API_KEY = "你的api_key"; const url = new URL("https://open.chineselaw.com/open/rh_enterprisePledge"); url.searchParams.set('id', '240aea9b-7a97-4704-8d42-8ca91a071756'); url.searchParams.set('pageNo', '1'); const res = await fetch(url, { method: "GET", headers: { "X-API-Key": API_KEY, "Accept": "application/json", }, }); if (!res.ok) throw new Error(`HTTP ${res.status}`); console.log(await res.json()); ``` --- ## 企业对外担保信息列表接口 - Category: 企业信息 - ID: 23 - routeKey: `rh_enterpriseGuaranty` - HTTP method: `GET` - Direct endpoint: `https://open.chineselaw.com/open/rh_enterpriseGuaranty` - Detail JSON: `https://apiplatform.legalmind.cn/api/apis/23` - MCP tool: `yuandian_rh_enterpriseGuaranty` - MCP server: `yuandian-company` at `https://open.chineselaw.com/mcp/company/stream` - Price: 5 POINT/call; chargeType=1 Description: 根据企业ID或统一社会信用代码查询企业对外担保列表，分页查询，每页默认30条。 ### Direct API Authentication ```http X-API-Key: YOUR_API_KEY Accept: application/json ``` ### MCP Authentication ```http Accept: application/json, text/event-stream Authorization: Bearer YOUR_API_KEY ``` ### Full Document # 企业对外担保信息列表接口 ## 1. 基本信息 - **接口名称**：企业对外担保信息列表接口 - **接口用途**：根据企业ID或统一社会信用代码查询企业对外担保列表，分页查询，每页默认30条。 ## 2. 请求信息 - **HTTP Method**：GET - **URL**：`https://open.chineselaw.com/open/rh_enterpriseGuaranty` ## 3. 请求参数（Query） | 参数名 | 类型 | 是否必填 | 说明 | | ---------- | ------ | -------- | ---------------- | | `id` | string | 否 | 企业ID | | `tyshxydm` | string | 否 | 统一社会信用代码 | | `pageNo` | int | 否 | 页码，默认1 | > `id` 与 `tyshxydm` 不能同时为空。 ## 4. 请求示例 ``` GET https://open.chineselaw.com/open/rh_enterpriseGuaranty?id=248cb8be-a94d-422b-a8b7-9e02e5b1217f&pageNo=1 ``` ## 5. 响应说明 ### **5.1 通用返回结构** | 字段名 | 类型 | 说明 | | --------- | ------ | ------------------------- | | `status` | string | `success` / `notFound` 等 | | `code` | number | 成功 200 | | `message` | string | 提示信息 | | `data` | object | 数据结果 | ### 5.2 **`data` 对象说明（概要）** | 字段名 | 类型 | 说明 | | ---------- | -------- | ---------------- | | `id` | string | 企业ID | | `name` | string | 企业名称 | | `total` | number | 总数 | | `pageNo` | number | 当前结果页码 | | `pageSize` | number | 每页结果列表数量 | | `hasMore` | boolean | 是否还有下一页 | | `list` | object[] | 当前结果列表 | ## 6. 响应示例 ```JSON { "code": 200, "data": { "id": "248cb8be-a94d-422b-a8b7-9e02e5b1217f", "name": "宿州市鑫艺辉装饰工程有限公司", "total": 1, "pageNo": 1, "pageSize": 50, "hasMore": false, "list": [ { "债权人": "王辉", "债务人": "王辉", "主债权种类": "其他", "主债权数额": "100万元", "履行债务的期限": "2016年03月09日-2016年03月26日", "保证的日期": "未约定", "保证的方式": "一般保证", "保证担保的范围": "" } ] }, "message": "请求成功", "status": "success" } ``` ## 7. 代码示例 ### 7.1 CURL ```shell curl --location --request GET 'https://open.chineselaw.com/open/rh_enterpriseGuaranty?id=248cb8be-a94d-422b-a8b7-9e02e5b1217f&pageNo=1' \ --header 'X-API-Key: 你的api_key' \ --header 'Accept: application/json' ``` ### 7.2 Python ```python import requests url = "https://open.chineselaw.com/open/rh_enterpriseGuaranty" API_KEY = "你的api_key" headers = { "X-API-Key": API_KEY, "Accept": "application/json", } params = { 'id': '248cb8be-a94d-422b-a8b7-9e02e5b1217f', 'pageNo': '1', } response = requests.get(url, params=params, headers=headers, timeout=60) response.raise_for_status() print(response.json()) ``` ### 7.3 Java ```java import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.time.Duration; public class EnterpriseGuarantyExample { public static void main(String[] args) throws Exception { String apiKey = "你的api_key"; String url = "https://open.chineselaw.com/open/rh_enterpriseGuaranty?id=248cb8be-a94d-422b-a8b7-9e02e5b1217f&pageNo=1"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create(url)) .timeout(Duration.ofSeconds(60)) .header("X-API-Key", apiKey) .header("Accept", "application/json") .GET() .build(); HttpClient client = HttpClient.newHttpClient(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode()); System.out.println(response.body()); } } ``` ### 7.4 JavaScript ```javascript const API_KEY = "你的api_key"; const url = new URL("https://open.chineselaw.com/open/rh_enterpriseGuaranty"); url.searchParams.set('id', '248cb8be-a94d-422b-a8b7-9e02e5b1217f'); url.searchParams.set('pageNo', '1'); const res = await fetch(url, { method: "GET", headers: { "X-API-Key": API_KEY, "Accept": "application/json", }, }); if (!res.ok) throw new Error(`HTTP ${res.status}`); console.log(await res.json()); ``` --- ## 企业经营异常记录列表接口 - Category: 企业信息 - ID: 22 - routeKey: `rh_enterpriseAbnormalOperation` - HTTP method: `GET` - Direct endpoint: `https://open.chineselaw.com/open/rh_enterpriseAbnormalOperation` - Detail JSON: `https://apiplatform.legalmind.cn/api/apis/22` - MCP tool: `yuandian_rh_enterpriseAbnormalOperation` - MCP server: `yuandian-company` at `https://open.chineselaw.com/mcp/company/stream` - Price: 5 POINT/call; chargeType=1 Description: 根据企业ID或统一社会信用代码查询企业经营异常列表，分页查询，每页默认30条。 ### Direct API Authentication ```http X-API-Key: YOUR_API_KEY Accept: application/json ``` ### MCP Authentication ```http Accept: application/json, text/event-stream Authorization: Bearer YOUR_API_KEY ``` ### Full Document # 企业经营异常记录列表接口 ## 1. 基本信息 - **接口名称**：企业经营异常记录列表接口 - **接口用途**：根据企业ID或统一社会信用代码查询企业经营异常列表，分页查询，每页默认30条。 ## 2. 请求信息 - **HTTP Method**：GET - **URL**：`https://open.chineselaw.com/open/rh_enterpriseAbnormalOperation` ## 3. 请求参数（Query） | 参数名 | 类型 | 是否必填 | 说明 | | ---------- | ------ | -------- | ---------------- | | `id` | string | 否 | 企业ID | | `tyshxydm` | string | 否 | 统一社会信用代码 | | `pageNo` | int | 否 | 页码，默认1 | > `id` 与 `tyshxydm` 不能同时为空。 ## 4. 请求示例 ``` GET https://open.chineselaw.com/open/rh_enterpriseAbnormalOperation?id=37a3747f-1ef4-4b36-81ba-5de44d63db1f&pageNo=1 ``` ## 5. 响应说明 ### **5.1 通用返回结构** | 字段名 | 类型 | 说明 | | --------- | ------ | ------------------------- | | `status` | string | `success` / `notFound` 等 | | `code` | number | 成功 200 | | `message` | string | 提示信息 | | `data` | object | 数据结果 | ### 5.2 **`data` 对象说明（概要）** | 字段名 | 类型 | 说明 | | ---------- | -------- | ---------------- | | `id` | string | 企业ID | | `name` | string | 企业名称 | | `total` | number | 总数 | | `pageNo` | number | 当前结果页码 | | `pageSize` | number | 每页结果列表数量 | | `hasMore` | boolean | 是否还有下一页 | | `list` | object[] | 当前结果列表 | ## 6. 响应示例 ```JSON { "code": 200, "data": { "id": "37a3747f-1ef4-4b36-81ba-5de44d63db1f", "name": "济南宏盛永物业管理有限公司", "total": 1, "pageNo": 1, "pageSize": 50, "hasMore": false, "list": [ { "列入日期": "2023年02月13日", "列入经营异常名录原因": "公示企业信息隐瞒真实情况、弄虚作假的", "做出列入决定机关": "济南市历下区市场监督管理局", "移除日期": "2023年02月17日", "移除经营异常名录原因": "列入经营异常名录3年内且依照《经营异常名录管理办法》第八条规定被列入经营异常名录的企业更正其公示的信息后，申请移出", "做出移出决定机关": "济南市历下区市场监督管理局" } ] }, "message": "请求成功", "status": "success" } ``` ## 7. 代码示例 ### 7.1 CURL ```shell curl --location --request GET 'https://open.chineselaw.com/open/rh_enterpriseAbnormalOperation?id=37a3747f-1ef4-4b36-81ba-5de44d63db1f&pageNo=1' \ --header 'X-API-Key: 你的api_key' \ --header 'Accept: application/json' ``` ### 7.2 Python ```python import requests url = "https://open.chineselaw.com/open/rh_enterpriseAbnormalOperation" API_KEY = "你的api_key" headers = { "X-API-Key": API_KEY, "Accept": "application/json", } params = { 'id': '37a3747f-1ef4-4b36-81ba-5de44d63db1f', 'pageNo': '1', } response = requests.get(url, params=params, headers=headers, timeout=60) response.raise_for_status() print(response.json()) ``` ### 7.3 Java ```java import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.time.Duration; public class EnterpriseAbnormalOperationExample { public static void main(String[] args) throws Exception { String apiKey = "你的api_key"; String url = "https://open.chineselaw.com/open/rh_enterpriseAbnormalOperation?id=37a3747f-1ef4-4b36-81ba-5de44d63db1f&pageNo=1"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create(url)) .timeout(Duration.ofSeconds(60)) .header("X-API-Key", apiKey) .header("Accept", "application/json") .GET() .build(); HttpClient client = HttpClient.newHttpClient(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode()); System.out.println(response.body()); } } ``` ### 7.4 JavaScript ```javascript const API_KEY = "你的api_key"; const url = new URL("https://open.chineselaw.com/open/rh_enterpriseAbnormalOperation"); url.searchParams.set('id', '37a3747f-1ef4-4b36-81ba-5de44d63db1f'); url.searchParams.set('pageNo', '1'); const res = await fetch(url, { method: "GET", headers: { "X-API-Key": API_KEY, "Accept": "application/json", }, }); if (!res.ok) throw new Error(`HTTP ${res.status}`); console.log(await res.json()); ``` --- ## 企业欠税公告记录列表接口 - Category: 企业信息 - ID: 21 - routeKey: `rh_enterpriseCorporateTax` - HTTP method: `GET` - Direct endpoint: `https://open.chineselaw.com/open/rh_enterpriseCorporateTax` - Detail JSON: `https://apiplatform.legalmind.cn/api/apis/21` - MCP tool: `yuandian_rh_enterpriseCorporateTax` - MCP server: `yuandian-company` at `https://open.chineselaw.com/mcp/company/stream` - Price: 5 POINT/call; chargeType=1 Description: 根据企业ID或统一社会信用代码查询企业欠税公告列表，分页查询，每页默认30条。 ### Direct API Authentication ```http X-API-Key: YOUR_API_KEY Accept: application/json ``` ### MCP Authentication ```http Accept: application/json, text/event-stream Authorization: Bearer YOUR_API_KEY ``` ### Full Document # 企业欠税公告记录列表接口 ## 1. 基本信息 - **接口名称**：企业欠税公告记录列表接口 - **接口用途**：根据企业ID或统一社会信用代码查询企业欠税公告列表，分页查询，每页默认30条。 ## 2. 请求信息 - **HTTP Method**：GET - **URL**：`https://open.chineselaw.com/open/rh_enterpriseCorporateTax` ## 3. 请求参数（Query） | 参数名 | 类型 | 是否必填 | 说明 | | ---------- | ------ | -------- | ---------------- | | `id` | string | 否 | 企业ID | | `tyshxydm` | string | 否 | 统一社会信用代码 | | `pageNo` | int | 否 | 页码，默认1 | > `id` 与 `tyshxydm` 不能同时为空。 ## 4. 请求示例 ``` GET https://open.chineselaw.com/open/rh_enterpriseCorporateTax?id=e8f94bf6-c717-4a83-8300-abc581163690&pageNo=1 ``` ## 5. 响应说明 ### **5.1 通用返回结构** | 字段名 | 类型 | 说明 | | --------- | ------ | ------------------------- | | `status` | string | `success` / `notFound` 等 | | `code` | number | 成功 200 | | `message` | string | 提示信息 | | `data` | object | 数据结果 | ### 5.2 **`data` 对象说明（概要）** | 字段名 | 类型 | 说明 | | ---------- | -------- | ---------------- | | `id` | string | 企业ID | | `name` | string | 企业名称 | | `total` | number | 总数 | | `pageNo` | number | 当前结果页码 | | `pageSize` | number | 每页结果列表数量 | | `hasMore` | boolean | 是否还有下一页 | | `list` | object[] | 当前结果列表 | ## 6. 响应示例 ```JSON { "code": 200, "data": { "id": "e8f94bf6-c717-4a83-8300-abc581163690", "name": "江苏尚德精密机械有限公司", "total": 1, "pageNo": 1, "pageSize": 50, "hasMore": false, "list": [ { "纳税人名称": "江苏尚德精密机械有限公司", "纳税人识别号": "91321102MA1Q2A0N90", "经营地点": "镇江市京口区禹山北路303号", "欠税税种": "城市维护建设税", "欠税余额": "17.33", "发布单位": "镇江市税务局" } ] }, "message": "请求成功", "status": "success" } ``` ## 7. 代码示例 ### 7.1 CURL ```shell curl --location --request GET 'https://open.chineselaw.com/open/rh_enterpriseCorporateTax?id=e8f94bf6-c717-4a83-8300-abc581163690&pageNo=1' \ --header 'X-API-Key: 你的api_key' \ --header 'Accept: application/json' ``` ### 7.2 Python ```python import requests url = "https://open.chineselaw.com/open/rh_enterpriseCorporateTax" API_KEY = "你的api_key" headers = { "X-API-Key": API_KEY, "Accept": "application/json", } params = { 'id': 'e8f94bf6-c717-4a83-8300-abc581163690', 'pageNo': '1', } response = requests.get(url, params=params, headers=headers, timeout=60) response.raise_for_status() print(response.json()) ``` ### 7.3 Java ```java import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.time.Duration; public class EnterpriseCorporateTaxExample { public static void main(String[] args) throws Exception { String apiKey = "你的api_key"; String url = "https://open.chineselaw.com/open/rh_enterpriseCorporateTax?id=e8f94bf6-c717-4a83-8300-abc581163690&pageNo=1"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create(url)) .timeout(Duration.ofSeconds(60)) .header("X-API-Key", apiKey) .header("Accept", "application/json") .GET() .build(); HttpClient client = HttpClient.newHttpClient(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode()); System.out.println(response.body()); } } ``` ### 7.4 JavaScript ```javascript const API_KEY = "你的api_key"; const url = new URL("https://open.chineselaw.com/open/rh_enterpriseCorporateTax"); url.searchParams.set('id', 'e8f94bf6-c717-4a83-8300-abc581163690'); url.searchParams.set('pageNo', '1'); const res = await fetch(url, { method: "GET", headers: { "X-API-Key": API_KEY, "Accept": "application/json", }, }); if (!res.ok) throw new Error(`HTTP ${res.status}`); console.log(await res.json()); ``` --- ## 企业严重违法记录列表接口 - Category: 企业信息 - ID: 20 - routeKey: `rh_enterpriseSeriousIllegal` - HTTP method: `GET` - Direct endpoint: `https://open.chineselaw.com/open/rh_enterpriseSeriousIllegal` - Detail JSON: `https://apiplatform.legalmind.cn/api/apis/20` - MCP tool: `yuandian_rh_enterpriseSeriousIllegal` - MCP server: `yuandian-company` at `https://open.chineselaw.com/mcp/company/stream` - Price: 5 POINT/call; chargeType=1 Description: 根据企业ID或统一社会信用代码查询企业严重违法列表 ### Direct API Authentication ```http X-API-Key: YOUR_API_KEY Accept: application/json ``` ### MCP Authentication ```http Accept: application/json, text/event-stream Authorization: Bearer YOUR_API_KEY ``` ### Full Document # 企业严重违法记录列表接口 ## 1. 基本信息 - **接口名称**：企业严重违法记录列表接口 - **接口用途**：根据企业ID或统一社会信用代码查询企业严重违法列表，分页查询，每页默认30条。 ## 2. 请求信息 - **HTTP Method**：GET - **URL**：`https://open.chineselaw.com/open/rh_enterpriseSeriousIllegal` ## 3. 请求参数（Query） | 参数名 | 类型 | 是否必填 | 说明 | | ---------- | ------ | -------- | ---------------- | | `id` | string | 否 | 企业ID | | `tyshxydm` | string | 否 | 统一社会信用代码 | | `pageNo` | int | 否 | 页码，默认1 | > `id` 与 `tyshxydm` 不能同时为空。 ## 4. 请求示例 ``` GET https://open.chineselaw.com/open/rh_enterpriseSeriousIllegal?id=553a5442-eaf2-4bde-99e2-99ecf7f841bb&pageNo=1 ``` ## 5. 响应说明 ### **5.1 通用返回结构** | 字段名 | 类型 | 说明 | | --------- | ------ | ------------------------- | | `status` | string | `success` / `notFound` 等 | | `code` | number | 成功 200 | | `message` | string | 提示信息 | | `data` | object | 数据结果 | ### 5.2 **`data` 对象说明（概要）** | 字段名 | 类型 | 说明 | | ---------- | -------- | ---------------- | | `id` | string | 企业ID | | `name` | string | 企业名称 | | `total` | number | 总数 | | `pageNo` | number | 当前结果页码 | | `pageSize` | number | 每页结果列表数量 | | `hasMore` | boolean | 是否还有下一页 | | `list` | object[] | 当前结果列表 | ## 6. 响应示例 ```shell curl --location --request GET 'https://open.chineselaw.com/open/rh_enterpriseSeriousIllegal?id=553a5442-eaf2-4bde-99e2-99ecf7f841bb&pageNo=1' \ --header 'X-API-Key: 你的api_key' \ --header 'Accept: application/json' ``` ## 7. 代码示例 ### 7.1 CURL ```shell curl --location --request POST 'https://open.chineselaw.com/open/rh_enterpriseSeriousIllegal' \ --header 'X-API-Key: 你的api_key' \ --header 'Content-Type: application/json; charset=utf-8' \ --header 'Accept: application/json' \ --data-raw '{"query":"入户盗窃","rewrite_flag":false,"wenshu_filter":{"wszl":["1"],"ja_start":"2015-01-01","ja_end":"2025-01-01","wenshu_type":"刑事案件","fayuan":["北京市第一中级人民法院"],"cj":"中级","xzqh_p":"北京","dianxing":false},"return_num":2}' ``` ### 7.2 Python ```python import requests url = "https://open.chineselaw.com/open/rh_enterpriseSeriousIllegal" API_KEY = "你的api_key" headers = { "X-API-Key": API_KEY, "Accept": "application/json", } params = { 'id': '553a5442-eaf2-4bde-99e2-99ecf7f841bb', 'pageNo': '1', } response = requests.get(url, params=params, headers=headers, timeout=60) response.raise_for_status() print(response.json()) ``` ### 7.3 Java ```java import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.time.Duration; public class EnterpriseSeriousIllegalExample { public static void main(String[] args) throws Exception { String apiKey = "你的api_key"; String url = "https://open.chineselaw.com/open/rh_enterpriseSeriousIllegal?id=553a5442-eaf2-4bde-99e2-99ecf7f841bb&pageNo=1"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create(url)) .timeout(Duration.ofSeconds(60)) .header("X-API-Key", apiKey) .header("Accept", "application/json") .GET() .build(); HttpClient client = HttpClient.newHttpClient(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode()); System.out.println(response.body()); } } ``` ### 7.4 JavaScript ```javascript const API_KEY = "你的api_key"; const url = new URL("https://open.chineselaw.com/open/rh_enterpriseSeriousIllegal"); url.searchParams.set('id', '553a5442-eaf2-4bde-99e2-99ecf7f841bb'); url.searchParams.set('pageNo', '1'); const res = await fetch(url, { method: "GET", headers: { "X-API-Key": API_KEY, "Accept": "application/json", }, }); if (!res.ok) throw new Error(`HTTP ${res.status}`); console.log(await res.json()); ``` --- ## 法律法规语义检索接口 - Category: 法律法规 - ID: 17 - routeKey: `law_vector_search` - HTTP method: `POST` - Direct endpoint: `https://open.chineselaw.com/open/law_vector_search` - Detail JSON: `https://apiplatform.legalmind.cn/api/apis/17` - MCP tool: `yuandian_law_vector_search` - MCP server: `yuandian-law` at `https://open.chineselaw.com/mcp/law/stream` - Price: 10 POINT/call; chargeType=1 Description: 对法律法规进行语义检索，支持传入各类筛选项，返回语义相关的法律法规列表。 ### Direct API Authentication ```http X-API-Key: YOUR_API_KEY Accept: application/json Content-Type: application/json; charset=utf-8 ``` ### MCP Authentication ```http Accept: application/json, text/event-stream Authorization: Bearer YOUR_API_KEY ``` ### Full Document ## **1. 基本信息** \- **接口名称**：法律法规语义检索接口 \- **接口用途**：对法律法规进行语义检索，支持传入各类筛选项，返回语义相关的法律法规列表。 ## **2. 请求信息** \- **HTTP Method**：POST \- **URL**：`https://open.chineselaw.com/open/law_vector_search` \- **Content-Type**：`application/json; charset=utf-8` \- **X-API-Key：**`你的api_key` \- **请求体**：JSON ## **3. 请求参数（Body）** ### **3.1 字段说明** | 字段名 | 类型 | 是否必填 | 说明 | | :-------------- | :------ | :------- | :----------------------------------------------------------- | | `query` | string | 是 | 待检索问题 / 查询文本 | | `rewrite_flag` | boolean | 否 | 是否对查询做改写，默认为`true` | | `fatiao_filter` | object | 否 | 法律法规检索过滤条件，详细内容见字段说明 | | `return_num` | int | 否 | 返回法律法规数量（默认为45，最大不超过检索回的法律法规总数） | #### 3.1.1 `fatiao_filter`字段说明 \> 以下字段均为可选字段 | 字段名 | 类型 | 是否必填 | 说明 | | :---------- | :------- | :------- | :--------------------------------------- | | `sxx` | string[] | 否 | 时效性，见下表「时效性类别」 | | `effect1` | string[] | 否 | 一级效力级别，见下表「一级效力级别类别」 | | `law_start` | string | 否 | 法条生效起始日期，`YYYY-MM-DD` | | `law_end` | string | 否 | 法条生效结束日期，`YYYY-MM-DD` | #### 3.1.2 时效性类别（`sxx`） | 时效性类别 | | :--------- | | 现行有效 | | 失效 | | 已被修改 | | 部分失效 | | 尚未生效 | #### 3.1.3 一级效力级别类别（`effect1`） | 一级效力级别类别 | | :----------------- | | 宪法 | | 法律 | | 司法解释 | | 行政法规 | | 监察法规 | | 部门规章 | | 党内法规 | | 军事法规规章 | | 立法机关工作文件 | | 行政机关工作文件 | | 行业/团体规范 | | 地方性法规 | | 自治条例和单行条例 | | 地方司法文件 | | 地方政府规章 | | 地方规范性文件 | | 地方律协规定 | ## **4. 返回信息** \- **返回类型**：JSON 字符串 \- **成功/失败判断**：看 `msg` 与 `code`（HTTP **401为鉴权失败**） ### **4.1 通用返回结构** | 字段名 | 类型 | 说明 | | :------ | :----- | :----------------------------------------------------------- | | `msg` | string | 返回状态说明 | | `code` | int | 非 200/201 均为异常情形 | | `extra` | object | 检索到的数据结果，只需要取`fatiao`字段值，其他字段值为其他数据源结果（为空list） | ### **4.2** **`extra`****对象的****`fatiao`****字段，包含** | 字段名 | 类型 | 说明 | | :--------- | :------- | :----------- | | `ftid` | string | 法条id | | `fgid` | string | 法规id | | `fgtitle` | string[] | 法规名称 | | `num` | string | 法条条目 | | `content` | string | 内容 | | `sxx` | string | 时效性 | | `effect1` | string | 一级效力级别 | | `effect2` | string | 二级效力级别 | | `dy` | string | 地域 | | `location` | string | 地域含市 | | `start` | int | 实施日期 | | `end` | int | 失效日期 | | `score` | float | 相似度评分 | ## **5. 示例** ### **5.1 请求示例** ```JSON { "query": "入户盗窃", "rewrite_flag": false, "fatiao_filter": { "effect1": ["01"], "sxx": ["现行有效"], "law_start": "2018-01-01", "law_end": "2025-12-31" } } ``` ### **5.2 成功响应示例** ```JSON { "msg": "成功(返回结构化数据)", "code": 201, "answer": "", "extra": { "fatiao": [ { "ftid": "aecabfbe6b0843642509a7f1ff865413_264", "fgid": "aecabfbe6b0843642509a7f1ff865413", "fgtitle": "中华人民共和国刑法(2023修正)", "num": "第二百六十四条", "content": "　【盗窃罪】盗窃公私财物，数额较大的，或者多次盗窃、入户盗窃、携带凶器盗窃、扒窃的，处三年以下有期徒刑、拘役或者管制，并处或者单处罚金；数额巨大或者有其他严重情节的，处三年以上十年以下有期徒刑，并处罚金；数额特别巨大或者有其他特别严重情节的，处十年以上有期徒刑或者无期徒刑，并处罚金或者没收财产。", "sxx": "现行有效", "effect1": "法律", "tag": [], "effect2": "法律", "location": "中央", "start": 20240301, "end": 99999999, "dy": "中央", "score": 1.107480312, "type": 1 }, { "ftid": "aecabfbe6b0843642509a7f1ff865413_263", "fgid": "aecabfbe6b0843642509a7f1ff865413", "fgtitle": "中华人民共和国刑法(2023修正)", "num": "第二百六十三条", "content": "　【抢劫罪】以暴力、胁迫或者其他方法抢劫公私财物的，处三年以上十年以下有期徒刑，并处罚金；有下列情形之一的，处十年以上有期徒刑、无期徒刑或者死刑，并处罚金或者没收财产：\n（一）入户抢劫的；\n（二）在公共交通工具上抢劫的；\n（三）抢劫银行或者其他金融机构的；\n（四）多次抢劫或者抢劫数额巨大的；\n（五）抢劫致人重伤、死亡的；\n（六）冒充军警人员抢劫的；\n（七）持枪抢劫的；\n（八）抢劫军用物资或者抢险、救灾、救济物资的。", "sxx": "现行有效", "effect1": "法律", "tag": [], "effect2": "法律", "location": "中央", "start": 20240301, "end": 99999999, "dy": "中央", "score": 0.6297119999999999, "type": 1 } ] }, "messageId": "", "style": "", "request_id": "" } ``` ## 6. 代码示例 ### 6.1 CURL ```shell curl --location --request POST 'https://open.chineselaw.com/open/law_vector_search' \ --header 'X-API-Key: 你的api_key' \ --header 'Content-Type: application/json; charset=utf-8' \ --header 'Accept: application/json' \ --data-raw '{"query":"入户盗窃","rewrite_flag":false,"fatiao_filter":{"effect1":["01"],"law_start":"2018-01-01","law_end":"2025-12-31","sxx":["现行有效"]},"return_num":2}' ``` ### 6.2 Python ```python import requests url = "https://open.chineselaw.com/open/law_vector_search" API_KEY = "你的api_key" headers = { "X-API-Key": API_KEY, "Content-Type": "application/json; charset=utf-8", "Accept": "application/json", } payload = { "query": "入户盗窃", "rewrite_flag": False, "fatiao_filter": { "effect1": ["01"], "law_start": "2018-01-01", "law_end": "2025-12-31", "sxx": ["现行有效"], }, "return_num": 2, } response = requests.post(url, json=payload, headers=headers, timeout=60) response.raise_for_status() print(response.json()) ``` ### 6.3 Java ```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 CaseVectorSearchExample { static void main(String[] args) throws Exception { String apiKey = "你的api_key"; String url = "https://open.chineselaw.com/open/law_vector_search"; String body = "{\"query\":\"入户盗窃\",\"rewrite_flag\":false,\"fatiao_filter\":" + "{\"effect1\":[\"01\"],\"law_start\":\"2018-01-01\",\"law_end\":\"2025-12-31\"," + "\"sxx\":[\"现行有效\"]},\"return_num\":2}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create(url)) .timeout(Duration.ofSeconds(60)) .header("X-API-Key", apiKey) .header("Content-Type", "application/json; charset=utf-8") .header("Accept", "application/json") .POST(HttpRequest.BodyPublishers.ofString(body)) .build(); HttpClient client = HttpClient.newHttpClient(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode()); System.out.println(response.body()); } } ``` ### 6.4 JavaScript ```javascript const API_KEY = "你的api_key"; const url = "https://open.chineselaw.com/open/law_vector_search"; const res = await fetch(url, { method: "POST", headers: { "X-API-Key": API_KEY, "Content-Type": "application/json; charset=utf-8", "Accept": "application/json", }, body: JSON.stringify({ query: "入户盗窃", rewrite_flag: false, fatiao_filter: { effect1: ["1"], law_start: "2018-01-01", law_end: "2025-12-31", wenshu_type: "刑事案件", sxx: ["现行有效"], }, return_num: 2, }), }); if (!res.ok) throw new Error(`HTTP NULL`); console.log(await res.json()); ``` --- ## 案例语义检索接口 - Category: 案例文书 - ID: 16 - routeKey: `case_vector_search` - HTTP method: `POST` - Direct endpoint: `https://open.chineselaw.com/open/case_vector_search` - Detail JSON: `https://apiplatform.legalmind.cn/api/apis/16` - MCP tool: `yuandian_case_vector_search` - MCP server: `yuandian-case` at `https://open.chineselaw.com/mcp/case/stream` - Price: 10 POINT/call; chargeType=1 Description: 对普通案例和权威案例进行语义检索，支持传入各类筛选项，返回语义相关的案例列表。 ### Direct API Authentication ```http X-API-Key: YOUR_API_KEY Accept: application/json Content-Type: application/json; charset=utf-8 ``` ### MCP Authentication ```http Accept: application/json, text/event-stream Authorization: Bearer YOUR_API_KEY ``` ### Full Document ## **1. 基本信息** \- **接口名称**：案例语义检索接口 \- **接口用途**：对普通案例和权威案例进行语义检索，支持传入各类筛选项，返回语义相关的案例列表。 ## **2. 请求信息** \- **HTTP Method**：POST \- **URL**：`https://open.chineselaw.com/open/case_vector_search` \- **Content-Type**：`application/json; charset=utf-8` \- **X-API-Key：**`你的api_key` \- **请求体**：JSON ## **3. 请求参数（Body）** ### **3.1 字段说明** | 字段名 | 类型 | 是否必填 | 说明 | | :-------------- | :------ | :------- | :--------------------------------------------------- | | `query` | string | 是 | 待检索问题 / 查询文本 | | `rewrite_flag` | boolean | 否 | 是否对查询做改写，默认为`true` | | `wenshu_filter` | object | 否 | 案例检索过滤条件，详细内容见字段说明 | | `return_num` | int | 否 | 返回案例数量（默认为45，最大不超过检索回的案例总数） | #### 3.1.1 `wenshu_filter`字段说明 > 以下字段均为可选字段 | 字段名 | 类型 | 是否必填 | 说明 | | :------------ | :------- | :------- | :----------------------------------------------------------- | | `wenshu_type` | string | 否 | 案件类别列表，见下表「案件类别」 | | `wszl` | string[] | 否 | 文书种类编码列表，见下表「文书种类」 | | `ja_start` | string | 否 | 结案日期起，`YYYY-MM-DD` | | `ja_end` | string | 否 | 结案日期止，`YYYY-MM-DD` | | `dianxing` | boolean | 否 | 是否仅典型案例；默认 为`false`（普通 + 权威）；`true` 时仅权威案例库 | | `fayuan` | string[] | 否 | 法院名称列表（会映射为 `jbdw` 编码） | | `cj` | string | 否 | 法院层级（如“最高/高级/中级/基层”） | | `xzqh_p` | string | 否 | 省级行政区 | | `xzqh_c` | string | 否 | 市级行政区 | #### 3.1.2 案件类别列表（`wenshu_type`） | 案件类别 | | :--------------------- | | 刑事案件 | | 民事案件 | | 行政案件 | | 执行案件 | | 管辖案件 | | 国家赔偿与司法救助案件 | | 强制清算与破产案件 | | 国际司法协助案件 | | 非诉保全审查案件 | | 其他案件 | #### 3.1.3 文书种类编码（`wszl` 元素） | key | 含义 | | :--- | :----- | | 1 | 判决书 | | 2 | 裁定书 | | 3 | 调解书 | | 4 | 决定书 | | 5 | 通知书 | | 6 | 支付令 | | 7 | 申请书 | | 8 | 起诉书 | | 9 | 抗诉书 | | 10 | 起诉状 | | 11 | 上诉状 | ## **4. 返回信息** \- **返回类型**：JSON 字符串 \- **成功/失败判断**：看 `msg` 与 `code`（HTTP **401为鉴权失败**） ### **4.1 通用返回结构** | 字段名 | 类型 | 说明 | | :------ | :----- | :----------------------------------------------------------- | | `msg` | string | 返回状态说明 | | `code` | int | 非 200/201 均为异常情形 | | `extra` | object | 检索到的数据结果，只需要取`wenshu`字段值，其他字段值为其他数据源结果（为空list） | ### **4.2`extra`对象的`wenshu`字段，包含** | 字段名 | 类型 | 说明 | | :------ | :------- | :------------- | | scid | object | 数据id | | title | string | 标题 | | `ay` | string[] | 所属的案由code | | ah | string | 案号 | | wszl | string | 文书种类 | | ajlb | string | 案件类别 | | spcx | string | 审判程序 | | jand | int | 结案年份 | | jaDate | int | 结案日期 | | cj | string | 法院层级 | | content | string | 内容 | | xzqh_p | string | 地域省份 | | xzqh_c | string | 地域市 | | score | float | 相似度评分 | ## **5. 示例** ### **5.1 请求示例** ```JSON { "query": "入户盗窃", "rewrite_flag": false, "wenshu_filter": { "wszl": ["1"], "ja_start": "2015-01-01", "ja_end": "2025-01-01", "wenshu_type":"刑事案件", "dianxing": false, "fayuan": ["北京市第一中级人民法院"], "cj": "中级", "xzqh_p": "北京" } } ``` ### **5.2 成功响应示例** ```JSON { "msg": "成功(返回结构化数据)", "code": 201, "answer": "", "extra": { "wenshu": [ { "type": 2, "scid": "b5c63a4ec01df9495b6b9024bf0a2bee", "spcx": "二审案件", "ajlb": "刑事案件", "jbdw": "北京市第一中级人民法院", "title": "吕江波盗窃二审刑事判决书", "jand": 2019, "jaDate": 20191223, "xzqh_c": "一中院", "wszl": "判决书", "para_name": "总结", "ah": "（2019）京01刑终629号", "ay": [ "201" ], "content": "本案的案件基本事实为：被告人吕江波在湖北省黄石市三江共和城铜锣湾广场售楼部更衣室内，通过脚踩方式使被害人杨某掉落的信用卡等物品未被发现，随后非法占有并使用这些信用卡进行了取款，共计取款人民币8000元。吕江波的家属后来代其赔偿了被害人14000元，得到了被害人的谅解。吕江波的行为最终被认定为盗窃信用卡并使用，构成盗窃罪。本案争议焦点在于原审被告人吕江波的行为是否构成信用卡诈骗罪以及是否应当对其盗窃行为进行重新定罪量刑。法院认为，吕江波实施了窃取他人财物的行为，数额较大，其行为符合盗窃罪的构成要件，而非信用卡诈骗罪。一审判决将吕江波的行为错误地定性为信用卡诈骗罪，并据此作出数罪并罚的判决，属于法律适用错误，应予以纠正。同时，考虑到吕江波到案后能如实供述自己的罪行，自愿签署认罪认罚具结书，并在案发后通过家属帮助退赔全部涉案赃款，获得被害人谅解，依法可以从轻处罚。然而，鉴于吕江波多次实施盗窃，包括入户盗窃，这一情节在量刑时必须予以充分考虑。综合考量吕江波犯罪的事实、性质、情节及其行为对社会的危害程度，法院依法改判其构成盗窃罪，并根据相关法律规定调整了刑罚，确保判决公正合理。被告人以非法占有为目的，实施盗窃行为，数额较大，构成盗窃罪，应予惩处。若被告人到案后如实供述罪行，签署认罪认罚具结书，并在亲属协助下退赔全部赃款且获得被害人谅解，可依法从宽处罚；但多次盗窃或入户盗窃的情节应在量刑时予以考量。争议焦点1：原审被告人吕江波的行为是否构成盗窃罪而非信用卡诈骗罪。", "xzqh_p": "北京", "cj": "中级", "score": 1.0098828125000001, "authority": "", "db": "精选案例库", "anyou": [ "盗窃罪" ] }, { "type": 2, "scid": "3f186a2590ab411f2fedcd003caf9c1e", "spcx": "二审案件", "ajlb": "刑事案件", "jbdw": "北京市第一中级人民法院", "title": "汪传国盗窃二审刑事判决书", "jand": 2019, "jaDate": 20190322, "xzqh_c": "一中院", "wszl": "判决书", "para_name": "总结", "ah": "（2019）京01刑终124号", "ay": [ "201" ], "content": "本案的案件基本事实为：2018年6月29日凌晨，汪传国在北京石景山区模式口村28号院内先后窃取了张某1的苹果牌Iphone6SPLUS手机一部及少量现金，以及郭某的两部手机（白色华为牌NOVA青春型手机一部，价值780元；苹果牌黑色Iphone8PLUS手机一部，价值4400元）和现金22100元。同年7月12日，汪传国被抓获，但赃款赃物未能追回。汪传国家属事后分别向张某1和郭某进行了部分经济补偿并获得了谅解。二审期间，汪传国未能提供新证据支持其未盗窃郭某现金的主张，相关证据足以证实其盗窃金额。本案争议焦点在于上诉人汪传国是否构成盗窃罪以及其刑事责任的确定。法院认为，汪传国以非法占有为目的，实施了入户盗窃他人财物的行为，且涉案金额较大，其行为符合盗窃罪的构成要件，依法应予惩处。此外，汪传国曾因盗窃罪被判刑，刑满释放后五年内再次实施盗窃行为，属于累犯，依法应从重处罚。然而，考虑到汪传国到案后如实供述了部分犯罪事实，积极退赔被害人部分损失并获得谅解，依法可以从轻处罚。综上所述，一审法院认定汪传国犯盗窃罪的事实清楚，证据确凿，定罪准确，量刑适当，审判程序合法，但未依法责令汪传国退赔全部违法所得，存在不当之处，需予以纠正。以非法占有为目的实施入户盗窃，数额较大的，构成盗窃罪，依法应予惩处。若行为人系累犯，即曾因盗窃罪被判处有期徒刑，刑罚执行完毕后五年内再犯应判处有期徒刑以上刑罚之罪的，依法应从重处罚。同时，行为人如实供述犯罪事实，积极退赔被害人损失并获得谅解的，依法可以从轻处罚。法院在判决时需考虑犯罪事实、性质、情节及对社会的危害程度，确保量刑适当。", "xzqh_p": "北京", "cj": "中级", "score": 0.9608060420000001, "authority": "", "db": "精选案例库", "anyou": [ "盗窃罪" ] } ] }, "messageId": "", "style": "", "request_id": "" } ``` ## 6. 代码示例 ### 6.1 CURL ```shell curl --location --request POST 'https://open.chineselaw.com/open/case_vector_search' \ --header 'X-API-Key: 你的api_key' \ --header 'Content-Type: application/json; charset=utf-8' \ --header 'Accept: application/json' \ --data-raw '{"query":"入户盗窃","rewrite_flag":false,"wenshu_filter":{"wszl":["1"],"ja_start":"2015-01-01","ja_end":"2025-01-01","wenshu_type":"刑事案件","fayuan":["北京市第一中级人民法院"],"cj":"中级","xzqh_p":"北京","dianxing":false},"return_num":2}' ``` ### 6.2 Python ```python import requests url = "https://open.chineselaw.com/open/case_vector_search" API_KEY = "你的api_key" headers = { "X-API-Key": API_KEY, "Content-Type": "application/json; charset=utf-8", "Accept": "application/json", } payload = { "query": "入户盗窃", "rewrite_flag": False, "wenshu_filter": { "wszl": ["1"], "ja_start": "2015-01-01", "ja_end": "2025-01-01", "wenshu_type": "刑事案件", "fayuan": ["北京市第一中级人民法院"], "cj": "中级", "xzqh_p": "北京", "dianxing": False, }, "return_num": 2, } response = requests.post(url, json=payload, headers=headers, timeout=60) response.raise_for_status() print(response.json()) ``` ### 6.3 Java ```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 CaseVectorSearchExample { static void main(String[] args) throws Exception { String apiKey = "你的api_key"; String url = "https://open.chineselaw.com/open/case_vector_search"; String body = "{\"query\":\"入户盗窃\",\"rewrite_flag\":false,\"wenshu_filter\":" + "{\"wszl\":[\"1\"],\"ja_start\":\"2015-01-01\",\"ja_end\":\"2025-01-01\"," + "\"wenshu_type\":\"刑事案件\",\"fayuan\":[\"北京市第一中级人民法院\"]," + "\"cj\":\"中级\",\"xzqh_p\":\"北京\",\"dianxing\":false},\"return_num\":2}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create(url)) .timeout(Duration.ofSeconds(60)) .header("X-API-Key", apiKey) .header("Content-Type", "application/json; charset=utf-8") .header("Accept", "application/json") .POST(HttpRequest.BodyPublishers.ofString(body)) .build(); HttpClient client = HttpClient.newHttpClient(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode()); System.out.println(response.body()); } } ``` ### 6.4 JavaScript ```javascript const API_KEY = "你的api_key"; const url = "https://open.chineselaw.com/open/case_vector_search"; const res = await fetch(url, { method: "POST", headers: { "X-API-Key": API_KEY, "Content-Type": "application/json; charset=utf-8", "Accept": "application/json", }, body: JSON.stringify({ query: "入户盗窃", rewrite_flag: false, wenshu_filter: { wszl: ["1"], ja_start: "2015-01-01", ja_end: "2025-01-01", wenshu_type: "刑事案件", fayuan: ["北京市第一中级人民法院"], cj: "中级", xzqh_p: "北京", dianxing: false, }, return_num: 2, }), }); if (!res.ok) throw new Error(`HTTP NULL`); console.log(await res.json()); ``` --- ## 根据企业 id、统一社会信用代码获取企业详情 - Category: 企业信息 - ID: 15 - routeKey: `rh_company_detail` - HTTP method: `GET` - Direct endpoint: `https://open.chineselaw.com/open/rh_company_detail` - Detail JSON: `https://apiplatform.legalmind.cn/api/apis/15` - MCP tool: `yuandian_rh_company_detail` - MCP server: `yuandian-company` at `https://open.chineselaw.com/mcp/company/stream` - Price: 10 POINT/call; chargeType=1 Description: 在企业库中定位一家企业，并返回该企业的工商登记、成员、分支机构、变更与对外投资、知识产权、涉诉摘要、风险标签等聚合详情。 ### Direct API Authentication ```http X-API-Key: YOUR_API_KEY Accept: application/json ``` ### MCP Authentication ```http Accept: application/json, text/event-stream Authorization: Bearer YOUR_API_KEY ``` ### Full Document # 根据企业 id / 统一社会信用代码获取企业详情接口 ## 1. 基本信息 - **接口名称**：根据企业 id、统一社会信用代码获取企业详情 - **接口用途**：在企业库中定位一家企业，并返回该企业的工商登记、成员、分支机构、变更与对外投资、知识产权、涉诉摘要、风险标签等聚合详情。 ## 2. 请求信息 - **HTTP Method**：GET - **URL**：`https://open.chineselaw.com/open/rh_company_detail` - **Accept**：`application/json` - **X-API-Key**：`你的api_key` ## 3. 请求参数（Query） | 参数名 | 类型 | 是否必填 | 说明 | | ---------- | ------ | -------: | ------------------------------------------------------------ | | `id` | string | 否 | 企业 ID（ES 文档 `_id`，使用 `idsQuery` 精确查询） | | `tyshxydm` | string | 否 | 统一社会信用代码（对应字段 `company.creditNo`，`termsQuery`） | ### 3.1 校验与查询优先级 - **`id`、`tyshxydm` 两者不能同时为空**：否则返回失败 `message = "参数异常！"` - **查询优先级**（互斥分支，自上而下）： 1. 若 `id` 非空：按文档 ID 查询 2. 否则若 `tyshxydm` 非空：按统一社会信用代码查询 - **结果条数**：每次检索 `size = 1`，取第一条命中作为详情。 ## 4. 返回信息 - **返回类型**：JSON 字符串 ### 4.1 通用返回结构 | 字段名 | 类型 | 说明 | | --------- | -------------- | -------------------------------------- | | `status` | string | `success` / `failed` / `notFound` 等 | | `code` | number | 成功 200/201；参数异常失败 500；未找到 404 | | `message` | string | 提示信息 | | `data` | object \| null | 企业详情对象；未找到时为 null | ### 4.2 `data` 对象说明（概要） 主要模块包括（字段名均为中文 key）： | 模块 | 说明 | | -------------- | ------------------------------------------------------------ | | 基础标识 | 如：`企业ID`、`企业名称` | | 工商与登记信息 | 如 `法定代表人`、`统一社会信用代码`、`注册资本`、`成立日期`、`经营状态`、`经营范围`、`核心成员`（及按职务动态写入的职务字段）等 | | 股东与分支机构 | 如股东、分支机构及详情列表等 | | 变更与对外投资 | | | 知识产权 | 商标、软件著作权、作品著作权、专利等列表（各子项为中文键值） | | 涉诉信息 | 如存在则包含 `涉诉` 列表（案号、案由、文书 id、诉讼地位等） | | 风险 | 如存在则包含 `风险` | ## 5. 示例 ### 5.1 请求示例（按企业 id） `GET /legal-insight/service/app/dify/company/companyDetail?id=078361f3-cee8-48c1-9af0-dcba3fa9a492` ### 5.2 请求示例（按统一社会信用代码） `GET /legal-insight/service/app/dify/company/companyDetail?tyshxydm=91110108MA0074PN30` ### 5.4 成功响应示例（结构示意） ```json { "code": 200, "data": { "企业ID": "078361f3-cee8-48c1-9af0-dcba3fa9a492", "企业名称": "北京华宇元典信息服务有限公司", "法定代表人": "郭颖", "工商注册号": "110108021697577", "注册资本": "6176.4706万人民币", "组织机构代码": "MA0074PN3", "统一社会信用代码": "91110108MA0074PN30", "纳税人识别号": "91110108MA0074PN30", "企业类型": "其他有限责任公司", "行业": "商务服务业", "成立日期": "2016年07月25日", "营业期限": "2016年07月25日~2066年07月24日", "核准日期": "2025年03月14日", "登记机关": "北京市海淀区市场监督管理局", "注册地址": "北京市海淀区中关村东路1号院8号楼21层C2303", "经营状态": "存续", "经营范围": "一般项目：社会经济咨询服务；技术服务、技术开发、技术咨询、技术交流、技术转让、技术推广；计算机系统服务；软件开发；数据处理服务；法律咨询（不含依法须律师事务所执业许可的业务）；软件销售；信息技术咨询服务；销售代理；电子产品销售；人工智能基础软件开发；人工智能理论与算法软件开发。（除依法须经批准的项目外，凭营业执照依法自主开展经营活动）许可项目：互联网信息服务。（依法须经批准的项目，经相关部门批准后方可开展经营活动，具体经营项目以相关部门批准文件或许可证件为准）（不得从事国家和本市产业政策禁止和限制类项目的经营活动。）", "董事": "李东海，王琰，蔡建军，余晴燕，王映新，河清松", "监事": "孟芳芳", "经理": "蔡建军", "董事长": "郭颖", "财务负责人": "巩易", "核心成员": "巩易，李东海，王映新，孟芳芳，河清松，王琰，郭颖，余晴燕，蔡建军", "股东": "北京元典创新科技中心（有限合伙），北京元典成长科技中心（有限合伙），北京元典致知科技中心（有限合伙），北京元典起航科技中心（有限合伙），北京华宇软件股份有限公司，南京图灵一期创业投资合伙企业（有限合伙）", "股东详情": [ { "名称": "北京元典创新科技中心（有限合伙）", "股东类型": "法人股东", "认缴出资额": "", "实缴出资额": "", "出资比例": 0 }, { "名称": "北京元典成长科技中心（有限合伙）", "股东类型": "法人股东", "认缴出资额": "", "实缴出资额": "", "出资比例": 0 }, { "名称": "北京元典致知科技中心（有限合伙）", "股东类型": "法人股东", "认缴出资额": "", "实缴出资额": "", "出资比例": 0, "参股日期": "2019年05月13日" }, { "名称": "北京元典起航科技中心（有限合伙）", "股东类型": "法人股东", "认缴出资额": "", "实缴出资额": "", "出资比例": 0 }, { "名称": "北京华宇软件股份有限公司", "股东类型": "法人股东", "认缴出资额": "", "实缴出资额": "", "出资比例": 0 }, { "名称": "南京图灵一期创业投资合伙企业（有限合伙）", "股东类型": "法人股东", "认缴出资额": "", "实缴出资额": "", "出资比例": 0, "参股日期": "2020年06月16日" } ], "变更": [ { "变更项": "经营范围", "变更前": "经济贸易咨询；技术开发、技术推广、技术转让、技术咨询、技术服务；计算机技术培训（不得面向全国招生）；计算机系统服务；基础软件服务；应用软件服务；软件开发；数据处理（数据处理中的银行卡中心、PUE值在1.5以上的云计算数据中心除外）；销售电子产品、通讯设备、计算机、软件及辅助设备、机械设备、家用电器、化工产品（不含危险化学品及一类易制毒化学品）；互联网信息服务。（市场主体依法自主选择经营项目，开展经营活动；互联网信息服务以及依法须经批准的项目，经相关部门批准后依批准的内容开展经营活动；不得从事国家和本市产业政策禁止和限制类项目的经营活动。）", "变更后": "一般项目：社会经济咨询服务；技术服务、技术开发、技术咨询、技术交流、技术转让、技术推广；计算机系统服务；软件开发；数据处理服务；法律咨询（不含依法须律师事务所执业许可的业务）；软件销售；信息技术咨询服务；销售代理；电子产品销售；人工智能基础软件开发；人工智能理论与算法软件开发。（除依法须经批准的项目外，凭营业执照依法自主开展经营活动）许可项目：互联网信息服务。（依法须经批准的项目，经相关部门批准后方可开展经营活动，具体经营项目以相关部门批准文件或许可证件为准）（不得从事国家和本市产业政策禁止和限制类项目的经营活动。）", "变更时间": "2023年12月08日" }, { "变更项": "法定代表人", "变更前": "朱相宇", "变更后": "郭颖", "变更时间": "2022年03月17日" }, { "变更项": "董事（理事）、经理、监事", "变更前": "蔡建军，郭颖，李东海，孟芳芳，米坤，王琰，赵晓明，朱相宇*", "变更后": "蔡建军，郭颖*，李东海，孟芳芳，米坤，王琰，赵晓明，朱相宇", "变更时间": "2022年03月17日" }, { "变更项": "董事（理事）、经理、监事", "变更前": "蔡建军，李东海，孟芳芳，米坤，邵学，王琰，赵晓明，朱相宇*，邹劭坤", "变更后": "蔡建军，郭颖，李东海，孟芳芳，米坤，王琰，赵晓明，朱相宇*", "变更时间": "2022年02月22日" }, { "变更项": "法定代表人", "变更前": "邵学", "变更后": "朱相宇", "变更时间": "2021年11月05日" }, { "变更项": "董事（理事）、经理、监事", "变更前": "李东海，孟芳芳，米坤，邵学*，王琰，赵晓明，朱相宇，邹劭坤", "变更后": "蔡建军，李东海，孟芳芳，米坤，邵学，王琰，赵晓明，朱相宇*，邹劭坤", "变更时间": "2021年11月05日" }, { "变更项": "董事（理事）、经理、监事", "变更前": "李东海，米坤，邵学*，王琰，闻连茹，赵晓明，朱相宇，邹劭坤", "变更后": "李东海，孟芳芳，米坤，邵学*，王琰，赵晓明，朱相宇，邹劭坤", "变更时间": "2020年12月25日" }, { "变更项": "投资人", "变更前": "北京华宇软件股份有限公司，企业法人，北京元典成长科技中心（有限合伙），法人股东，北京元典创新科技中心（有限合伙），法人股东，北京元典起航科技中心（有限合伙），法人股东，北京元典致知科技中心（有限合伙），法人股东", "变更后": "北京华宇软件股份有限公司，企业法人，北京元典成长科技中心（有限合伙），法人股东，北京元典创新科技中心（有限合伙），法人股东，北京元典起航科技中心（有限合伙），法人股东，北京元典致知科技中心（有限合伙），法人股东，南京图灵一期创业投资合伙企业（有限合伙），法人股东", "变更时间": "2020年06月16日" }, { "变更项": "注册资本", "变更前": "6000万", "变更后": "6176.4706万", "变更时间": "2020年06月16日" }, { "变更项": "董事（理事）、经理、监事", "变更前": "黄福林，李东海，吕宾，米坤，邵学*，王琰，闻连茹，邹劭坤", "变更后": "李东海，米坤，邵学*，王琰，闻连茹，赵晓明，朱相宇，邹劭坤", "变更时间": "2020年06月16日" } ], "商标": [ { "名称": "元典元来", "申请日期": "2023年05月10日", "状态": "已注册", "开始日期": "2023年11月07日", "结束日期": "2033年11月06日" }, { "名称": "深之思", "申请日期": "2021年01月19日", "状态": "注册", "开始日期": "2021年11月21日", "结束日期": "2031年11月20日" }, { "名称": "深之思", "申请日期": "2021年01月19日", "状态": "已注册", "开始日期": "2021年11月21日", "结束日期": "2031年11月20日" }, { "名称": "深之思", "申请日期": "2021年01月19日", "状态": "注册", "开始日期": "2021年10月21日", "结束日期": "2031年10月20日" }, { "名称": "DOC KITE", "申请日期": "2020年10月19日", "状态": "注册", "开始日期": "2021年07月21日", "结束日期": "2031年07月20日" }, { "名称": "LAWAND", "申请日期": "2020年09月09日", "状态": "注册", "开始日期": "2021年07月07日", "结束日期": "2031年07月06日" }, { "名称": "DOC KITE", "申请日期": "2020年10月16日", "状态": "注册", "开始日期": "2021年06月28日", "结束日期": "2031年06月27日" }, { "名称": "DOC KITE", "申请日期": "2020年10月19日", "状态": "注册", "开始日期": "2021年06月21日", "结束日期": "2031年06月20日" }, { "名称": "DOC KITE", "申请日期": "2020年10月19日", "状态": "注册", "开始日期": "2021年06月21日", "结束日期": "2031年06月20日" }, { "名称": "DOC KITE", "申请日期": "2020年10月19日", "状态": "注册", "开始日期": "2021年06月21日", "结束日期": "2031年06月20日" } ], "软件著作权": [ { "批准日期": "2025年10月22日", "全称": "Amicus法律数字助手软件", "简称": "Amicus", "登记号": "2025SR2047374", "版本号": "V1.0" }, { "批准日期": "2025年03月20日", "全称": "金融案件趋势分析与风险预警系统", "简称": "金融案件趋势与预警系统", "登记号": "2025SR0490060", "分类号": "", "版本号": "V1.0.0" }, { "批准日期": "2025年01月26日", "全称": "法务低代码开发平台", "简称": "法务低代码", "登记号": "2025SR0180996", "分类号": "", "版本号": "V1.0" }, { "批准日期": "2024年11月06日", "全称": "元典合同智能审查平台", "简称": "大模型合同智审", "登记号": "2024SR1710228", "分类号": "", "版本号": "V1.5" }, { "批准日期": "2024年09月26日", "全称": "元典文本解析平台", "简称": "文本解析平台", "登记号": "2024SR1432158", "分类号": "", "版本号": "V2.0" }, { "批准日期": "2024年08月07日", "全称": "万象数字助理系统", "简称": "万象数字助理", "登记号": "2024SR1139489", "分类号": "", "版本号": "V2.4.3" }, { "批准日期": "2024年08月07日", "全称": "元典问达软件", "简称": "元典问达", "登记号": "2024SR1137121", "分类号": "", "版本号": "V2.0" }, { "批准日期": "2023年12月18日", "全称": "元典法律大语言模型系统", "简称": "元典大模型", "登记号": "2023SR1668514", "分类号": "", "版本号": "V3.0" }, { "批准日期": "2023年09月26日", "全称": "小至数字助手系统", "简称": "小至", "登记号": "2023SR1156917", "分类号": "", "版本号": "V1.5" }, { "批准日期": "2023年09月22日", "全称": "元来法律智能助手系统", "简称": "元来", "登记号": "2023SR1143545", "分类号": "", "版本号": "V1.5" } ], "专利": [ { "申请公布日": "2022-05-13", "专利名称": "争议焦点推荐方法及装置", "申请号": "CN202210089545.9", "申请公布号": "CN114490939A" }, { "申请公布日": "2022-05-10", "专利名称": "案件事实与法条匹配的方法及装置", "申请号": "CN202210123792.6", "申请公布号": "CN114461760A" }, { "申请公布日": "2022-05-03", "专利名称": "用于争议焦点裁判文书的筛选的模型的训练方法", "申请号": "CN202111632891.9", "申请公布号": "CN114428847A" }, { "申请公布日": "2021-11-12", "专利名称": "敏感词屏蔽质量评估模型的训练方法及相应的评估方法", "申请号": "CN202110924568.2", "申请公布号": "CN113642739A" }, { "申请公布日": "2021-10-29", "专利名称": "裁判文书人物关系识别方法、装置和电子设备", "申请号": "CN202110815292.4", "申请公布号": "CN113569046A" }, { "申请公布日": "2021-10-29", "专利名称": "裁判文书地址信息识别方法、装置和电子设备", "申请号": "CN202110815315.1", "申请公布号": "CN113570480A" }, { "申请公布日": "2021-05-14", "专利名称": "基于文本匹配的争议焦点推荐方法、装置和电子设备", "申请号": "CN202110120642.5", "申请公布号": "CN112800746A" }, { "申请公布日": "2021-05-11", "专利名称": "法律要素提取方法、装置和电子设备", "申请号": "CN202110279814.3", "申请公布号": "CN112784578A" }, { "申请公布日": "2021-04-16", "专利名称": "用于裁判文书的敏感身份信息的识别方法", "申请号": "CN202011622927.0", "申请公布号": "CN112667813A" }, { "申请公布日": "2020-09-01", "专利名称": "法律数据检索的评价方法、评价装置和电子设备", "申请号": "CN202010476485.7", "申请公布号": "CN111612658A" } ], "知识产权": [ { "名称": "元典元来", "申请日期": "2023年05月10日", "状态": "已注册", "开始日期": "2023年11月07日", "结束日期": "2033年11月06日" }, { "名称": "深之思", "申请日期": "2021年01月19日", "状态": "注册", "开始日期": "2021年11月21日", "结束日期": "2031年11月20日" }, { "名称": "深之思", "申请日期": "2021年01月19日", "状态": "已注册", "开始日期": "2021年11月21日", "结束日期": "2031年11月20日" }, { "名称": "深之思", "申请日期": "2021年01月19日", "状态": "注册", "开始日期": "2021年10月21日", "结束日期": "2031年10月20日" }, { "名称": "DOC KITE", "申请日期": "2020年10月19日", "状态": "注册", "开始日期": "2021年07月21日", "结束日期": "2031年07月20日" }, { "批准日期": "2025年10月22日", "全称": "Amicus法律数字助手软件", "简称": "Amicus", "登记号": "2025SR2047374", "版本号": "V1.0" }, { "批准日期": "2025年03月20日", "全称": "金融案件趋势分析与风险预警系统", "简称": "金融案件趋势与预警系统", "登记号": "2025SR0490060", "分类号": "", "版本号": "V1.0.0" }, { "批准日期": "2025年01月26日", "全称": "法务低代码开发平台", "简称": "法务低代码", "登记号": "2025SR0180996", "分类号": "", "版本号": "V1.0" }, { "批准日期": "2024年11月06日", "全称": "元典合同智能审查平台", "简称": "大模型合同智审", "登记号": "2024SR1710228", "分类号": "", "版本号": "V1.5" }, { "批准日期": "2024年09月26日", "全称": "元典文本解析平台", "简称": "文本解析平台", "登记号": "2024SR1432158", "分类号": "", "版本号": "V2.0" }, { "申请公布日": "2022-05-13", "专利名称": "争议焦点推荐方法及装置", "申请号": "CN202210089545.9", "申请公布号": "CN114490939A" }, { "申请公布日": "2022-05-10", "专利名称": "案件事实与法条匹配的方法及装置", "申请号": "CN202210123792.6", "申请公布号": "CN114461760A" }, { "申请公布日": "2022-05-03", "专利名称": "用于争议焦点裁判文书的筛选的模型的训练方法", "申请号": "CN202111632891.9", "申请公布号": "CN114428847A" }, { "申请公布日": "2021-11-12", "专利名称": "敏感词屏蔽质量评估模型的训练方法及相应的评估方法", "申请号": "CN202110924568.2", "申请公布号": "CN113642739A" }, { "申请公布日": "2021-10-29", "专利名称": "裁判文书人物关系识别方法、装置和电子设备", "申请号": "CN202110815292.4", "申请公布号": "CN113569046A" } ] }, "message": "请求成功", "status": "success" } ``` ### 5.5 失败响应示例（参数全空） ```json { "data": null, "status": "failed", "code": 500, "message": "参数异常！" } ``` ### 5.6 未找到响应示例 ```json { "data": null, "status": "notFound", "code": 404, "message": "未找到" } ``` ## 6. 代码示例 ### 6.1 CURL ```shell curl --location --request GET 'https://open.chineselaw.com/open/rh_company_detail?tyshxydm=91110108MA0074PN30' \ --header 'Accept: application/json' \ --header 'X-API-Key: 你的api_key' ``` ### 6.2 Python ```python import requests # 企业详情（示例：按统一社会信用代码） BASE_URL = "https://open.chineselaw.com/open/rh_company_detail" API_KEY = "你的api_key" # 替换为实际 Key PARAMS = {"tyshxydm": "91110108MA0074PN30"} HEADERS = { "Accept": "application/json", "X-API-Key": API_KEY, } response = requests.get(BASE_URL, params=PARAMS, headers=HEADERS, timeout=30) response.raise_for_status() result = response.json() print(result) ``` ### 6.3 Java ```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 CompanyDetailExample { static void main(String[] args) throws Exception { String apiKey = "你的api_key"; // 替换为实际 Key String url = "https://open.chineselaw.com/open/rh_company_detail" + "?tyshxydm=91110108MA0074PN30"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create(url)) .timeout(Duration.ofSeconds(30)) .header("Accept", "application/json") .header("X-API-Key", apiKey) .GET() .build(); HttpClient client = HttpClient.newBuilder() .connectTimeout(Duration.ofSeconds(10)) .build(); HttpResponse response = client.send( request, HttpResponse.BodyHandlers.ofString()); System.out.println("HTTP " + response.statusCode()); System.out.println(response.body()); } } ``` ### 6.4 JavaScript ```javascript const API_KEY = "你的api_key"; // 替换为实际 Key const url = "https://open.chineselaw.com/open/rh_company_detail?tyshxydm=91110108MA0074PN30"; const res = await fetch(url, { method: "GET", headers: { Accept: "application/json", X-API-Key: API_KEY }, }); if (!res.ok) { throw new Error(`请求失败: HTTP NULL`); } const data = await res.json(); console.log(data); ``` ## 7. 备注 - 返回 `data` 为单层中文键对象，并可能包含嵌套列表（如涉诉、知识产权明细），对接时请按 key 解析。 --- ## 根据企业名称或股票简称查询企业详情 - Category: 企业信息 - ID: 14 - routeKey: `rh_company_info` - HTTP method: `GET` - Direct endpoint: `https://open.chineselaw.com/open/rh_company_info` - Detail JSON: `https://apiplatform.legalmind.cn/api/apis/14` - MCP tool: `yuandian_rh_company_info` - MCP server: `yuandian-company` at `https://open.chineselaw.com/mcp/company/stream` - Price: 10 POINT/call; chargeType=1 Description: 按名称（含全称、曾用名、股票简称等组合检索策略）查询企业，返回最多 `num` 条企业的详情：工商信息、股东/分支、变更与对外投资、知识产权、涉诉、风险等。 ### Direct API Authentication ```http X-API-Key: YOUR_API_KEY Accept: application/json ``` ### MCP Authentication ```http Accept: application/json, text/event-stream Authorization: Bearer YOUR_API_KEY ``` ### Full Document # 根据企业名称 / 股票简称查询企业详情接口 ## 1. 基本信息 - **接口名称**：根据企业名称或股票简称查询企业详情 - **接口用途**：按名称（含全称、曾用名、股票简称等组合检索策略）查询企业，返回最多 `num` 条企业的**详情聚合**：工商信息、股东/分支、变更与对外投资、知识产权、涉诉、风险等）。 ## 2. 请求信息 - **HTTP Method**：GET - **URL**：`https://open.chineselaw.com/open/rh_company_info` - **Accept**：`application/json` - **X-API-Key**：`你的api_key` ## 3. 请求参数（Query） | 参数名 | 类型 | 是否必填 | 说明 | |---|---|---:|---| | `name` | string | 是 | 企业名称或股票简称等检索词 | | `num` | int | 否 | 期望返回的 ES 检索条数上限；**默认 `2`** | ### 3.1 `num` 取值规则 - 若 **`num < 0` 或 `num > 50`**：在业务层会被置为 **`10`** - 否则：使用调用方传入的 `num` ## 4. 返回信息 - **返回类型**：JSON 字符串 ### 4.1 通用返回结构（ResultVO） | 字段名 | 类型 | 说明 | |---|---|---| | `status` | string | `success` / `notFound` 等 | | `code` | number | 成功 200/201；未找到 404 | | `message` | string | 提示信息 | | `data` | object[] \| null | 企业详情对象列表；未找到时为 null | ### 4.2 `data[]` 单条对象说明 主要模块包括（字段名均为中文 key）： | 模块 | 说明 | | -------------- | ------------------------------------------------------------ | | 基础标识 | 如：`企业ID`、`企业名称` | | 工商与登记信息 | 如 `法定代表人`、`统一社会信用代码`、`注册资本`、`成立日期`、`经营状态`、`经营范围`、`核心成员`（及按职务动态写入的职务字段）等 | | 股东与分支机构 | 如股东、分支机构及详情列表等 | | 变更与对外投资 | | | 知识产权 | 商标、软件著作权、作品著作权、专利等列表（各子项为中文键值） | | 涉诉信息 | 如存在则包含 `涉诉` 列表（案号、案由、文书 id、诉讼地位等） | | 风险 | 如存在则包含 `风险` | ## 5. 示例 ### 5.1 请求参数示例 `GET /legal-insight/service/app/dify/company/companyInfo?name=北京华宇元典信息服务有限公司` ### 5.2 成功响应示例（结构示意） ```json { "code": 200, "data": [ { "企业ID": "078361f3-cee8-48c1-9af0-dcba3fa9a492", "企业名称": "北京华宇元典信息服务有限公司", "法定代表人": "郭颖", "工商注册号": "110108021697577", "注册资本": "6176.4706万人民币", "组织机构代码": "MA0074PN3", "统一社会信用代码": "91110108MA0074PN30", "纳税人识别号": "91110108MA0074PN30", "企业类型": "其他有限责任公司", "行业": "商务服务业", "成立日期": "2016年07月25日", "营业期限": "2016年07月25日~2066年07月24日", "核准日期": "2025年03月14日", "登记机关": "北京市海淀区市场监督管理局", "注册地址": "北京市海淀区中关村东路1号院8号楼21层C2303", "经营状态": "存续", "经营范围": "一般项目：社会经济咨询服务；技术服务、技术开发、技术咨询、技术交流、技术转让、技术推广；计算机系统服务；软件开发；数据处理服务；法律咨询（不含依法须律师事务所执业许可的业务）；软件销售；信息技术咨询服务；销售代理；电子产品销售；人工智能基础软件开发；人工智能理论与算法软件开发。（除依法须经批准的项目外，凭营业执照依法自主开展经营活动）许可项目：互联网信息服务。（依法须经批准的项目，经相关部门批准后方可开展经营活动，具体经营项目以相关部门批准文件或许可证件为准）（不得从事国家和本市产业政策禁止和限制类项目的经营活动。）", "董事": "李东海，王琰，蔡建军，余晴燕，王映新，河清松", "监事": "孟芳芳", "经理": "蔡建军", "董事长": "郭颖", "财务负责人": "巩易", "核心成员": "巩易，李东海，王映新，孟芳芳，河清松，王琰，郭颖，余晴燕，蔡建军", "股东": "北京元典创新科技中心（有限合伙），北京元典成长科技中心（有限合伙），北京元典致知科技中心（有限合伙），北京元典起航科技中心（有限合伙），北京华宇软件股份有限公司，南京图灵一期创业投资合伙企业（有限合伙）", "股东详情": [ { "名称": "北京元典创新科技中心（有限合伙）", "股东类型": "法人股东", "认缴出资额": "", "实缴出资额": "", "出资比例": 0 }, { "名称": "北京元典成长科技中心（有限合伙）", "股东类型": "法人股东", "认缴出资额": "", "实缴出资额": "", "出资比例": 0 }, { "名称": "北京元典致知科技中心（有限合伙）", "股东类型": "法人股东", "认缴出资额": "", "实缴出资额": "", "出资比例": 0, "参股日期": "2019年05月13日" }, { "名称": "北京元典起航科技中心（有限合伙）", "股东类型": "法人股东", "认缴出资额": "", "实缴出资额": "", "出资比例": 0 }, { "名称": "北京华宇软件股份有限公司", "股东类型": "法人股东", "认缴出资额": "", "实缴出资额": "", "出资比例": 0 }, { "名称": "南京图灵一期创业投资合伙企业（有限合伙）", "股东类型": "法人股东", "认缴出资额": "", "实缴出资额": "", "出资比例": 0, "参股日期": "2020年06月16日" } ], "变更": [ { "变更项": "经营范围", "变更前": "经济贸易咨询；技术开发、技术推广、技术转让、技术咨询、技术服务；计算机技术培训（不得面向全国招生）；计算机系统服务；基础软件服务；应用软件服务；软件开发；数据处理（数据处理中的银行卡中心、PUE值在1.5以上的云计算数据中心除外）；销售电子产品、通讯设备、计算机、软件及辅助设备、机械设备、家用电器、化工产品（不含危险化学品及一类易制毒化学品）；互联网信息服务。（市场主体依法自主选择经营项目，开展经营活动；互联网信息服务以及依法须经批准的项目，经相关部门批准后依批准的内容开展经营活动；不得从事国家和本市产业政策禁止和限制类项目的经营活动。）", "变更后": "一般项目：社会经济咨询服务；技术服务、技术开发、技术咨询、技术交流、技术转让、技术推广；计算机系统服务；软件开发；数据处理服务；法律咨询（不含依法须律师事务所执业许可的业务）；软件销售；信息技术咨询服务；销售代理；电子产品销售；人工智能基础软件开发；人工智能理论与算法软件开发。（除依法须经批准的项目外，凭营业执照依法自主开展经营活动）许可项目：互联网信息服务。（依法须经批准的项目，经相关部门批准后方可开展经营活动，具体经营项目以相关部门批准文件或许可证件为准）（不得从事国家和本市产业政策禁止和限制类项目的经营活动。）", "变更时间": "2023年12月08日" }, { "变更项": "法定代表人", "变更前": "朱相宇", "变更后": "郭颖", "变更时间": "2022年03月17日" }, { "变更项": "董事（理事）、经理、监事", "变更前": "蔡建军，郭颖，李东海，孟芳芳，米坤，王琰，赵晓明，朱相宇*", "变更后": "蔡建军，郭颖*，李东海，孟芳芳，米坤，王琰，赵晓明，朱相宇", "变更时间": "2022年03月17日" }, { "变更项": "董事（理事）、经理、监事", "变更前": "蔡建军，李东海，孟芳芳，米坤，邵学，王琰，赵晓明，朱相宇*，邹劭坤", "变更后": "蔡建军，郭颖，李东海，孟芳芳，米坤，王琰，赵晓明，朱相宇*", "变更时间": "2022年02月22日" }, { "变更项": "法定代表人", "变更前": "邵学", "变更后": "朱相宇", "变更时间": "2021年11月05日" }, { "变更项": "董事（理事）、经理、监事", "变更前": "李东海，孟芳芳，米坤，邵学*，王琰，赵晓明，朱相宇，邹劭坤", "变更后": "蔡建军，李东海，孟芳芳，米坤，邵学，王琰，赵晓明，朱相宇*，邹劭坤", "变更时间": "2021年11月05日" }, { "变更项": "董事（理事）、经理、监事", "变更前": "李东海，米坤，邵学*，王琰，闻连茹，赵晓明，朱相宇，邹劭坤", "变更后": "李东海，孟芳芳，米坤，邵学*，王琰，赵晓明，朱相宇，邹劭坤", "变更时间": "2020年12月25日" }, { "变更项": "投资人", "变更前": "北京华宇软件股份有限公司，企业法人，北京元典成长科技中心（有限合伙），法人股东，北京元典创新科技中心（有限合伙），法人股东，北京元典起航科技中心（有限合伙），法人股东，北京元典致知科技中心（有限合伙），法人股东", "变更后": "北京华宇软件股份有限公司，企业法人，北京元典成长科技中心（有限合伙），法人股东，北京元典创新科技中心（有限合伙），法人股东，北京元典起航科技中心（有限合伙），法人股东，北京元典致知科技中心（有限合伙），法人股东，南京图灵一期创业投资合伙企业（有限合伙），法人股东", "变更时间": "2020年06月16日" }, { "变更项": "注册资本", "变更前": "6000万", "变更后": "6176.4706万", "变更时间": "2020年06月16日" }, { "变更项": "董事（理事）、经理、监事", "变更前": "黄福林，李东海，吕宾，米坤，邵学*，王琰，闻连茹，邹劭坤", "变更后": "李东海，米坤，邵学*，王琰，闻连茹，赵晓明，朱相宇，邹劭坤", "变更时间": "2020年06月16日" } ], "商标": [ { "名称": "元典元来", "申请日期": "2023年05月10日", "状态": "已注册", "开始日期": "2023年11月07日", "结束日期": "2033年11月06日" }, { "名称": "深之思", "申请日期": "2021年01月19日", "状态": "注册", "开始日期": "2021年11月21日", "结束日期": "2031年11月20日" }, { "名称": "深之思", "申请日期": "2021年01月19日", "状态": "已注册", "开始日期": "2021年11月21日", "结束日期": "2031年11月20日" }, { "名称": "深之思", "申请日期": "2021年01月19日", "状态": "注册", "开始日期": "2021年10月21日", "结束日期": "2031年10月20日" }, { "名称": "DOC KITE", "申请日期": "2020年10月19日", "状态": "注册", "开始日期": "2021年07月21日", "结束日期": "2031年07月20日" }, { "名称": "LAWAND", "申请日期": "2020年09月09日", "状态": "注册", "开始日期": "2021年07月07日", "结束日期": "2031年07月06日" }, { "名称": "DOC KITE", "申请日期": "2020年10月16日", "状态": "注册", "开始日期": "2021年06月28日", "结束日期": "2031年06月27日" }, { "名称": "DOC KITE", "申请日期": "2020年10月19日", "状态": "注册", "开始日期": "2021年06月21日", "结束日期": "2031年06月20日" }, { "名称": "DOC KITE", "申请日期": "2020年10月19日", "状态": "注册", "开始日期": "2021年06月21日", "结束日期": "2031年06月20日" }, { "名称": "DOC KITE", "申请日期": "2020年10月19日", "状态": "注册", "开始日期": "2021年06月21日", "结束日期": "2031年06月20日" } ], "软件著作权": [ { "批准日期": "2025年10月22日", "全称": "Amicus法律数字助手软件", "简称": "Amicus", "登记号": "2025SR2047374", "版本号": "V1.0" }, { "批准日期": "2025年03月20日", "全称": "金融案件趋势分析与风险预警系统", "简称": "金融案件趋势与预警系统", "登记号": "2025SR0490060", "分类号": "", "版本号": "V1.0.0" }, { "批准日期": "2025年01月26日", "全称": "法务低代码开发平台", "简称": "法务低代码", "登记号": "2025SR0180996", "分类号": "", "版本号": "V1.0" }, { "批准日期": "2024年11月06日", "全称": "元典合同智能审查平台", "简称": "大模型合同智审", "登记号": "2024SR1710228", "分类号": "", "版本号": "V1.5" }, { "批准日期": "2024年09月26日", "全称": "元典文本解析平台", "简称": "文本解析平台", "登记号": "2024SR1432158", "分类号": "", "版本号": "V2.0" }, { "批准日期": "2024年08月07日", "全称": "万象数字助理系统", "简称": "万象数字助理", "登记号": "2024SR1139489", "分类号": "", "版本号": "V2.4.3" }, { "批准日期": "2024年08月07日", "全称": "元典问达软件", "简称": "元典问达", "登记号": "2024SR1137121", "分类号": "", "版本号": "V2.0" }, { "批准日期": "2023年12月18日", "全称": "元典法律大语言模型系统", "简称": "元典大模型", "登记号": "2023SR1668514", "分类号": "", "版本号": "V3.0" }, { "批准日期": "2023年09月26日", "全称": "小至数字助手系统", "简称": "小至", "登记号": "2023SR1156917", "分类号": "", "版本号": "V1.5" }, { "批准日期": "2023年09月22日", "全称": "元来法律智能助手系统", "简称": "元来", "登记号": "2023SR1143545", "分类号": "", "版本号": "V1.5" } ], "专利": [ { "申请公布日": "2022-05-13", "专利名称": "争议焦点推荐方法及装置", "申请号": "CN202210089545.9", "申请公布号": "CN114490939A" }, { "申请公布日": "2022-05-10", "专利名称": "案件事实与法条匹配的方法及装置", "申请号": "CN202210123792.6", "申请公布号": "CN114461760A" }, { "申请公布日": "2022-05-03", "专利名称": "用于争议焦点裁判文书的筛选的模型的训练方法", "申请号": "CN202111632891.9", "申请公布号": "CN114428847A" }, { "申请公布日": "2021-11-12", "专利名称": "敏感词屏蔽质量评估模型的训练方法及相应的评估方法", "申请号": "CN202110924568.2", "申请公布号": "CN113642739A" }, { "申请公布日": "2021-10-29", "专利名称": "裁判文书人物关系识别方法、装置和电子设备", "申请号": "CN202110815292.4", "申请公布号": "CN113569046A" }, { "申请公布日": "2021-10-29", "专利名称": "裁判文书地址信息识别方法、装置和电子设备", "申请号": "CN202110815315.1", "申请公布号": "CN113570480A" }, { "申请公布日": "2021-05-14", "专利名称": "基于文本匹配的争议焦点推荐方法、装置和电子设备", "申请号": "CN202110120642.5", "申请公布号": "CN112800746A" }, { "申请公布日": "2021-05-11", "专利名称": "法律要素提取方法、装置和电子设备", "申请号": "CN202110279814.3", "申请公布号": "CN112784578A" }, { "申请公布日": "2021-04-16", "专利名称": "用于裁判文书的敏感身份信息的识别方法", "申请号": "CN202011622927.0", "申请公布号": "CN112667813A" }, { "申请公布日": "2020-09-01", "专利名称": "法律数据检索的评价方法、评价装置和电子设备", "申请号": "CN202010476485.7", "申请公布号": "CN111612658A" } ], "知识产权": [ { "名称": "元典元来", "申请日期": "2023年05月10日", "状态": "已注册", "开始日期": "2023年11月07日", "结束日期": "2033年11月06日" }, { "名称": "深之思", "申请日期": "2021年01月19日", "状态": "注册", "开始日期": "2021年11月21日", "结束日期": "2031年11月20日" }, { "名称": "深之思", "申请日期": "2021年01月19日", "状态": "已注册", "开始日期": "2021年11月21日", "结束日期": "2031年11月20日" }, { "名称": "深之思", "申请日期": "2021年01月19日", "状态": "注册", "开始日期": "2021年10月21日", "结束日期": "2031年10月20日" }, { "名称": "DOC KITE", "申请日期": "2020年10月19日", "状态": "注册", "开始日期": "2021年07月21日", "结束日期": "2031年07月20日" }, { "批准日期": "2025年10月22日", "全称": "Amicus法律数字助手软件", "简称": "Amicus", "登记号": "2025SR2047374", "版本号": "V1.0" }, { "批准日期": "2025年03月20日", "全称": "金融案件趋势分析与风险预警系统", "简称": "金融案件趋势与预警系统", "登记号": "2025SR0490060", "分类号": "", "版本号": "V1.0.0" }, { "批准日期": "2025年01月26日", "全称": "法务低代码开发平台", "简称": "法务低代码", "登记号": "2025SR0180996", "分类号": "", "版本号": "V1.0" }, { "批准日期": "2024年11月06日", "全称": "元典合同智能审查平台", "简称": "大模型合同智审", "登记号": "2024SR1710228", "分类号": "", "版本号": "V1.5" }, { "批准日期": "2024年09月26日", "全称": "元典文本解析平台", "简称": "文本解析平台", "登记号": "2024SR1432158", "分类号": "", "版本号": "V2.0" }, { "申请公布日": "2022-05-13", "专利名称": "争议焦点推荐方法及装置", "申请号": "CN202210089545.9", "申请公布号": "CN114490939A" }, { "申请公布日": "2022-05-10", "专利名称": "案件事实与法条匹配的方法及装置", "申请号": "CN202210123792.6", "申请公布号": "CN114461760A" }, { "申请公布日": "2022-05-03", "专利名称": "用于争议焦点裁判文书的筛选的模型的训练方法", "申请号": "CN202111632891.9", "申请公布号": "CN114428847A" }, { "申请公布日": "2021-11-12", "专利名称": "敏感词屏蔽质量评估模型的训练方法及相应的评估方法", "申请号": "CN202110924568.2", "申请公布号": "CN113642739A" }, { "申请公布日": "2021-10-29", "专利名称": "裁判文书人物关系识别方法、装置和电子设备", "申请号": "CN202110815292.4", "申请公布号": "CN113569046A" } ] } ], "message": "请求成功", "status": "success" } ``` ### 5.3 未找到响应示例 ```json { "data": null, "status": "notFound", "code": 404, "message": "未找到" } ``` ## 6. 代码示例 ### 6.1 CURL ```shell curl --location --request GET 'https://open.chineselaw.com/open/rh_company_info?name=北京华宇元典信息服务有限公司' \ --header 'X-API-Key: 你的api_key' \ --header 'Accept: application/json' ``` ### 6.2 Python ```python import requests BASE_URL = "https://open.chineselaw.com/open/rh_company_info" API_KEY = "你的api_key" # 替换为实际 Key params = {"name": "北京华宇元典信息服务有限公司"} headers = { "X-API-Key": API_KEY, "Accept": "application/json", } response = requests.get(BASE_URL, params=params, headers=headers, timeout=30) response.raise_for_status() print(response.json()) ``` ### 6.3 Java ```java import java.net.URI; import java.net.URLEncoder; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.nio.charset.StandardCharsets; import java.time.Duration; class CompanyInfoExample { static void main(String[] args) throws Exception { String apiKey = "你的api_key"; // 替换为实际 Key String name = URLEncoder.encode("北京华宇元典信息服务有限公司", StandardCharsets.UTF_8); String url = "https://open.chineselaw.com/open/rh_company_info?name=" + name; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create(url)) .timeout(Duration.ofSeconds(30)) .header("X-API-Key", apiKey) .header("Accept", "application/json") .GET() .build(); HttpClient client = HttpClient.newHttpClient(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode()); System.out.println(response.body()); } } ``` ### 6.4 JavaScript ```javascript const API_KEY = "你的api_key"; // 替换为实际 Key const name = encodeURIComponent("北京华宇元典信息服务有限公司"); const url = `https://open.chineselaw.com/open/rh_company_info?name=${name}`; const res = await fetch(url, { method: "GET", headers: { "X-API-Key": API_KEY, "Accept": "application/json", }, }); if (!res.ok) throw new Error(`HTTP NULL`); const data = await res.json(); console.log(data); ``` ## 7. 备注 - 本接口与 `companyDetail` 的差异：**本接口按名称/简称检索且返回列表**；`companyDetail` 支持 id / 信用代码 / 名称单条定位。 --- ## 法条详情接口 - Category: 法律法规 - ID: 13 - routeKey: `rh_ft_detail` - HTTP method: `POST` - Direct endpoint: `https://open.chineselaw.com/open/rh_ft_detail` - Detail JSON: `https://apiplatform.legalmind.cn/api/apis/13` - MCP tool: `yuandian_rh_ft_detail` - MCP server: `yuandian-law` at `https://open.chineselaw.com/mcp/law/stream` - Price: 1 POINT/call; chargeType=1 Description: 获取法条的详情信息。 ### Direct API Authentication ```http X-API-Key: YOUR_API_KEY Accept: application/json Content-Type: application/json; charset=utf-8 ``` ### MCP Authentication ```http Accept: application/json, text/event-stream Authorization: Bearer YOUR_API_KEY ``` ### Full Document # 法条详情接口 ## 1. 基本信息 - **接口名称**：法条详情接口 - **接口用途**：获取法条的详情信息。 - 当传入 `id` 时：优先按 `id` 直接查询 - 当未传 `id` 时：支持通过 `fgmc`（法规名称）与 `ftnum`（法条号/名）定位并返回对应详情 ## 2. 请求信息 - **HTTP Method**：POST - **URL**：`https://open.chineselaw.com/open/rh_ft_detail` - **Content-Type**：`application/json; charset=utf-8` - **Accept**：`application/json` - **X-API-Key**：`你的api_key` ## 3. 请求参数（Body） > `id` 与 `fgmc` 不能同时为空（否则返回 501）。 | 字段名 | 类型 | 是否必填 | 说明 | | ------------ | ------ | -------: | ------------------------------------------------------------ | | `id` | string | 否 | 详情目标 ID。 | | `fgmc` | string | 否 | 法规名称（当 `id` 为空时必填） | | `ftnum` | string | 否 | 法条号/名称（当 `id` 为空时必填） | | `refer_date` | string | 否 | 参考日期（用于确定当时生效的法律法规，如未提供，则为当前生效的版本，格式为yyyy-MM-dd） | ### 3.1 校验与默认值（按代码） - **body 为空 JSON**：返回失败 `message = "请求参数不能为空"` - **`id` 与 `fgmc` 同时为空**：返回失败（501）`message = "id和法规名称不可同时为空！" ## 4. 返回信息 - **返回类型**：JSON 字符串 ### 4.1 通用返回结构 | 字段名 | 类型 | 说明 | | --------- | -------------- | ------------------------------------- | | `status` | string | `success` / `failed` 等 | | `code` | number | 成功通常为 200/201；失败可能为 500/501 等 | | `message` | string | 提示信息 | | `data` | object \| null | 详情对象；异常时可能为 null | ### 4.2. 返回字段说明（data） #### 4.2.1 法条详情对象字段 | 字段名 | 类型 | 说明 | | --------- | ------ | ----------------------------------------------------------- | | `type` | string | 固定为 `法条` | | `id` | string | 法条文档 ID | | `fgid` | string | 所属法规 ID | | `tid` | string | 条编号，例如：100 | | `url` | string | 详情地址：`/zxt/statuteDetail/detailPage/{fgid}?text={tid}` | | `ftmc` | string | 法条名称，例如：中华人民共和国刑法(2023修正)第一百条 | | `title` | string | 同 `ftmc` | | `ft_num` | string | 法条号/名称，例如：第一百条 | | `fgmc` | string | 法规名称 | | `content` | string | 法条内容 | | `sxx` | string | 所属法规时效性 | | `xljb_1` | string | 所属法规效力级别-一级 | | `xljb_2` | string | 所属法规效力级别-二级 | | `fbrq` | string | 所属法规发布日期 | | `ssrq` | string | 所属法规实施日期 | ## 5. 示例 ### 5.1 请求示例（按法条 id 查询） ```json { "id": "aecabfbe6b0843642509a7f1ff865413_100" } ``` ### 5.2 请求示例（按法规名称 + 法条号定位法条） ```json { "fgmc": "中华人民共和国刑法", "ftnum": "第一百条", "refer_date": "2025-01-01" } ``` ### 5.3 成功响应示例（法条详情） ```json { "code": 200, "data": { "ft_num": "第一百条", "ssrq": "2024-03-01", "type": "法条", "title": "中华人民共和国刑法(2023修正)第一百条", "tid": "100", "url": "/zxt/statuteDetail/detailPage/aecabfbe6b0843642509a7f1ff865413?text=100", "content": "　【前科报告制度】依法受过刑事处罚的人，在入伍、就业的时候，应当如实向有关单位报告自己曾受过刑事处罚，不得隐瞒。\n犯罪的时候不满十八周岁被判处五年有期徒刑以下刑罚的人，免除前款规定的报告义务。", "sxx": "现行有效", "fgid": "aecabfbe6b0843642509a7f1ff865413", "ftmc": "中华人民共和国刑法(2023修正)第一百条", "fbrq": "2023-12-29", "xljb_2": "法律", "xljb_1": "法律", "fgmc": "中华人民共和国刑法(2023修正)", "id": "aecabfbe6b0843642509a7f1ff865413_100" }, "message": "请求成功", "status": "success" } ``` ### 5.4 失败响应示例（id 与 fgmc 同时为空） ```json { "data": null, "status": "failed", "code": 501, "message": "id和法规名称不可同时为空！" } ``` ### 5.5 失败响应示例（程序异常） ```json { "data": null, "status": "failed", "code": 500, "message": "程序处理异常" } ``` ## 6. 代码示例 ### 6.1 CURL ```shell curl --location --request POST "https://open.chineselaw.com/open/rh_ft_detail" \ --header "X-API-Key: 你的api_key" \ --header "Accept: application/json" \ --header "Content-Type: application/json; charset=utf-8" \ --data-raw "{\"fgmc\": \"中华人民共和国刑法\", \"ftnum\": \"第一百条\", \"refer_date\": \"2025-01-01\"}" ``` ### 6.2 Python ```python import requests url = "https://open.chineselaw.com/open/rh_ft_detail" API_KEY = "你的api_key" headers = { "X-API-Key": API_KEY, "Accept": "application/json", "Content-Type": "application/json; charset=utf-8", } payload = { "fgmc": "中华人民共和国刑法", "ftnum": "第一百条", "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 ```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 RhFtDetailExample { static void main(String[] args) throws Exception { String apiKey = "你的api_key"; String url = "https://open.chineselaw.com/open/rh_ft_detail"; String body = "{\"fgmc\":\"中华人民共和国刑法\",\"ftnum\":\"第一百条\",\"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 response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode()); System.out.println(response.body()); } } ``` ### 6.4 JavaScript ```javascript const API_KEY = "你的api_key"; const url = "https://open.chineselaw.com/open/rh_ft_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: "中华人民共和国刑法", ftnum: "第一百条", refer_date: "2025-01-01", }), }); if (!res.ok) throw new Error(`HTTP NULL`); console.log(await res.json()); ``` --- ## 法规详情接口 - Category: 法律法规 - ID: 12 - routeKey: `rh_fg_detail` - HTTP method: `POST` - Direct endpoint: `https://open.chineselaw.com/open/rh_fg_detail` - Detail JSON: `https://apiplatform.legalmind.cn/api/apis/12` - MCP tool: `yuandian_rh_fg_detail` - MCP server: `yuandian-law` at `https://open.chineselaw.com/mcp/law/stream` - Price: 5 POINT/call; chargeType=1 Description: 获取法规的详情信息。 ### Direct API Authentication ```http X-API-Key: YOUR_API_KEY Accept: application/json Content-Type: application/json; charset=utf-8 ``` ### MCP Authentication ```http Accept: application/json, text/event-stream Authorization: Bearer YOUR_API_KEY ``` ### Full Document # 法规详情接口 ## 1. 基本信息 - **接口名称**：法规详情接口 - **接口用途**：获取法规的详情信息。 - 当传入 `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）。 | 字段名 | 类型 | 是否必填 | 说明 | | ------------ | ------ | -------: | ------------------------------------------------------------ | | `id` | string | 否 | 详情目标 ID。 | | `fgmc` | string | 否 | 法规名称（当 `id` 为空时必填） | | `refer_date` | string | 否 | 参考日期（用于确定当时生效的法律法规，如未提供，则为当前生效的版本，格式为yyyy-MM-dd） | ### 3.1 校验与默认值（按代码） - **body 为空 JSON**：返回失败 `message = "请求参数不能为空"` - **`id` 与 `fgmc` 同时为空**：返回失败（501）`message = "id和法规名称不可同时为空！" ## 4. 返回信息 - **返回类型**：JSON 字符串 ### 4.1 通用返回结构 | 字段名 | 类型 | 说明 | | --------- | -------------- | ------------------------------------- | | `status` | string | `success` / `failed` 等 | | `code` | number | 成功通常为 200/201；失败可能为 500/501 等 | | `message` | string | 提示信息 | | `data` | object \| null | 详情对象；异常时可能为 null | ### 4.2 返回字段说明（data） #### 4.2.1 法规详情对象字段 当返回的是法规详情时，`data` 来自 `lawMap` 中的法规概要信息（可能包含 `content`）。 | 字段名 | 类型 | 说明 | | --------- | ------ | ---------------------------------------------- | | `id` | string | 法规 ID | | `fgid` | string | 同法规 ID | | `url` | string | 详情地址：`/zxt/statuteDetail/detailPage/{id}` | | `type` | string | 固定为 `法规` | | `fgmc` | string | 法规名称 | | `xljb_1` | string | 效力级别-一级 | | `xljb_2` | string | 效力级别-二级 | | `sxx` | string | 时效性 | | `fbrq` | string | 发布日期 | | `ssrq` | string | 实施日期 | | `fwzh` | string | 发文字号 | | `fbbm` | string | 发布部门/人员 | | `content` | string | 法规内容字段 | ## 5. 示例 ### 5.1 请求示例（按法规 id 查询） ```json { "id": "aecabfbe6b0843642509a7f1ff865413" } ``` ### 5.2 请求示例（按法规名称定查询） ```json { "fgmc": "中华人民共和国刑法", "refer_date": "2025-01-01" } ``` ### 5.3 成功响应示例（法规详情） ```json { "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 同时为空） ```json { "data": null, "status": "failed", "code": 501, "message": "id和法规名称不可同时为空！" } ``` ### 5.7 失败响应示例（程序异常） ```json { "data": null, "status": "failed", "code": 500, "message": "程序处理异常" } ``` ## 6. 代码示例 ### 6.1 CURL ```shell 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 ```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 ```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 response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode()); System.out.println(response.body()); } } ``` ### 6.4 JavaScript ```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()); ``` --- ## 法条关键词检索接口 - Category: 法律法规 - ID: 11 - routeKey: `rh_ft_search` - HTTP method: `POST` - Direct endpoint: `https://open.chineselaw.com/open/rh_ft_search` - Detail JSON: `https://apiplatform.legalmind.cn/api/apis/11` - MCP tool: `yuandian_rh_ft_search` - MCP server: `yuandian-law` at `https://open.chineselaw.com/mcp/law/stream` - Price: 10 POINT/call; chargeType=1 Description: 根据关键词检索法条内容，并可按法规名称、效力级别、时效性、发布日期/实施日期范围等条件过滤；返回法条列表并补充所属法规的关键信息。 ### Direct API Authentication ```http X-API-Key: YOUR_API_KEY Accept: application/json Content-Type: application/json; charset=utf-8 ``` ### MCP Authentication ```http Accept: application/json, text/event-stream Authorization: Bearer YOUR_API_KEY ``` ### Full Document # 法条关键词检索接口 ## 1. 基本信息 - **接口名称**：法条关键词检索接口 - **接口用途**：根据关键词检索法条内容，并可按法规名称、效力级别、时效性、发布日期/实施日期范围等条件过滤；返回法条列表并补充所属法规的关键信息。 ## 2. 请求信息 - **HTTP Method**：POST - **URL**：`https://open.chineselaw.com/open/rh_ft_search` - **Content-Type**：`application/json; charset=utf-8` - **Accept**：`application/json` - **X-API-Key**：`你的api_key` ## 3. 请求参数（Body） ### 3.1 字段说明 | 字段名 | 类型 | 是否必填 | 说明 | |---|---|---:|---| | `keyword` | string | 是 | 法条内容关键词；按 `search_mode` 将空格拆分并用 AND/OR 拼接成（queryString） | | `search_mode` | string | 否 | 关键词拼接模式，默认 `AND`；会转为大写（如 `AND`/`OR`） | | `fgmc` | string | 否 | 法规名称过滤；按空格拆分后，法规标题需全部命中 | | `xljb_1` | string | 否 | 效力级别过滤；按空格拆分后，命中任一即可；可选值：宪法、法律、司法解释、行政法规、监察法规、部门规章、党内法规、军事法规规章、立法机关工作文件、行政机关工作文件、行业/团体规范、地方性法规、自治条例和单行条例、地方司法文件、地方政府规章、地方规范性文件、地方律协规定； | | `sxx` | string | 否 | 时效性过滤；按空格拆分后，命中任一即可；可选值：现行有效、失效、已被修改、部分失效、尚未生效 | | `dy` | string | 否 | 地域过滤；按空格拆分后，命中任一即可；可选值：中央、北京、天津、河北、山西、内蒙古、辽宁、吉林、黑龙江、上海、江苏、浙江、安徽、福建、江西、山东、河南、湖北、湖南、广东、广西、海南、重庆、四川、贵州、云南、西藏、陕西、甘肃、青海、宁夏、新疆 | | `fbrq_start` | string | 否 | 发布日期起（含当前日期），格式为：yyyy-MM-dd | | `fbrq_end` | string | 否 | 发布日期止（含当前日期），格式为：yyyy-MM-dd | | `ssrq_start` | string | 否 | 实施日期起（含当前日期），格式为：yyyy-MM-dd | | `ssrq_end` | string | 否 | 实施日期止（含当前日期），格式为：yyyy-MM-dd | | `top_k` | number | 否 | 返回条数上限；默认 10；最大 50 | ### 3.2 校验与默认值（按代码） - **body 为空 JSON**：返回失败 `message = "请求参数不能为空"` - **`keyword` 为空**：返回失败（501）`message = "keyword 参数不可为空！"` - **`top_k` 默认/上限**： - 未传或 `<=0`：size = 10 - `>0`：size = top_k - `>50`：size = 50 - **`search_mode` 默认**： - 未传或为空：`AND` - 否则：转大写（如 `or` -> `OR`） ## 4. 返回信息 - **返回类型**：JSON 字符串 ### 4.1 通用返回结构 | 字段名 | 类型 | 说明 | |---|---|---| | `status` | string | `success` / `failed` 等 | | `code` | number | 成功通常为 200/201；失败可能为 500/501 等 | | `message` | string | 提示信息（成功通常为“请求成功”；异常时可能为“程序处理异常”等） | | `data` | object[] \| null | 命中时为列表；失败时可能为 null | ### 4.2 `data` 列表单条元素字段 | 字段名 | 类型 | 说明 | |---|---|---| | `id` | string | 法条文档 ID | | `_score` | number | ES score | | `ftmc` | string | `《法规名称》 + 法条名称`（实现为 `flmc + ftmc`） | | `title` | string | 同 `ftmc` | | `fgid` | string | 所属法规 ID | | `tid` | string | 法条编号 | | `url` | string | 详情地址：`/zxt/statuteDetail/detailPage/{fgid}?text={tid}` | | `content` | string | 法条内容（字段 `CONTENT`） | | `fgmc` | string | 法规名称（字段 `FLMC`） | | `ft_num` | string | 法条号/名称（字段 `FTMC`） | | `llm_content` | string | 形如：` - 《{fgmc}》{ft_num}##{content}`（`##` 为分隔符） | | `sxx` | string | 所属法规时效性 | | `dy` | string | 所属法规地域 | | `xljb_1` | string | 所属法规效力级别-一级 | | `xljb_2` | string | 所属法规效力级别-二级 | | `ssrq` | string | 所属法规实施日期 | | `fbrq` | string | 所属法规发布日期 | | `fbbm` | string | 所属法规发布部门 | | `fwzh` | string | 所属法规发文字号 | > 备注：上述法规回填字段只有在法规概要查询命中且能取到值时才会写入。 ## 5. 示例 ### 5.1 请求参数示例 ```json { "keyword": "行政处罚", "search_mode": "AND", "fgmc": "中华人民共和国行政处罚法", "sxx": "现行有效", "top_k": 10 } ``` ### 5.2 成功响应示例 ```json { "code": 200, "data": [ { "llm_content": " - 《中华人民共和国行政处罚法(2021修订)》第五十九条##　行政机关依照本法第五十七条的规定给予行政处罚，应当制作行政处罚决定书。行政处罚决定书应当载明下列事项： \n（一）当事人的姓名或者名称、地址； \n（二）违反法律、法规、规章的事实和证据； \n（三）行政处罚的种类和依据； \n（四）行政处罚的履行方式和期限； \n（五）申请行政复议、提起行政诉讼的途径和期限； \n（六）作出行政处罚决定的行政机关名称和作出决定的日期。 \n行政处罚决定书必须盖有作出行政处罚决定的行政机关的印章。", "ft_num": "第五十九条", "fbbm": "全国人大常委会", "ssrq": "2021-07-15", "_score": 52.875587, "title": "中华人民共和国行政处罚法(2021修订)第五十九条", "tid": "59", "url": "/zxt/statuteDetail/detailPage/0c15f68cf89e1339125e9f41d5d31c67?text=59", "content": "　行政机关依照本法第五十七条的规定给予行政处罚，应当制作行政处罚决定书。行政处罚决定书应当载明下列事项： \n（一）当事人的姓名或者名称、地址； \n（二）违反法律、法规、规章的事实和证据； \n（三）行政处罚的种类和依据； \n（四）行政处罚的履行方式和期限； \n（五）申请行政复议、提起行政诉讼的途径和期限； \n（六）作出行政处罚决定的行政机关名称和作出决定的日期。 \n行政处罚决定书必须盖有作出行政处罚决定的行政机关的印章。", "fwzh": "中华人民共和国主席令第70号", "sxx": "现行有效", "fgid": "0c15f68cf89e1339125e9f41d5d31c67", "ftmc": "中华人民共和国行政处罚法(2021修订)第五十九条", "fbrq": "2021-01-22", "xljb_2": "法律", "xljb_1": "法律", "fgmc": "中华人民共和国行政处罚法(2021修订)", "id": "0c15f68cf89e1339125e9f41d5d31c67_59" }, { "llm_content": " - 《中华人民共和国行政处罚法(2021修订)》第十一条##　行政法规可以设定除限制人身自由以外的行政处罚。 \n法律对违法行为已经作出行政处罚规定，行政法规需要作出具体规定的，必须在法律规定的给予行政处罚的行为、种类和幅度的范围内规定。 \n法律对违法行为未作出行政处罚规定，行政法规为实施法律，可以补充设定行政处罚。拟补充设定行政处罚的，应当通过听证会、论证会等形式广泛听取意见，并向制定机关作出书面说明。行政法规报送备案时，应当说明补充设定行政处罚的情况。", "ft_num": "第十一条", "fbbm": "全国人大常委会", "ssrq": "2021-07-15", "_score": 52.751797, "title": "中华人民共和国行政处罚法(2021修订)第十一条", "tid": "11", "url": "/zxt/statuteDetail/detailPage/0c15f68cf89e1339125e9f41d5d31c67?text=11", "content": "　行政法规可以设定除限制人身自由以外的行政处罚。 \n法律对违法行为已经作出行政处罚规定，行政法规需要作出具体规定的，必须在法律规定的给予行政处罚的行为、种类和幅度的范围内规定。 \n法律对违法行为未作出行政处罚规定，行政法规为实施法律，可以补充设定行政处罚。拟补充设定行政处罚的，应当通过听证会、论证会等形式广泛听取意见，并向制定机关作出书面说明。行政法规报送备案时，应当说明补充设定行政处罚的情况。", "fwzh": "中华人民共和国主席令第70号", "sxx": "现行有效", "fgid": "0c15f68cf89e1339125e9f41d5d31c67", "ftmc": "中华人民共和国行政处罚法(2021修订)第十一条", "fbrq": "2021-01-22", "xljb_2": "法律", "xljb_1": "法律", "fgmc": "中华人民共和国行政处罚法(2021修订)", "id": "0c15f68cf89e1339125e9f41d5d31c67_11" } ], "message": "请求成功", "status": "success" } ``` ### 5.3 失败响应示例（keyword 为空） ```json { "data": null, "status": "failed", "code": 501, "message": "keyword 参数不可为空！" } ``` ### 5.4 失败响应示例（程序异常） ```json { "data": null, "status": "failed", "code": 500, "message": "程序处理异常" } ``` ## 6. 代码示例 ### 6.1 CURL ```shell curl --location --request POST "https://open.chineselaw.com/open/rh_ft_search" \ --header "X-API-Key: 你的api_key" \ --header "Accept: application/json" \ --header "Content-Type: application/json; charset=utf-8" \ --data-raw "{\"keyword\": \"行政处罚\", \"search_mode\": \"AND\", \"fgmc\": \"中华人民共和国行政处罚法\", \"sxx\": \"现行有效\", \"top_k\": 2}" ``` ### 6.2 Python ```python import requests url = "https://open.chineselaw.com/open/rh_ft_search" API_KEY = "你的api_key" headers = { "X-API-Key": API_KEY, "Accept": "application/json", "Content-Type": "application/json; charset=utf-8", } payload = { "keyword": "行政处罚", "search_mode": "AND", "fgmc": "中华人民共和国行政处罚法", "sxx": "现行有效", "top_k": 2, } response = requests.post(url, json=payload, headers=headers, timeout=30) response.raise_for_status() print(response.json()) ``` ### 6.3 Java ```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 RhFtSearchExample { static void main(String[] args) throws Exception { String apiKey = "你的api_key"; String url = "https://open.chineselaw.com/open/rh_ft_search"; String body = "{\"keyword\":\"行政处罚\",\"search_mode\":\"AND\"," + "\"fgmc\":\"中华人民共和国行政处罚法\",\"sxx\":\"现行有效\",\"top_k\":2}"; 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 response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode()); System.out.println(response.body()); } } ``` ### 6.4 JavaScript ```javascript const API_KEY = "你的api_key"; const url = "https://open.chineselaw.com/open/rh_ft_search"; 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({ keyword: "行政处罚", search_mode: "AND", fgmc: "中华人民共和国行政处罚法", sxx: "现行有效", top_k: 2, }), }); if (!res.ok) throw new Error(`HTTP NULL`); console.log(await res.json()); ``` --- ## 法规关键词检索接口 - Category: 法律法规 - ID: 10 - routeKey: `rh_fg_search` - HTTP method: `POST` - Direct endpoint: `https://open.chineselaw.com/open/rh_fg_search` - Detail JSON: `https://apiplatform.legalmind.cn/api/apis/10` - MCP tool: `yuandian_rh_fg_search` - MCP server: `yuandian-law` at `https://open.chineselaw.com/mcp/law/stream` - Price: 10 POINT/call; chargeType=1 Description: 对法规（法规概要/大纲）进行关键词检索与条件过滤，返回法规列表；当传入 `keyword` 时，会返回命中内容的高亮片段（若可获取）。 ### Direct API Authentication ```http X-API-Key: YOUR_API_KEY Accept: application/json Content-Type: application/json; charset=utf-8 ``` ### MCP Authentication ```http Accept: application/json, text/event-stream Authorization: Bearer YOUR_API_KEY ``` ### Full Document # 法规关键词检索接口 ## 1. 基本信息 - **接口名称**：法规关键词检索接口 - **接口用途**：对法规（法规概要/大纲）进行关键词检索与条件过滤，返回法规列表；当传入 `keyword` 时，会返回命中内容的高亮片段（若可获取）。 ## 2. 请求信息 - **HTTP Method**：POST - **URL**：`https://open.chineselaw.com/open/rh_fg_search` - **Content-Type**：`application/json; charset=utf-8` - **Accept**：`application/json` - **X-API-Key**：`你的api_key` ## 3. 请求参数（Body） > 本接口 **允许不传 keyword**，不传则主要按过滤条件返回法规列表。 ### 3.1 字段说明 | 字段名 | 类型 | 是否必填 | 说明 | |---|---|---:|---| | `keyword` | string | 否 | 法规内容关键词；按 `search_mode` 将空格拆分并用 AND/OR 拼接成（queryString） | | `search_mode` | string | 否 | 关键词拼接模式，默认 `AND`；会转为大写（如 `AND`/`OR`） | | `fgmc` | string | 否 | 法规名称过滤；按空格拆分后，法规标题需全部命中 | | `sxx` | string | 否 | 时效性过滤；按空格拆分后，命中任一即可；可选值：现行有效、失效、已被修改、部分失效、尚未生效 | | `dy` | string | 否 | 地域过滤；按空格拆分后，命中任一即可；可选值：中央、北京、天津、河北、山西、内蒙古、辽宁、吉林、黑龙江、上海、江苏、浙江、安徽、福建、江西、山东、河南、湖北、湖南、广东、广西、海南、重庆、四川、贵州、云南、西藏、陕西、甘肃、青海、宁夏、新疆 | | `xljb_1` | string | 否 | 效力级别过滤；按空格拆分后，命中任一即可；可选值：宪法、法律、司法解释、行政法规、监察法规、部门规章、党内法规、军事法规规章、立法机关工作文件、行政机关工作文件、行业/团体规范、地方性法规、自治条例和单行条例、地方司法文件、地方政府规章、地方规范性文件、地方律协规定； | | `fbrq_start` | string | 否 | 发布日期起（含当前日期），格式为：yyyy-MM-dd | | `fbrq_end` | string | 否 | 发布日期止（含当前日期），格式为：yyyy-MM-dd | | `ssrq_start` | string | 否 | 实施日期起（含当前日期），格式为：yyyy-MM-dd | | `ssrq_end` | string | 否 | 实施日期止（含当前日期），格式为：yyyy-MM-dd | | `top_k` | number | 否 | 返回条数上限；默认 10；最大 50 | ### 3.2 校验与默认值 - **body 为空 JSON**：返回失败 `message = "请求参数不能为空"` - **`top_k` 默认/上限**： - 未传或 `<=0`：size = 10 - `>0`：size = top_k - `>50`：size = 50 - **`search_mode` 默认**： - 未传或为空：`AND` - 否则：转大写（如 `or` -> `OR`） ## 4. 返回信息 - **返回类型**：JSON 字符串 ### 4.1 通用返回结构 | 字段名 | 类型 | 说明 | |---|---|---| | `status` | string | `success` / `failed` 等 | | `code` | number | 成功通常为 20X；失败可能为 500 等 | | `message` | string | 提示信息（成功通常为“请求成功”；异常时可能为“程序处理异常”等） | | `data` | object[] \| null | 命中时为列表；失败时可能为 null | ### 4.2 `data` 列表单条元素字段 | 字段名 | 类型 | 说明 | |---|---|---| | `id` | string | 法规 ID | | `fgmc` | string | 法规名称 | | `title` | string | 同 `fgmc` | | `fbbm` | string | 发布部门 | | `fwzh` | string | 发文字号 | | `xljb_1` | string | 效力级别-一级 | | `xljb_2` | string | 效力级别-二级 | | `sxx` | string | 时效性 | | `dy` | string | 地域 | | `fbrq` | string | 发布日期 | | `ssrq` | string | 实施日期 | | `url` | string | 详情地址：`/zxt/statuteDetail/detailPage/{id}` | | `_score` | number | ES score | | `content` | string | **可选**：仅当传入 `keyword` 且命中高亮片段时返回（为高亮片段，不是全文） | ## 5. 示例 ### 5.1 请求参数示例（带 keyword） ```json { "keyword": "行政处罚", "search_mode": "AND", "fgmc": "中华人民共和国行政处罚法", "sxx": "现行有效", "top_k": 10 } ``` ### 5.2 请求参数示例（不带 keyword，仅过滤） ```json { "sxx": "现行有效", "xljb_1": "法律", "top_k": 10 } ``` ### 5.3 成功响应示例（data 为 list） ```json { "code": 200, "data": [ { "fbbm": "全国人大常委会", "ssrq": "2021-07-15", "title": "中华人民共和国行政处罚法(2021修订)", "_score": 63.246273, "url": "/zxt/statuteDetail/detailPage/0c15f68cf89e1339125e9f41d5d31c67", "content": "……（keyword 命中时的高亮片段）……", "fwzh": "中华人民共和国主席令第70号", "sxx": "现行有效", "fbrq": "2021-01-22", "xljb_2": "法律", "xljb_1": "法律", "fgmc": "中华人民共和国行政处罚法(2021修订)", "id": "0c15f68cf89e1339125e9f41d5d31c67" }, { "sxx": "现行有效", "fbrq": "1996-06-06", "xljb_2": "部门规范性文件", "xljb_1": "部门规章", "fgmc": "国家税务总局关于贯彻实施《中华人民共和国行政处罚法》的通知", "fbbm": "国家税务总局", "ssrq": "1996-06-06", "id": "174d6dcbe3762bb197b6481a7515d237", "title": "国家税务总局关于贯彻实施《中华人民共和国行政处罚法》的通知", "_score": 60.66238, "url": "/zxt/statuteDetail/detailPage/174d6dcbe3762bb197b6481a7515d237", "content": "……（keyword 命中时的高亮片段）……" } ], "message": "请求成功", "status": "success" } ``` ### 5.4 失败响应示例（程序异常） ```json { "data": null, "status": "failed", "code": 500, "message": "程序处理异常" } ``` ## 6. 代码示例 ### 6.1 CURL ```shell curl --location --request POST "https://open.chineselaw.com/open/rh_fg_search" \ --header "X-API-Key: 你的api_key" \ --header "Accept: application/json" \ --header "Content-Type: application/json; charset=utf-8" \ --data-raw "{\"keyword\": \"行政处罚\", \"search_mode\": \"AND\", \"fgmc\": \"中华人民共和国行政处罚法\", \"sxx\": \"现行有效\", \"top_k\": 2}" ``` ### 6.2 Python ```python import requests url = "https://open.chineselaw.com/open/rh_fg_search" API_KEY = "你的api_key" headers = { "X-API-Key": API_KEY, "Accept": "application/json", "Content-Type": "application/json; charset=utf-8", } payload = { "keyword": "行政处罚", "search_mode": "AND", "fgmc": "中华人民共和国行政处罚法", "sxx": "现行有效", "top_k": 2, } response = requests.post(url, json=payload, headers=headers, timeout=30) response.raise_for_status() print(response.json()) ``` ### 6.3 Java ```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 RhFgSearchExample { static void main(String[] args) throws Exception { String apiKey = "你的api_key"; String url = "https://open.chineselaw.com/open/rh_fg_search"; String body = "{\"keyword\":\"行政处罚\",\"search_mode\":\"AND\"," + "\"fgmc\":\"中华人民共和国行政处罚法\",\"sxx\":\"现行有效\",\"top_k\":2}"; 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 response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode()); System.out.println(response.body()); } } ``` ### 6.4 JavaScript ```javascript const API_KEY = "你的api_key"; const url = "https://open.chineselaw.com/open/rh_fg_search"; 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({ keyword: "行政处罚", search_mode: "AND", fgmc: "中华人民共和国行政处罚法", sxx: "现行有效", top_k: 2, }), }); if (!res.ok) throw new Error(`HTTP NULL`); console.log(await res.json()); ``` ## 7. 备注 - 该接口返回的是法规概要字段集合，默认 **不返回法规全文**； --- ## 案例详情接口 - Category: 案例文书 - ID: 9 - routeKey: `rh_case_details` - HTTP method: `GET` - Direct endpoint: `https://open.chineselaw.com/open/rh_case_details` - Detail JSON: `https://apiplatform.legalmind.cn/api/apis/9` - MCP tool: `yuandian_rh_case_details` - MCP server: `yuandian-case` at `https://open.chineselaw.com/mcp/case/stream` - Price: 5 POINT/call; chargeType=1 Description: 按类型 `type` 获取“普通案例(ptal)”或“权威案例(qwal)”的详情信息；支持按 `id` 或 `ah` 查询。 ### Direct API Authentication ```http X-API-Key: YOUR_API_KEY Accept: application/json ``` ### MCP Authentication ```http Accept: application/json, text/event-stream Authorization: Bearer YOUR_API_KEY ``` ### Full Document # 案例详情接口 ## 1. 基本信息 - **接口名称**：案例详情接口 - **接口用途**：按 `type` 获取“普通案例(ptal)”或“权威案例(qwal)”的详情信息；支持按 `id` 或 `ah` 查询。 ## 2. 请求信息 - **HTTP Method**：GET - **URL**：`https://open.chineselaw.com/open/rh_case_details` - **Accept**：`application/json` - **X-API-Key**：`你的api_key` ## 3. 请求参数（Query） > `id` 与 `ah` **至少提供一个**；`type` 用于区分普通/权威案例。 | 参数名 | 类型 | 是否必填 | 说明 | | ------ | ------ | -------: | --------------------------------------------- | | `id` | string | 否 | 案例标识 | | `ah` | string | 否 | 案号；当未传 `id` 时用于查询 | | `type` | string | 是 | 类型：`ptal`（普通案例）或 `qwal`（权威案例） | ### 3.1 校验规则（按代码） - **`id` 与 `ah` 同时为空**：返回失败 `message = "参数异常！"` - **`type` 非 `ptal/qwal`**：返回失败 `message = "不支持的type(xxx)类型"` ## 4. 返回信息 - **返回类型**：JSON 字符串 ### 4.1 通用返回结构（ResultVO） | 字段名 | 类型 | 说明 | | --------- | ------------------------ | ------------------------------------------------------------ | | `status` | string | `success` / `failed` 等 | | `code` | number | 成功通常为 200/201；失败通常为 500/501 等 | | `message` | string | 提示信息 | | `data` | object \| string \| null | 命中时为 list；未命中时通常为 null 且 message 为“未查询到相关内容” | ### 4.2. 返回字段说明（data=list） > 返回的 `data` 为列表，最多取 10 条。 #### 4.2.1 `type=ptal`（普通案例详情）字段 普通案例详情基础字段来自 `pt_detail_map`，并额外追加： - `type`：固定为 `普通案例` - `url`：`/ydzk/caseDetail/case/` + `id` | 字段名 | 类型 | 说明 | | ------------- | ------ | ----------------------------------------- | | `type` | string | 固定为 `普通案例` | | `id` | string | 案例 ID | | `ah` | string | 案号 | | `title` | string | 标题 | | `jbdw` | string | 经办法院 | | `ajlb` | string | 案件类别 | | `ajlx` | string | 案件类型 | | `spcx` | string | 审判程序 | | `wszl` | string | 文书种类 | | `ay` | string | 案由 | | `cprq` | string | 日期 | | `xzqh_p` | string | 省级行政区 | | `xzqh_c` | string | 市级行政区 | | `yyft` | string | 援引法条 | | `content` | string | 正文 | | `ajjbqk_zj` | string | 案件基本情况-证据段 | | `ajjbqk_bh` | string | 案件基本情况-辩护段 | | `ajjbqk_zk` | string | 案件基本情况-指控段 | | `ajjbqk_bssl` | string | 案件基本情况-本审审理段） | | `dsr` | string | 当事人段 | | `ssjl` | string | 诉讼记录段 | | `ajjbqk` | string | 案件基本情况段 | | `fxgc` | string | 分析过程段 | | `pjjg` | string | 判决结果段） | | `cmss` | string | 查明事实段 | | `ww` | string | 文尾 | | `url` | string | 详情 URL：`/ydzk/caseDetail/case/` + `id` | #### 4.2.2 `type=qwal`（权威案例详情）字段 权威案例详情基础字段来自 `qw_detail_map`，并额外追加： - `id`：案例 `_id` - `type`：固定为 `权威案例` - `url`：`/ydzk/caseDetail/qwcase/` + `id` | 字段名 | 类型 | 说明 | | --------- | ------ | ----------------- | | `id` | string | 案例 ID | | `type` | string | 固定为 `权威案例` | | `ah` | string | 案号 | | `title` | string | 标题 | | `jbdw` | string | 经办法院 | | `ajlb` | string | 案件类别 | | `spcx` | string | 审判程序 | | `wszl` | string | 文书种类 | | `ay` | string | 案由 | | `cprq` | string | 裁判日期 | | `xzqh_p` | string | 省级行政区 | | `xzqh_c` | string | 市级行政区 | | `content` | string | 正文 | | `url` | string | 详情 URL | ## 5. 示例 ### 5.1 请求示例（按 id 查询普通案例） `GET https://open.chineselaw.com/open/rh_case_details?id=xxx&type=ptal` ### 5.2 请求示例（按案号查询权威案例） `GET https://open.chineselaw.com/open/rh_case_details?ah=（2023）京0101民初123号&type=qwal` ### 5.3 成功响应示例（命中，data 为 list） ```json { "code": 200, "data": [ { "cprq": "2023年03月22日", "dsr": "原告：交通银行股份有限公司太平洋信用卡中心北京分中心，住所地北京市东城区和平里东街11号创新楼B座3-A1号。\n负责人：任志峰，总经理。\n委托诉讼代理人：刘勇，广东德法理（北京）律师事务所律师。\n委托诉讼代理人：李明明，广东德法理（北京）律师事务所律师。\n被告：李冬兵，男，1988年1月10日出生，汉族，户籍地黑龙江省绥化市。", "pjjg": "\n一、自本判决生效之日起十日内，李冬兵向交通银行股份有限公司太平洋信用卡中心北京分中心支付截至2022年5月26日的信用卡欠款本金36990元及利息、费用、手续费，并支付从2022年5月27日起至实际清偿之日止的利息、费用（利息、费用、手续费按照交通银行信用卡领用合约约定的起始时间、标准计算，上述利息、费用、手续费合计以不超过年利率24％为限；李冬兵于2022年5月27日之后偿还的款项，应按照交通银行信用卡领用合约约定标准在执行中予以扣除）；\n二、驳回交通银行股份有限公司太平洋信用卡中心北京分中心的其他诉讼请求。\n如果未按本判决指定的期间履行给付金钱义务，应当依照《中华人民共和国民事诉讼法》第二百六十条之规定，加倍支付迟延履行期间的债务利息。\n案件受理费1297.1元、公告费560元由李冬兵负担（于本判决书生效之日起七日内交纳）。\n如不服本判决，可于判决书送达之日起十五日内，向本院递交上诉状，并按对方当事人的人数提出副本，上诉于北京金融法院。", "type": "普通案例", "title": "交通银行股份有限公司太平洋信用卡中心北京分中心与李冬兵信用卡纠纷一审民事判决书", "xzqh_c": "二中院", "content": "北京市东城区人民法院\n民事判决书\n（2023）京0101民初123号\n原告：交通银行股份有限公司太平洋信用卡中心北京分中心，住所地北京市东城区和平里东街11号创新楼B座3-A1号。\n负责人：任志峰，总经理。\n委托诉讼代理人：刘勇，广东德法理（北京）律师事务所律师。\n委托诉讼代理人：李明明，广东德法理（北京）律师事务所律师。\n被告：李冬兵，男，1988年1月10日出生，汉族，户籍地黑龙江省绥化市。\n原告交通银行股份有限公司太平洋信用卡中心北京分中心与被告李冬兵信用卡纠纷一案，本院立案后，依法适用普通程序，公开开庭进行了审理。原告的委托诉讼代理人李明明到庭参加诉讼。被告李冬兵经本院公告送达开庭传票，未到庭参加诉讼，本院依法缺席审理。本案现已审理终结。\n原告向本院提出诉讼请求：1．判令被告支付原告截至2022年5月26日信用卡欠款共计人民币59883.96元（其中本金36990元，利息20196.52元，费用1372.88元，手续费1324.56元），并按《领用合约》的规定支付上述款项自2022年5月27日起至实际清偿之日止的利息、违约金及相关费用；2．被告承担本案诉讼费用。\n事实与理由：被告在原告处申请办理了交通银行太平洋信用卡，被告开卡消费后，未按《领用合约》的约定按期足额偿还其名下信用款欠款。截至2022年5月26日，被告因信用卡透支发生的欠款本息共计59883.96元，故原告诉至法院。\n被告未参加庭审，亦未进行答辩。\n经本院庭审质证，被告提交的信用卡申请表、交通银行太平洋个人贷记卡领用合约、欠款构成、交易明细、交通银行关于修订《交通银行太平洋信用卡章程》及相关领用合约的通告，原件与复印件一致，被告未出庭应诉，放弃了举证、质证的诉讼权利，故本院对上述证据的真实性、关联性、合法性予以认可。\n本院经审理查明，2018年2月3日，被告填写交通银行信用卡申请表，并签字确认已阅读全部申请材料，充分了解并清楚知晓该信用卡产品的相关信息，愿意遵守领用合同的各项规则。后，原告为被告办理了卡号为×××的信用卡，之后被告开始使用该信用卡进行透支消费。\n2016年11月15日，交通银行股份有限公司在其网站发布关于修订《交通银行太平洋信用卡章程》及相关领用合约的通告，记载：“我行对《交通银行太平洋信用卡章程》及相关领用合约进行了修订和完善，现将有关事项告知如下：1、修订后的章程及领用合约取消收取信用卡滞纳金；对于持卡人违约逾期未还款行为，约定收取相关违约金，并明确违约金的收取方式和标准；增加最低还款额计收标准和组成条款；完善预借现金业务相关业务规则等”。\n截至2022年5月26日，被告上述信用卡累计发生欠款本金36990元、利息20196.52元、费用1372.88元、手续费1324.56元。\n本院认为，当事人有对对方当事人的陈述及提交的证据进行答辩和质证的权利，被告经本院合法传唤，无正当理由拒不到庭应诉及质证，故本院依法缺席判决。\n被告在阅读并了解信用卡领用合约后，申请办理并使用信用卡，与原告形成合同关系，双方关于本金的约定不违反法律及行政法规的强制性规定，故关于原告主张的本金金额，本院予以支持。关于利息及其他费用，本院综合考虑国家有关金融监管规定、未还款的数额及期限、当事人过错程度、发卡行的实际损失等因素，根据公平原则和诚信原则予以衡量，本院确定利息及其他费用按照交通银行信用卡领用合约约定的起始时间、标准计算，但上述利息及其他费用合计以不超过年利率24％为限。综上所述，依照《中华人民共和国民法典》第五百零九条、第五百七十七条、第六百七十四条、第六百七十五条、第六百七十六条，《中华人民共和国民事诉讼法》第一百四十七条之规定，判决如下：\n一、自本判决生效之日起十日内，李冬兵向交通银行股份有限公司太平洋信用卡中心北京分中心支付截至2022年5月26日的信用卡欠款本金36990元及利息、费用、手续费，并支付从2022年5月27日起至实际清偿之日止的利息、费用（利息、费用、手续费按照交通银行信用卡领用合约约定的起始时间、标准计算，上述利息、费用、手续费合计以不超过年利率24％为限；李冬兵于2022年5月27日之后偿还的款项，应按照交通银行信用卡领用合约约定标准在执行中予以扣除）；\n二、驳回交通银行股份有限公司太平洋信用卡中心北京分中心的其他诉讼请求。\n如果未按本判决指定的期间履行给付金钱义务，应当依照《中华人民共和国民事诉讼法》第二百六十条之规定，加倍支付迟延履行期间的债务利息。\n案件受理费1297.1元、公告费560元由李冬兵负担（于本判决书生效之日起七日内交纳）。\n如不服本判决，可于判决书送达之日起十五日内，向本院递交上诉状，并按对方当事人的人数提出副本，上诉于北京金融法院。\n审判员张丹\n二〇二三年三月二十二日\n法官助理武景格\n书记员张潇雨", "ajjbqk_zj": "经本院庭审质证，被告提交的信用卡申请表、交通银行太平洋个人贷记卡领用合约、欠款构成、交易明细、交通银行关于修订《交通银行太平洋信用卡章程》及相关领用合约的通告，原件与复印件一致，被告未出庭应诉，放弃了举证、质证的诉讼权利，故本院对上述证据的真实性、关联性、合法性予以认可。", "ajjbqk_zk": "原告向本院提出诉讼请求：1．判令被告支付原告截至2022年5月26日信用卡欠款共计人民币59883.96元（其中本金36990元，利息20196.52元，费用1372.88元，手续费1324.56元），并按《领用合约》的规定支付上述款项自2022年5月27日起至实际清偿之日止的利息、违约金及相关费用；2．被告承担本案诉讼费用。\n事实与理由：被告在原告处申请办理了交通银行太平洋信用卡，被告开卡消费后，未按《领用合约》的约定按期足额偿还其名下信用款欠款。截至2022年5月26日，被告因信用卡透支发生的欠款本息共计59883.96元，故原告诉至法院。\n被告未参加庭审，亦未进行答辩。\n", "ssjl": "\n原告交通银行股份有限公司太平洋信用卡中心北京分中心与被告李冬兵信用卡纠纷一案，本院立案后，依法适用普通程序，公开开庭进行了审理。原告的委托诉讼代理人李明明到庭参加诉讼。被告李冬兵经本院公告送达开庭传票，未到庭参加诉讼，本院依法缺席审理。本案现已审理终结。", "yyft": [ "《中华人民共和国民法典》第六百七十五条", "《中华人民共和国民事诉讼法》第一百四十七条", "《中华人民共和国民法典》第五百零九条", "《中华人民共和国民法典》第五百七十七条", "《中华人民共和国民法典》第六百七十六条", "《中华人民共和国民法典》第六百七十四条", "《中华人民共和国民事诉讼法》第二百六十条" ], "ajjbqk_bssl": "本院经审理查明，2018年2月3日，被告填写交通银行信用卡申请表，并签字确认已阅读全部申请材料，充分了解并清楚知晓该信用卡产品的相关信息，愿意遵守领用合同的各项规则。后，原告为被告办理了卡号为×××的信用卡，之后被告开始使用该信用卡进行透支消费。\n2016年11月15日，交通银行股份有限公司在其网站发布关于修订《交通银行太平洋信用卡章程》及相关领用合约的通告，记载：“我行对《交通银行太平洋信用卡章程》及相关领用合约进行了修订和完善，现将有关事项告知如下：1、修订后的章程及领用合约取消收取信用卡滞纳金；对于持卡人违约逾期未还款行为，约定收取相关违约金，并明确违约金的收取方式和标准；增加最低还款额计收标准和组成条款；完善预借现金业务相关业务规则等”。\n截至2022年5月26日，被告上述信用卡累计发生欠款本金36990元、利息20196.52元、费用1372.88元、手续费1324.56元。", "ajlx": "民事一审案件", "id": "b4c197a45b9049443ed8ad053640d945", "fxgc": "本院认为，当事人有对对方当事人的陈述及提交的证据进行答辩和质证的权利，被告经本院合法传唤，无正当理由拒不到庭应诉及质证，故本院依法缺席判决。\n被告在阅读并了解信用卡领用合约后，申请办理并使用信用卡，与原告形成合同关系，双方关于本金的约定不违反法律及行政法规的强制性规定，故关于原告主张的本金金额，本院予以支持。关于利息及其他费用，本院综合考虑国家有关金融监管规定、未还款的数额及期限、当事人过错程度、发卡行的实际损失等因素，根据公平原则和诚信原则予以衡量，本院确定利息及其他费用按照交通银行信用卡领用合约约定的起始时间、标准计算，但上述利息及其他费用合计以不超过年利率24％为限。综上所述，依照《中华人民共和国民法典》第五百零九条、第五百七十七条、第六百七十四条、第六百七十五条、第六百七十六条，《中华人民共和国民事诉讼法》第一百四十七条之规定，判决如下：", "ww": " 审判员张丹 二〇二三年三月二十二日 法官助理武景格 书记员张潇雨", "cmss": "本院经审理查明，2018年2月3日，被告填写交通银行信用卡申请表，并签字确认已阅读全部申请材料，充分了解并清楚知晓该信用卡产品的相关信息，愿意遵守领用合同的各项规则。后，原告为被告办理了卡号为×××的信用卡，之后被告开始使用该信用卡进行透支消费。 2016年11月15日，交通银行股份有限公司在其网站发布关于修订《交通银行太平洋信用卡章程》及相关领用合约的通告，记载：“我行对《交通银行太平洋信用卡章程》及相关领用合约进行了修订和完善，现将有关事项告知如下：1、修订后的章程及领用合约取消收取信用卡滞纳金；对于持卡人违约逾期未还款行为，约定收取相关违约金，并明确违约金的收取方式和标准；增加最低还款额计收标准和组成条款；完善预借现金业务相关业务规则等”。 截至2022年5月26日，被告上述信用卡累计发生欠款本金36990元、利息20196.52元、费用1372.88元、手续费1324.56元。", "ah": "（2023）京0101民初123号", "spcx": "一审案件", "url": "/ydzk/caseDetail/case/b4c197a45b9049443ed8ad053640d945", "ajlb": "民事案件", "ajjbqk": "\n原告向本院提出诉讼请求：1．判令被告支付原告截至2022年5月26日信用卡欠款共计人民币59883.96元（其中本金36990元，利息20196.52元，费用1372.88元，手续费1324.56元），并按《领用合约》的规定支付上述款项自2022年5月27日起至实际清偿之日止的利息、违约金及相关费用；2．被告承担本案诉讼费用。\n事实与理由：被告在原告处申请办理了交通银行太平洋信用卡，被告开卡消费后，未按《领用合约》的约定按期足额偿还其名下信用款欠款。截至2022年5月26日，被告因信用卡透支发生的欠款本息共计59883.96元，故原告诉至法院。\n被告未参加庭审，亦未进行答辩。\n经本院庭审质证，被告提交的信用卡申请表、交通银行太平洋个人贷记卡领用合约、欠款构成、交易明细、交通银行关于修订《交通银行太平洋信用卡章程》及相关领用合约的通告，原件与复印件一致，被告未出庭应诉，放弃了举证、质证的诉讼权利，故本院对上述证据的真实性、关联性、合法性予以认可。\n本院经审理查明，2018年2月3日，被告填写交通银行信用卡申请表，并签字确认已阅读全部申请材料，充分了解并清楚知晓该信用卡产品的相关信息，愿意遵守领用合同的各项规则。后，原告为被告办理了卡号为×××的信用卡，之后被告开始使用该信用卡进行透支消费。\n2016年11月15日，交通银行股份有限公司在其网站发布关于修订《交通银行太平洋信用卡章程》及相关领用合约的通告，记载：“我行对《交通银行太平洋信用卡章程》及相关领用合约进行了修订和完善，现将有关事项告知如下：1、修订后的章程及领用合约取消收取信用卡滞纳金；对于持卡人违约逾期未还款行为，约定收取相关违约金，并明确违约金的收取方式和标准；增加最低还款额计收标准和组成条款；完善预借现金业务相关业务规则等”。\n截至2022年5月26日，被告上述信用卡累计发生欠款本金36990元、利息20196.52元、费用1372.88元、手续费1324.56元。\n", "ay": [ "信用卡纠纷" ], "wszl": "判决书", "xzqh_p": "北京" } ], "message": "请求成功", "status": "success" } ``` ### 5.4 成功响应示例（未命中） ```json { "data": null, "status": "success", "code": 200, "message": "未查询到相关内容" } ``` ### 5.5 失败响应示例（id 与 ah 同时为空） ```json { "data": null, "status": "failed", "code": 500, "message": "参数异常！" } ``` ### 5.6 失败响应示例（type 不支持） ```json { "data": null, "status": "failed", "code": 500, "message": "不支持的type(xxx)类型" } ``` ## 6. 代码示例 ### 6.1 CURL ```shell curl --location --request GET "https://open.chineselaw.com/open/rh_case_details?ah=（2023）京0101民初123号&type=ptal" \ --header "X-API-Key: 你的api_key" \ --header "Accept: application/json" ``` ### 6.2 Python ```python import requests BASE_URL = "https://open.chineselaw.com/open/rh_case_details" API_KEY = "你的api_key" params = { "ah": "（2023）京0101民初123号", "type": "ptal", } headers = { "X-API-Key": API_KEY, "Accept": "application/json", } response = requests.get(BASE_URL, params=params, headers=headers, timeout=30) response.raise_for_status() print(response.json()) ``` ### 6.3 Java ```java import java.net.URI; import java.net.URLEncoder; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.nio.charset.StandardCharsets; import java.time.Duration; class RhCaseDetailsExample { static void main(String[] args) throws Exception { String apiKey = "你的api_key"; String ah = URLEncoder.encode("（2023）京0101民初123号", StandardCharsets.UTF_8); String type = URLEncoder.encode("ptal", StandardCharsets.UTF_8); String url = "https://open.chineselaw.com/open/rh_case_details?ah=" + ah + "&type=" + type; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create(url)) .timeout(Duration.ofSeconds(30)) .header("X-API-Key", apiKey) .header("Accept", "application/json") .GET() .build(); HttpClient client = HttpClient.newHttpClient(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode()); System.out.println(response.body()); } } ``` ### 6.4 JavaScript ```javascript const API_KEY = "你的api_key"; const ah = encodeURIComponent("（2023）京0101民初123号"); const type = encodeURIComponent("ptal"); const url = `https://open.chineselaw.com/open/rh_case_details?ah=${ah}&type=${type}`; const res = await fetch(url, { method: "GET", headers: { "X-API-Key": API_KEY, "Accept": "application/json", }, }); if (!res.ok) throw new Error(`HTTP NULL`); console.log(await res.json()); ``` ## 7. 备注 - 详情接口返回的 `data` 为列表（最多 10 条），消费方请按 list 解析。 --- ## 权威案例关键词检索接口 - Category: 案例文书 - ID: 8 - routeKey: `rh_qwal_search` - HTTP method: `POST` - Direct endpoint: `https://open.chineselaw.com/open/rh_qwal_search` - Detail JSON: `https://apiplatform.legalmind.cn/api/apis/8` - MCP tool: `yuandian_rh_qwal_search` - MCP server: `yuandian-case` at `https://open.chineselaw.com/mcp/case/stream` - Price: 10 POINT/call; chargeType=1 Description: 对“权威案例”库进行多条件/关键词检索，返回命中的案例列表（优先返回要旨/摘要）与命中总数。 ### Direct API Authentication ```http X-API-Key: YOUR_API_KEY Accept: application/json Content-Type: application/json; charset=utf-8 ``` ### MCP Authentication ```http Accept: application/json, text/event-stream Authorization: Bearer YOUR_API_KEY ``` ### Full Document # 权威案例关键词检索接口 ## 1. 基本信息 - **接口名称**：权威案例关键词检索接口 - **接口用途**：对“权威案例”库进行多条件/关键词检索，返回命中的案例列表（优先返回要旨/摘要）与命中总数。 ## 2. 请求信息 - **HTTP Method**：POST - **URL**：`https://open.chineselaw.com/open/rh_qwal_search` - **Content-Type**：`application/json; charset=utf-8` - **Accept**：`application/json` - **X-API-Key**：`你的api_key` ## 3. 请求参数（Body） > 以下字段均为可选字段，但 **请求体不能为空**（空 JSON 会返回失败）。 ### 3.1 字段说明 | 字段名 | 类型 | 是否必填 | 说明 | |---|---|---:|---| | `ah` | string | 否 | 案号 | | `title` | string | 否 | 标题（queryString 精确短语匹配） | | `ay` | string[] | 否 | 案由数组；多值为或关系 | | `jbdw` | string[] | 否 | 经办法院数组；多值为或关系 | | `xzqh_p` | string[] | 否 | 省级行政区数组，可选值：北京、天津、河北、山西、内蒙古、辽宁、吉林、黑龙江、上海、江苏、浙江、安徽、福建、江西、山东、河南、湖北、湖南、广东、广西、海南、重庆、四川、贵州、云南、西藏、陕西、甘肃、青海、宁夏、新疆、最高、新疆生产建设兵团；多值为或关系 | | `wszl` | string[] | 否 | 文书种类数组，可选值：判决书、裁定书、调解书、决定书；多值为或关系 | | `ajlb` | string | 否 | 案件类别，可选值：刑事案件、民事案件、行政案件、执行案件、管辖案件、国家赔偿与司法救助案件、强制清算与破产案件、国际司法协助案件、非诉保全审查案件、其他案件" | | `ja_start` | string | 否 | 裁判日期起（含当前日期），格式为：yyyy-MM-dd | | `ja_end` | string | 否 | 裁判日期止（含当前日期），格式为：yyyy-MM-dd | | `qw` | string | 否 | 全文关键词（按 `search_mode` 将空格拆分并用 AND/OR 拼接成 queryString） | | `search_mode` | string | 否 | 关键词拼接模式：`and` 或 `or`；为空默认 `and`；非法会返回失败 | | `top_k` | number | 否 | 返回条数上限：默认 10；最大 50；小于等于 0 会按默认 10 处理 | ### 3.2 校验与默认值（按代码） - **body 为空 JSON**：返回失败 `message = "请求参数不能为空"` - **`search_mode` 非法**：返回失败 `message = "search_mode 不合法"` - **`search_mode` 默认**：未传或为空 -> `and` - **`top_k` 默认/上限**： - `top_k <= 0` -> 10 - `top_k > 50` -> 50 ## 4. 返回信息 - **返回类型**：JSON 字符串 - **成功/失败判断**：看 `status` 与 `code` ### 4.1 通用返回结构 | 字段名 | 类型 | 说明 | |---|---|---| | `status` | string | `success` / `failed` 等 | | `code` | number | 成功通常为 200/201；失败通常为 500/501 等 | | `message` | string | 提示信息（例如“请求成功”、“请求参数不能为空”、“未查询到相关内容”等） | | `data` | object \| null | 业务数据；未命中时可能为 null（返回的是 success + message） | ### 4.2 `data` 字段（命中时） `data` 为对象，包含： | 字段名 | 类型 | 说明 | |---|---|---| | `total` | object | ES 命中总数 | | `lst` | object[] | 命中列表 | ### 4.3 `lst` 单条元素字段 > 返回列表的基础字段来自 `qw_map`。 | 字段名 | 类型 | 说明 | |---|---|---| | `type` | string | 固定为 `权威案例` | | `id` | string | 案例 ID | | `ah` | string | 案号 | | `title` | string | 标题 | | `ay` | string | 案由） | | `jbdw` | string | 经办法院 | | `ajlb` | string | 案件类别 | | `xzqh_p` | string | 省级行政区 | | `wszl` | string | 文书种类 | | `cprq` | string | 裁判日期 | | `content` | string | 内容：优先取（要旨/摘要）；若为空则回退取全文字段 | | `llm_content` | string | 拼接字段：`##` | | `url` | string | 详情 URL：`/ydzk/caseDetail/qwcase/` + `id` | | `score` | number | ES score | ## 5. 示例 ### 5.1 请求参数示例 ```json { "title": "买卖合同纠纷", "ay": ["买卖合同纠纷"], "ajlb": "民事", "ja_start": "2023-01-01", "ja_end": "2023-12-31", "qw": "违约金 逾期", "top_k": 2 } ``` ### 5.2 成功响应示例（命中） ```json { "code": 200, "data": { "total": 2, "lst": [ { "cprq": "2023年12月25日", "llm_content": "null##基本案情：某发电公司在上海某产权交易所公开挂牌交易部分资产。2020年10月21日，某金属材料公司（乙方）与某发电公司（甲方）签订资产交易合同，约定价款922万元、一次性付款，合同生效后10个工作日内完成权利交接，交易所出具交易凭证后2个工作日内移交资产。甲方如逾期进行权利交接，每逾期一日按交易价款的3‰支付违约金。另约定，某发电公司在合同签订后5个工作日内将交易手续费支付至指定账户，交易所在双方手续费到账后3个工作日内出具资产交易凭证。其后，某金属材料公司缴纳了手续费和价款。2020年11月18日，交易所出具资产交易凭证。11月27日，某金属材料公司与某发电公司完成实物移交。\n\n一审情况：2021年2月3日，某金属材料公司起诉至陕西省宝鸡市凤翔区人民法院，请求判令某发电公司支付逾期交货违约金497880元。一审法院认为，根据合同约定，某发电公司应于2020年10月28日之前缴纳交易手续费，2020年11月4日前配合完成产权主体权利交接。某发电公司实际于2020年11月16日缴纳手续费，双方完成交接为2020年11月27日。某发电公司逾期缴纳手续费，进而导致违反合同约定，未与某金属材料公司按时完成权利交接和资产移交，违约17天，依据双方每逾期一日按交易价款3‰支付违约金的标准计算，应支付违约金470220元。据此，一审判决：某发电公司支付违约金470220元。\n\n二审情况：某发电公司上诉认为违约金过高、请求法院调减。宝鸡市中级人民法院二审认为，某发电公司违约，应当赔偿违约金。但合同约定的违约金标准过高，遂参照合同成立时同期全国银行间同业拆借中心公布的一年期贷款市场报价利率标准四倍调整违约金。改判某发电公司赔偿违约金67050元。某金属材料公司向陕西省高级人民法院申请再审被驳回。\n\n检察机关履职情况：某金属材料公司向陕西省宝鸡市人民检察院申请监督。检察机关依法受理后，通过调阅诉讼卷宗，询问双方当事人，审查认为：第一，生效判决认定案涉违约金过高，缺乏证据证明。双方均为商事主体，经协商一致约定违约赔偿数额的计算标准。案涉违约金未超过某发电公司订立合同时预见到或应当预见到的因违约可能造成的损失。某发电公司请求调减违约金并未提交相关证据证明双方约定过高，二审法院直接认定约定的违约金标准过高并调低，无事实依据。第二，生效判决将约定违约金调减为一年期贷款市场报价利率标准四倍，缺乏法律依据。双方资产交易并非借贷关系，违约金认定不能采取逾期还款违约责任计算方式，人民法院应依据法律规定和当事人意思自治，根据公平原则和诚实信用原则确定违约责任，避免过当行使自由裁量权，干预市场主体自主经营活动。\n\n再审情况：陕西省人民检察院认为生效判决认定违约金过高予以调减，缺乏事实和法律依据，于2023年8月8日向陕西省高级人民法院提出抗诉。陕西省高级人民法院裁定指令宝鸡市中级人民法院再审该案。宝鸡市中级人民法院再审认为，双方当事人均系公司法人，具有远高于一般自然人的理性判断，能够预见和合理判断违约行为将产生的法律后果，且某发电公司未能举证证实约定的违约金过分高于实际损失，原审判决适用法律错误，结果不当，应予撤销。2023年12月25日，宝鸡市中级人民法院采纳抗诉意见，作出再审判决：撤销二审判决，维持一审判决。2024年1月8日，某发电公司履行再审判决确定的470220元违约金给付义务。\n\n典型意义：习近平总书记指出：社会主义市场经济是信用经济、法治经济。诚信原则被称为帝王条款，是民法基本原则之一。《中华人民共和国民法典》第七条规定：民事主体从事民事活动，应当遵循诚信原则，秉持诚实，恪守承诺。第五百零九条第一款规定：当事人应当按照约定全面履行自己的义务。诚信与法治是现代市场经济健康、高效、有序运行的基石，也是社会主义核心价值观的重要内容。各类民事主体均应尊重和遵循契约精神，践行重信守诺的行为规则和原则。民商事交易的基础是当事人相互信任，尊重契约，如果一方主体不恪守承诺、违背诚信就必须承担违约金、损害赔偿金等法律责任，这是法律对诚信价值的基本保障。检察机关在履行民事检察监督职能中，要依法全面审查案件，准确区分把握民商事交易的不同特性，正确判断当事人约定违约金的合法性和公平性。要以精准办案保障社会诚信和法治体系建设，引导民事主体恪守契约精神，诚实经营交易，养成信守约定和承诺的观念。要以检察监督助推人民法院规范行使自由裁量权，确保合同纠纷案件中违约金酌减规则的正确适用，为市场经济发展提供有力司法保障。", "type": "典型案例", "title": "最高人民检察院发布6起检察机关依法履职推动社会主义核心价值观融入法治建设典型案例之六：陕西检察机关对某金属材料公司与某发电公司买卖合同纠纷抗诉案", "content": "基本案情：某发电公司在上海某产权交易所公开挂牌交易部分资产。2020年10月21日，某金属材料公司（乙方）与某发电公司（甲方）签订资产交易合同，约定价款922万元、一次性付款，合同生效后10个工作日内完成权利交接，交易所出具交易凭证后2个工作日内移交资产。甲方如逾期进行权利交接，每逾期一日按交易价款的3‰支付违约金。另约定，某发电公司在合同签订后5个工作日内将交易手续费支付至指定账户，交易所在双方手续费到账后3个工作日内出具资产交易凭证。其后，某金属材料公司缴纳了手续费和价款。2020年11月18日，交易所出具资产交易凭证。11月27日，某金属材料公司与某发电公司完成实物移交。\n\n一审情况：2021年2月3日，某金属材料公司起诉至陕西省宝鸡市凤翔区人民法院，请求判令某发电公司支付逾期交货违约金497880元。一审法院认为，根据合同约定，某发电公司应于2020年10月28日之前缴纳交易手续费，2020年11月4日前配合完成产权主体权利交接。某发电公司实际于2020年11月16日缴纳手续费，双方完成交接为2020年11月27日。某发电公司逾期缴纳手续费，进而导致违反合同约定，未与某金属材料公司按时完成权利交接和资产移交，违约17天，依据双方每逾期一日按交易价款3‰支付违约金的标准计算，应支付违约金470220元。据此，一审判决：某发电公司支付违约金470220元。\n\n二审情况：某发电公司上诉认为违约金过高、请求法院调减。宝鸡市中级人民法院二审认为，某发电公司违约，应当赔偿违约金。但合同约定的违约金标准过高，遂参照合同成立时同期全国银行间同业拆借中心公布的一年期贷款市场报价利率标准四倍调整违约金。改判某发电公司赔偿违约金67050元。某金属材料公司向陕西省高级人民法院申请再审被驳回。\n\n检察机关履职情况：某金属材料公司向陕西省宝鸡市人民检察院申请监督。检察机关依法受理后，通过调阅诉讼卷宗，询问双方当事人，审查认为：第一，生效判决认定案涉违约金过高，缺乏证据证明。双方均为商事主体，经协商一致约定违约赔偿数额的计算标准。案涉违约金未超过某发电公司订立合同时预见到或应当预见到的因违约可能造成的损失。某发电公司请求调减违约金并未提交相关证据证明双方约定过高，二审法院直接认定约定的违约金标准过高并调低，无事实依据。第二，生效判决将约定违约金调减为一年期贷款市场报价利率标准四倍，缺乏法律依据。双方资产交易并非借贷关系，违约金认定不能采取逾期还款违约责任计算方式，人民法院应依据法律规定和当事人意思自治，根据公平原则和诚实信用原则确定违约责任，避免过当行使自由裁量权，干预市场主体自主经营活动。\n\n再审情况：陕西省人民检察院认为生效判决认定违约金过高予以调减，缺乏事实和法律依据，于2023年8月8日向陕西省高级人民法院提出抗诉。陕西省高级人民法院裁定指令宝鸡市中级人民法院再审该案。宝鸡市中级人民法院再审认为，双方当事人均系公司法人，具有远高于一般自然人的理性判断，能够预见和合理判断违约行为将产生的法律后果，且某发电公司未能举证证实约定的违约金过分高于实际损失，原审判决适用法律错误，结果不当，应予撤销。2023年12月25日，宝鸡市中级人民法院采纳抗诉意见，作出再审判决：撤销二审判决，维持一审判决。2024年1月8日，某发电公司履行再审判决确定的470220元违约金给付义务。\n\n典型意义：习近平总书记指出：社会主义市场经济是信用经济、法治经济。诚信原则被称为帝王条款，是民法基本原则之一。《中华人民共和国民法典》第七条规定：民事主体从事民事活动，应当遵循诚信原则，秉持诚实，恪守承诺。第五百零九条第一款规定：当事人应当按照约定全面履行自己的义务。诚信与法治是现代市场经济健康、高效、有序运行的基石，也是社会主义核心价值观的重要内容。各类民事主体均应尊重和遵循契约精神，践行重信守诺的行为规则和原则。民商事交易的基础是当事人相互信任，尊重契约，如果一方主体不恪守承诺、违背诚信就必须承担违约金、损害赔偿金等法律责任，这是法律对诚信价值的基本保障。检察机关在履行民事检察监督职能中，要依法全面审查案件，准确区分把握民商事交易的不同特性，正确判断当事人约定违约金的合法性和公平性。要以精准办案保障社会诚信和法治体系建设，引导民事主体恪守契约精神，诚实经营交易，养成信守约定和承诺的观念。要以检察监督助推人民法院规范行使自由裁量权，确保合同纠纷案件中违约金酌减规则的正确适用，为市场经济发展提供有力司法保障。", "url": "/ydzk/caseDetail/qwcase/573c3f61efd08baa545121a12a007685", "score": 21.300636, "ajlb": "民事案件", "ay": [ "合同、准合同纠纷", "合同纠纷", "买卖合同纠纷" ], "wszl": "判决书", "jbdw": "陕西省宝鸡市中级人民法院", "id": "573c3f61efd08baa545121a12a007685" }, { "cprq": "2023年11月15日", "llm_content": "（2023）鲁02民辖终472号##裁判要旨：合同约定或裁或诉条款，仲裁协议被确认无效的，诉讼管辖约定的效力应当单独予以认定。诉讼管辖约定符合《中华人民共和国民事诉讼法》第三十五条规定的，应当认定有效。\n基本案情：青岛某公司与陕西某公司签订《水处理设备供货改造分包合同》，约定青岛某公司向陕西某公司供应水处理设备，合同总金额58万元。合同争议解决条款约定：协商不能解决的，(1)提交西安市仲裁委员会仲裁，(2)依法向需方所在地人民法院起诉或按《中华人民共和国合同法》有关规定解决。青岛某公司履行合同义务后，陕西某公司支付货款30万元，剩余28万元未付。青岛某公司向山东省平度市人民法院起诉，请求支付剩余货款及违约金等。陕西某公司提出管辖权异议，认为需方所在地为陕西省西安市雁塔区，本案应由陕西省西安市雁塔区人民法院管辖。\n裁判分析：争议焦点为案涉合同中或裁或诉条款的效力及管辖法院的确定。相关事实和细节：合同约定协商不成可提交西安市仲裁委员会仲裁或向需方所在地人民法院起诉。法院分析思路及结论依据：根据《最高人民法院关于适用＜中华人民共和国仲裁法＞若干问题的解释》第七条，当事人约定争议可向仲裁机构申请仲裁也可向人民法院起诉的，仲裁协议无效。故案涉合同中仲裁约定无效，但诉讼管辖约定有效，本案应由需方陕西某公司所在地的陕西省西安市雁塔区人民法院管辖，山东省平度市人民法院对本案无管辖权。\n判决结果：一审裁定本案移送陕西省西安市雁塔区人民法院处理；二审裁定驳回上诉，维持原裁定。", "ah": "（2023）鲁02民辖终472号", "type": "参考案例", "title": "青岛某源热能设备有限公司诉陕西某光锅炉销售有限公司买卖合同纠纷案", "content": "裁判要旨：合同约定或裁或诉条款，仲裁协议被确认无效的，诉讼管辖约定的效力应当单独予以认定。诉讼管辖约定符合《中华人民共和国民事诉讼法》第三十五条规定的，应当认定有效。\n基本案情：青岛某公司与陕西某公司签订《水处理设备供货改造分包合同》，约定青岛某公司向陕西某公司供应水处理设备，合同总金额58万元。合同争议解决条款约定：协商不能解决的，(1)提交西安市仲裁委员会仲裁，(2)依法向需方所在地人民法院起诉或按《中华人民共和国合同法》有关规定解决。青岛某公司履行合同义务后，陕西某公司支付货款30万元，剩余28万元未付。青岛某公司向山东省平度市人民法院起诉，请求支付剩余货款及违约金等。陕西某公司提出管辖权异议，认为需方所在地为陕西省西安市雁塔区，本案应由陕西省西安市雁塔区人民法院管辖。\n裁判分析：争议焦点为案涉合同中或裁或诉条款的效力及管辖法院的确定。相关事实和细节：合同约定协商不成可提交西安市仲裁委员会仲裁或向需方所在地人民法院起诉。法院分析思路及结论依据：根据《最高人民法院关于适用＜中华人民共和国仲裁法＞若干问题的解释》第七条，当事人约定争议可向仲裁机构申请仲裁也可向人民法院起诉的，仲裁协议无效。故案涉合同中仲裁约定无效，但诉讼管辖约定有效，本案应由需方陕西某公司所在地的陕西省西安市雁塔区人民法院管辖，山东省平度市人民法院对本案无管辖权。\n判决结果：一审裁定本案移送陕西省西安市雁塔区人民法院处理；二审裁定驳回上诉，维持原裁定。", "url": "/ydzk/caseDetail/qwcase/e2edfb10d1f257dc9eb306c38746a7ae", "score": 19.30098, "ajlb": "民事案件", "ay": [ "合同、准合同纠纷", "合同纠纷", "买卖合同纠纷" ], "jbdw": "山东省青岛市中级人民法院", "id": "e2edfb10d1f257dc9eb306c38746a7ae", "xzqh_p": "山东" } ] }, "message": "请求成功", "status": "success" } ``` ### 5.3 成功响应示例（未命中） ```json { "data": null, "status": "success", "code": 200, "message": "未查询到相关内容" } ``` ### 5.4 失败响应示例 #### 5.4.1 请求体为空 ```json { "data": null, "status": "failed", "code": 500, "message": "请求参数不能为空" } ``` #### 5.4.2 search_mode 非法 ```json { "data": null, "status": "failed", "code": 500, "message": "search_mode 不合法" } ``` ## 6. 代码示例 ### 6.1 CURL ```shell curl --location --request POST "https://open.chineselaw.com/open/rh_qwal_search" \ --header "X-API-Key: 你的api_key" \ --header "Accept: application/json" \ --header "Content-Type: application/json; charset=utf-8" \ --data-raw "{\"title\": \"买卖合同纠纷\", \"ay\": [\"买卖合同纠纷\"], \"ajlb\": \"民事\", \"ja_start\": \"2023-01-01\", \"ja_end\": \"2023-12-31\", \"qw\": \"违约金 逾期\", \"top_k\": 2}" ``` ### 6.2 Python ```python import requests url = "https://open.chineselaw.com/open/rh_qwal_search" API_KEY = "你的api_key" headers = { "X-API-Key": API_KEY, "Accept": "application/json", "Content-Type": "application/json; charset=utf-8", } payload = { "title": "买卖合同纠纷", "ay": ["买卖合同纠纷"], "ajlb": "民事", "ja_start": "2023-01-01", "ja_end": "2023-12-31", "qw": "违约金 逾期", "top_k": 2, } response = requests.post(url, json=payload, headers=headers, timeout=30) response.raise_for_status() print(response.json()) ``` ### 6.3 Java ```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 RhQwalSearchExample { static void main(String[] args) throws Exception { String apiKey = "你的api_key"; String url = "https://open.chineselaw.com/open/rh_qwal_search"; String body = "{\"title\":\"买卖合同纠纷\",\"ay\":[\"买卖合同纠纷\"]," + "\"ajlb\":\"民事\",\"ja_start\":\"2023-01-01\",\"ja_end\":\"2023-12-31\"," + "\"qw\":\"违约金 逾期\",\"top_k\":2}"; 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 response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode()); System.out.println(response.body()); } } ``` ### 6.4 JavaScript ```javascript const API_KEY = "你的api_key"; const url = "https://open.chineselaw.com/open/rh_qwal_search"; 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({ title: "买卖合同纠纷", ay: ["买卖合同纠纷"], ajlb: "民事", ja_start: "2023-01-01", ja_end: "2023-12-31", qw: "违约金 逾期", top_k: 2, }), }); if (!res.ok) throw new Error(`HTTP NULL`); console.log(await res.json()); ``` --- ## 普通案例关键词检索接口 - Category: 案例文书 - ID: 7 - routeKey: `rh_ptal_search` - HTTP method: `POST` - Direct endpoint: `https://open.chineselaw.com/open/rh_ptal_search` - Detail JSON: `https://apiplatform.legalmind.cn/api/apis/7` - MCP tool: `yuandian_rh_ptal_search` - MCP server: `yuandian-case` at `https://open.chineselaw.com/mcp/case/stream` - Price: 10 POINT/call; chargeType=1 Description: 对“普通案例”库进行多条件/关键词检索，返回命中的案例列表（含内容片段/摘要）与命中总数。 ### Direct API Authentication ```http X-API-Key: YOUR_API_KEY Accept: application/json Content-Type: application/json; charset=utf-8 ``` ### MCP Authentication ```http Accept: application/json, text/event-stream Authorization: Bearer YOUR_API_KEY ``` ### Full Document # 普通案例关键词检索接口 ## 1. 基本信息 - **接口名称**：普通案例关键词检索接口 - **接口用途**：对“普通案例”库进行多条件/关键词检索，返回命中的案例列表（含内容片段/摘要）与命中总数。 ## 2. 请求信息 - **HTTP Method**：POST - **URL**：`https://open.chineselaw.com/open/rh_ptal_search` - **Content-Type**：`application/json; charset=utf-8` - **Accept**：`application/json` - **X-API-Key**：`你的api_key` ## 3. 请求参数（Body） > 以下字段均为可选字段，但 **请求体不能为空**（空 JSON 会返回失败）。 ### 3.1 字段说明 | 字段名 | 类型 | 是否必填 | 说明 | | ---------------- | -------- | -------- | ------------------------------------------------------------ | | `ah` | string | 否 | 案号 | | `title` | string | 否 | 标题（queryString 精确短语匹配） | | `ay` | string[] | 否 | 案由数组；多值为或关系 | | `jbdw` | string[] | 否 | 经办法院/承办单位数组；多值为或关系 | | `xzqh_p` | string[] | 否 | 省级行政区数组，可选值：北京、天津、河北、山西、内蒙古、辽宁、吉林、黑龙江、上海、江苏、浙江、安徽、福建、江西、山东、河南、湖北、湖南、广东、广西、海南、重庆、四川、贵州、云南、西藏、陕西、甘肃、青海、宁夏、新疆、最高、新疆生产建设兵团；多值为或关系 | | `wszl` | string[] | 否 | 文书种类数组，可选值：判决书、裁定书、调解书、决定书；多值为或关系 | | `ajlb` | string | 否 | 案件类别，可选值：刑事案件、民事案件、行政案件、执行案件、管辖案件、国家赔偿与司法救助案件、强制清算与破产案件、国际司法协助案件、非诉保全审查案件、其他案件" | | `ja_start` | string | 否 | 结案/裁判日期起（含当前日期），格式为：yyyy-MM-dd | | `ja_end` | string | 否 | 结案/裁判日期止（含当前日期），格式为：yyyy-MM-dd | | `qw` | string | 否 | 全文关键词（按 `search_mode` 将空格拆分并用 AND/OR 拼接成 queryString） | | `fxgc` | string | 否 | 分析过程关键词（按 `search_mode` 将空格拆分并用 AND/OR 拼接成 queryString） | | `search_mode` | string | 否 | 关键词拼接模式：`and` 或 `or`；为空默认 `and`；非法会返回失败 | | `yyft` | string[] | 否 | 援引法条数组（形如“中华人民共和国刑法第二条”），列表的每个元素只能包含一个法条，且法条编号必须为中文“第二条”这种格式 | | `ft_search_mode` | string | 否 | `yyft` 拼接模式：`and` 或 `or`；为空默认 `and`；非法会返回失败 | | `top_k` | number | 否 | 返回条数上限：默认 10；最大 50；小于等于 0 会按默认 10 处理 | ### 3.2 校验与默认值（按代码） - body 为空 JSON：返回失败 `message = "请求参数不能为空"` - **`search_mode` 非法**：返回失败 `message = "search_mode 不合法"` - **`ft_search_mode` 非法**：返回失败 `message = "ft_search_mode 不合法"` - **`search_mode` 默认**：未传或为空 -> `and` - **`ft_search_mode` 默认**：未传或为空 -> `and` - **`top_k` 默认/上限**： - top_k <= 0 -> 10 - top_k > 50 -> 50 ## 4. 返回信息 - **返回类型**：JSON 字符串 - **成功/失败判断**：看 `status` 与 `code` ### 4.1 通用返回结构 | 字段名 | 类型 | 说明 | | --------- | -------------- | ------------------------------------------------------------ | | `status` | string | `success` / `failed` 等 | | `code` | number | 成功通常为 200/201；失败通常为 500/501 等（见 `ResultUtil`） | | `message` | string | 提示信息（例如“请求成功”、“请求参数不能为空”、“未查询到相关内容”等） | | `data` | object \| null | 业务数据；未命中时可能为 null（返回的是 success + message） | ### 4.2 `data` 字段（命中时） `data` 为对象，包含： | 字段名 | 类型 | 说明 | |---|---|---| | `total` | object | ES 命中总数 | | `lst` | object[] | 命中列表 | ### 4.3 `lst` 单条元素字段 | 字段名 | 类型 | 说明 | | ------------- | ------ | ------------------------------------------------------------ | | `type` | string | 固定为 `普通案例` | | `id` | string | 案例 ID | | `ah` | string | 案号 | | `title` | string | 标题 | | `ay` | string | 案由 | | `jbdw` | string | 经办法院/承办单位 | | `ajlb` | string | 案件类别 | | `xzqh_p` | string | 省级行政区 | | `wszl` | string | 文书种类 | | `cprq` | string | 日期 | | `content` | string | 内容片段：优先高亮片段（当本次请求含关键词时），否则优先摘要库拼接，最后回退为 `paragraph.fxgc` | | `llm_content` | string | 拼接字段：`##` | | `url` | string | 详情 URL：`/ydzk/caseDetail/case/` + `id` | | `score` | number | ES score | ## 5. 示例 ### 5.1 请求参数示例 ```JSON { "ay": ["买卖合同纠纷"], "xzqh_p": ["北京"], "wszl": ["判决书"], "ajlb": "民事", "ja_start": "2020-01-01", "ja_end": "2023-12-31", "qw": "违约金 逾期", "top_k": 2 } ``` ### 5.2 成功响应示例（命中） ```JSON { "code": 200, "data": { "total": 15414, "lst": [ { "cprq": "2022年08月18日", "llm_content": "（2022）京03民终6978号##关于新仟瑞公司主张的违约金，双方均认可所签《铝板采购合同》后附通用条款第9.1.1条约定：甲方逾期付款未超过十五天的，乙方予以宽限；甲方逾期付款超过十五天的，以逾期付款额为基数，从第十六天开始，按每日万分之一（0.1‰）向乙方偿付逾期付款的违约金，该违约金总额不超过合同总金额的百分之二（2％）。故新仟瑞公司要求按照年利率5.775％为标准计算违约金，无事实依据，一审法院根据在案证据及双方庭审陈述予以调整。对于违约金的起算时间，一审法院亦根据在案证据及双方庭审陈述予以调整。\n关于新仟瑞公司主张的律师费，因双方所签涉诉合同中并未对此作出约定，故对于新仟瑞该项诉讼请求，一审法院不予支持。\n依照《中华人民共和国合同法》第一百零七条、第一百五十九条之规定，判决：一、北京嘉寓门窗幕墙股份有限公司给付河北新仟瑞新型建材有限公司款956751.23元并支付违约金（违约金的计算方式为：以38.5万元为基数，按照年利率3.85％计算，自2021年8月6日起计算至实际付清之日止；以571751.23元为基数，按照年利率3.85％计算，自2021年12月26日起计算至实际付清之日止。上述违约金总额以29315元为限），均于判决生效之日起七日内执行；二、驳回河北新仟瑞新型建材有限公司的其他诉讼请求。如果未按判决所指定的期间履行给付金钱义务，应当依照《中华人民共和国民事诉讼法》第二百六十条之规定，加倍支付迟延履行期间的债务利息。\n二审期间，双方当事人未提交证据。\n本院对一审查明的事实予以确认。\n本院认为，综合双方诉辩意见，本案二审争议焦点为：违约金数额认定问题。\n一、二审期间，嘉寓门窗公司对其尚欠新仟瑞公司货款956751.23元无异议，本院对此予以确认。关于违约金一节，双方签订《铝板采购合同》后附通用条款第9.1.1条约定：甲方逾期付款未超过十五天的，乙方予以宽限；甲方逾期付款超过十五天的，以逾期付款额为基数，从第十六天开始，按每日万分之一（0.1‰）向乙方偿付逾期付款的违约金，该违约金总额不超过合同总金额的百分之二（2％）。现嘉寓门窗公司未按期支付货款，其应当承担逾期付款之违约责任。嘉寓门窗公司虽上诉主张双方合同中明确约定了新仟瑞公司应在嘉寓门窗公司付款前开具相应的发票，因新仟瑞公司未提供，属于有过错行为；因此嘉寓门窗公司不应承担逾期付款利息。但，嘉寓门窗公司并未提交其向新仟瑞公司付款前，要求新仟瑞公司开具发票但新仟瑞公司拒绝开具发票之相关证据；新仟瑞公司亦不予认可，故而嘉寓门窗公司关于新仟瑞公司存在过错故其不应承担逾期付款利息之上诉主张，缺乏充分依据和证据佐证，本院不予采纳。一审法院根据双方合同约定及当事人陈述予以认定嘉寓门窗公司应支付新仟瑞公司违约金，并无不当，本院予以支持。\n", "ah": "（2022）京03民终6978号", "type": "普通案例", "title": "北京嘉寓门窗幕墙股份有限公司与河北新仟瑞新型建材有限公司买卖合同纠纷二审民事判决书", "content": "关于新仟瑞公司主张的违约金，双方均认可所签《铝板采购合同》后附通用条款第9.1.1条约定：甲方逾期付款未超过十五天的，乙方予以宽限；甲方逾期付款超过十五天的，以逾期付款额为基数，从第十六天开始，按每日万分之一（0.1‰）向乙方偿付逾期付款的违约金，该违约金总额不超过合同总金额的百分之二（2％）。故新仟瑞公司要求按照年利率5.775％为标准计算违约金，无事实依据，一审法院根据在案证据及双方庭审陈述予以调整。对于违约金的起算时间，一审法院亦根据在案证据及双方庭审陈述予以调整。\n关于新仟瑞公司主张的律师费，因双方所签涉诉合同中并未对此作出约定，故对于新仟瑞该项诉讼请求，一审法院不予支持。\n依照《中华人民共和国合同法》第一百零七条、第一百五十九条之规定，判决：一、北京嘉寓门窗幕墙股份有限公司给付河北新仟瑞新型建材有限公司款956751.23元并支付违约金（违约金的计算方式为：以38.5万元为基数，按照年利率3.85％计算，自2021年8月6日起计算至实际付清之日止；以571751.23元为基数，按照年利率3.85％计算，自2021年12月26日起计算至实际付清之日止。上述违约金总额以29315元为限），均于判决生效之日起七日内执行；二、驳回河北新仟瑞新型建材有限公司的其他诉讼请求。如果未按判决所指定的期间履行给付金钱义务，应当依照《中华人民共和国民事诉讼法》第二百六十条之规定，加倍支付迟延履行期间的债务利息。\n二审期间，双方当事人未提交证据。\n本院对一审查明的事实予以确认。\n本院认为，综合双方诉辩意见，本案二审争议焦点为：违约金数额认定问题。\n一、二审期间，嘉寓门窗公司对其尚欠新仟瑞公司货款956751.23元无异议，本院对此予以确认。关于违约金一节，双方签订《铝板采购合同》后附通用条款第9.1.1条约定：甲方逾期付款未超过十五天的，乙方予以宽限；甲方逾期付款超过十五天的，以逾期付款额为基数，从第十六天开始，按每日万分之一（0.1‰）向乙方偿付逾期付款的违约金，该违约金总额不超过合同总金额的百分之二（2％）。现嘉寓门窗公司未按期支付货款，其应当承担逾期付款之违约责任。嘉寓门窗公司虽上诉主张双方合同中明确约定了新仟瑞公司应在嘉寓门窗公司付款前开具相应的发票，因新仟瑞公司未提供，属于有过错行为；因此嘉寓门窗公司不应承担逾期付款利息。但，嘉寓门窗公司并未提交其向新仟瑞公司付款前，要求新仟瑞公司开具发票但新仟瑞公司拒绝开具发票之相关证据；新仟瑞公司亦不予认可，故而嘉寓门窗公司关于新仟瑞公司存在过错故其不应承担逾期付款利息之上诉主张，缺乏充分依据和证据佐证，本院不予采纳。一审法院根据双方合同约定及当事人陈述予以认定嘉寓门窗公司应支付新仟瑞公司违约金，并无不当，本院予以支持。\n", "url": "/ydzk/caseDetail/case/183fe9bf6e95f51fab804e383854a51f", "score": 11.359024, "ajlb": "民事案件", "ay": [ "买卖合同纠纷" ], "wszl": "判决书", "id": "183fe9bf6e95f51fab804e383854a51f", "xzqh_p": "北京" }, { "cprq": "2021年05月25日", "llm_content": "（2021）京0102民初3161号##根据《最高人民法院关于审理买卖合同纠纷案件适用法律问题的解释》第十八条第四款的规定，买卖合同没有约定逾期付款违约金或者该违约金的计算方法，出卖人以买受人违约为由主张赔偿逾期付款损失，违约行为发生在2019年8月19日之前的，人民法院可以中国人民银行同期同类人民币贷款基准利率为基础，参照逾期罚息利率标准计算；违约行为发生在2019年8月20日之后的，人民法院可以违约行为发生时中国人民银行授权全国银行间同业拆借中心公布的一年期贷款市场报价利率（LPR）标准为基础，加计30——50％计算逾期付款损失。本案中，双方既未约定尾款支付时间，也未约定逾期付款违约金的计算标准。关于逾期付款违约金的起算时间，本院认为，虽双方未明确约定尾款付款时间，但是从原告2019年2月4日交货至本案2021年1月26日立案，时间将近2年，该期间早已超过被告应付尾款的合理时间，且原告在此期间多次向被告催收货款，因此，原告主张自2021年1月26日起计收逾期付款违约金，本院认为并无不当，本院予以支持。原告主张按一年期LPR标准计算违约金，该标准并未超过法律规定的违约金计算标准，因此本院予以支持。此外，根据本院确定的违约金的起算时间，本院将违约金计算标准确定为2021年1月的一年期LPR。\n综上所述，饮发酒业公司要求陈向华支付货款7000元及逾期付款违约金的诉讼请求，本院予以支持。依照《中华人民共和国合同法》第一百三十条、第一百五十九条、《最高人民法院关于审理买卖合同纠纷案件适用法律问题的解释》第一条第一款、第十八条第四款之规定，判决如下：\n本判决生效后七日内，陈向华向北京饮发酒业有限公司支付货款7000元，以及自2021年1月26日起至货款实际付清之日止的违约金（以上述未付货款为基数，按2021年1月的一年期LPR标准计算）。\n如果未按本判决指定的期间履行给付金钱义务，应当依照《中华人民共和国民事诉讼法》第二百五十三条规定，加倍支付迟延履行期间的债务利息。\n案件受理费50元以及公告费（以实际发生为准），由陈向华负担（于本判决生效后七日内直接支付给北京饮发酒业有限公司）。\n如不服本判决，可以在判决书送达之日起十五日内，向本院递交上诉状，并按对方当事人的人数提出副本，上诉于北京市第二中级人民法院，并于提起上诉后七日内交纳二审案件受理费，逾期未交按撤回上诉处理。\n审判员郭高明\n二〇二一年五月二十五日\n书记员吴佩珊", "ah": "（2021）京0102民初3161号", "type": "普通案例", "title": "北京饮发酒业有限公司与陈向华买卖合同纠纷一审民事判决书", "content": "根据《最高人民法院关于审理买卖合同纠纷案件适用法律问题的解释》第十八条第四款的规定，买卖合同没有约定逾期付款违约金或者该违约金的计算方法，出卖人以买受人违约为由主张赔偿逾期付款损失，违约行为发生在2019年8月19日之前的，人民法院可以中国人民银行同期同类人民币贷款基准利率为基础，参照逾期罚息利率标准计算；违约行为发生在2019年8月20日之后的，人民法院可以违约行为发生时中国人民银行授权全国银行间同业拆借中心公布的一年期贷款市场报价利率（LPR）标准为基础，加计30——50％计算逾期付款损失。本案中，双方既未约定尾款支付时间，也未约定逾期付款违约金的计算标准。关于逾期付款违约金的起算时间，本院认为，虽双方未明确约定尾款付款时间，但是从原告2019年2月4日交货至本案2021年1月26日立案，时间将近2年，该期间早已超过被告应付尾款的合理时间，且原告在此期间多次向被告催收货款，因此，原告主张自2021年1月26日起计收逾期付款违约金，本院认为并无不当，本院予以支持。原告主张按一年期LPR标准计算违约金，该标准并未超过法律规定的违约金计算标准，因此本院予以支持。此外，根据本院确定的违约金的起算时间，本院将违约金计算标准确定为2021年1月的一年期LPR。\n综上所述，饮发酒业公司要求陈向华支付货款7000元及逾期付款违约金的诉讼请求，本院予以支持。依照《中华人民共和国合同法》第一百三十条、第一百五十九条、《最高人民法院关于审理买卖合同纠纷案件适用法律问题的解释》第一条第一款、第十八条第四款之规定，判决如下：\n本判决生效后七日内，陈向华向北京饮发酒业有限公司支付货款7000元，以及自2021年1月26日起至货款实际付清之日止的违约金（以上述未付货款为基数，按2021年1月的一年期LPR标准计算）。\n如果未按本判决指定的期间履行给付金钱义务，应当依照《中华人民共和国民事诉讼法》第二百五十三条规定，加倍支付迟延履行期间的债务利息。\n案件受理费50元以及公告费（以实际发生为准），由陈向华负担（于本判决生效后七日内直接支付给北京饮发酒业有限公司）。\n如不服本判决，可以在判决书送达之日起十五日内，向本院递交上诉状，并按对方当事人的人数提出副本，上诉于北京市第二中级人民法院，并于提起上诉后七日内交纳二审案件受理费，逾期未交按撤回上诉处理。\n审判员郭高明\n二〇二一年五月二十五日\n书记员吴佩珊", "url": "/ydzk/caseDetail/case/938e1e392736fdf2208db6e5312f0041", "score": 11.344663, "ajlb": "民事案件", "ay": [ "买卖合同纠纷" ], "wszl": "判决书", "id": "938e1e392736fdf2208db6e5312f0041", "xzqh_p": "北京" } ] }, "message": "请求成功", "status": "success" } ``` ### 5.3 成功响应示例（未命中） ```JSON { "data": null, "status": "success", "code": 200, "message": "未查询到相关内容" } ``` ### 5.4 失败响应示例 #### 5.4.1 请求体为空 ```JSON { "data": null, "status": "failed", "code": 500, "message": "请求参数不能为空" } ``` #### **5.4.2 search_mode 非法** ```JSON { "data": null, "status": "failed", "code": 500, "message": "search_mode 不合法" } ``` #### **5.4.3 ft_search_mode 非法** ```JSON { "data": null, "status": "failed", "code": 500, "message": "ft_search_mode 不合法" } ``` ## 6. 代码示例 ### 6.1 CURL ```shell curl --location --request POST "https://open.chineselaw.com/open/rh_ptal_search" \ --header "X-API-Key: 你的api_key" \ --header "Accept: application/json" \ --header "Content-Type: application/json; charset=utf-8" \ --data-raw "{\"ay\": [\"买卖合同纠纷\"], \"xzqh_p\": [\"北京\"], \"wszl\": [\"判决书\"], \"ajlb\": \"民事\", \"ja_start\": \"2020-01-01\", \"ja_end\": \"2023-12-31\", \"qw\": \"违约金 逾期\", \"search_mode\": \"and\", \"top_k\": 2}" ``` ### 6.2 Python ```python import requests url = "https://open.chineselaw.com/open/rh_ptal_search" API_KEY = "你的api_key" headers = { "X-API-Key": API_KEY, "Accept": "application/json", "Content-Type": "application/json; charset=utf-8", } payload = { "ay": ["买卖合同纠纷"], "xzqh_p": ["北京"], "wszl": ["判决书"], "ajlb": "民事", "ja_start": "2020-01-01", "ja_end": "2023-12-31", "qw": "违约金 逾期", "search_mode": "and", "top_k": 2, } response = requests.post(url, json=payload, headers=headers, timeout=30) response.raise_for_status() print(response.json()) ``` ### 6.3 Java ```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 RhPtalSearchExample { static void main(String[] args) throws Exception { String apiKey = "你的api_key"; String url = "https://open.chineselaw.com/open/rh_ptal_search"; String body = "{\"ay\":[\"买卖合同纠纷\"],\"xzqh_p\":[\"北京\"],\"wszl\":[\"判决书\"]," + "\"ajlb\":\"民事\",\"ja_start\":\"2020-01-01\",\"ja_end\":\"2023-12-31\"," + "\"qw\":\"违约金 逾期\",\"search_mode\":\"and\",\"top_k\":2}"; 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 response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode()); System.out.println(response.body()); } } ``` ### 6.4 JavaScript ```javascript const API_KEY = "你的api_key"; const url = "https://open.chineselaw.com/open/rh_ptal_search"; 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({ ay: ["买卖合同纠纷"], xzqh_p: ["北京"], wszl: ["判决书"], ajlb: "民事", ja_start: "2020-01-01", ja_end: "2023-12-31", qw: "违约金 逾期", search_mode: "and", top_k: 2, }), }); if (!res.ok) throw new Error(`HTTP NULL`); console.log(await res.json()); ```