行政处罚API
可以通过公司名称、公司 id、注册号或统一社会信用代码获取企业行政处罚，包括处罚单位、决定书文号、违法行为类型、处罚内容、处罚日期和公示日期。filters.keyword 必填，也可用顶层 query。有分页：条数用 top_k（每页最多 20 条，默认 20），翻页用 filters.offset。
已开放
调用入口：POST /v1/data/query。
请求体字段
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
| domain | string | 数据域（必填） | enterprise |
| type | string | 数据类型（必填） | punishment |
| query | string | 搜索关键字（公司名称、公司id、注册号或社会统一信用代码）；与 filters.keyword 二选一 | 北京百度网讯科技有限公司 |
| filters | object | 结构化过滤条件，见下方「常用 filters」 | — |
| top_k | integer | 分页参数：每页条数，取值范围 1–100，本能力默认 20 | 20 |
常用 filters
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
| keyword | string | 搜索关键字（必填；公司名称、公司id、注册号或社会统一信用代码；也可用 query） | 北京百度网讯科技有限公司 |
| offset | integer | 分页参数：偏移量（默认 0；配合顶层 top_k 翻页，建议为 top_k 的整数倍） | 0 |
返回字段（hits[]）
| 字段 | 类型 | 说明 |
|---|---|---|
| departmentName | string | 作出行政处罚决定机关名称 |
| punishNumber | string | 行政处罚决定书文号 |
| regNum | string | 注册号 |
| name | string | 处罚公司名称 |
| publishDate | string | 公示日期 |
| description | string | 描述 |
| type | string | 违法行为类型 |
| content | string | 行政处罚内容 |
| base | string | 省份 |
| decisionDate | string | 作出行政处罚决定日期 |
| legalPersonName | string | 法定代表人（负责人）姓名 |
curl 请求示例
curl -sS -X POST https://data.devnors.com/v1/data/query \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "domain":"enterprise", "type":"punishment", "query":"北京百度网讯科技有限公司", "filters":{ "keyword":"北京百度网讯科技有限公司" }, "top_k":20 }'将 YOUR_API_KEY 替换为控制台签发的密钥。完整字段与响应约定见 统一查询。