海关编码查询API
按海关编码或税则品名（法定名称）检索税则条目。返回编码、品名、法定单位、出口退税率、监管条件、检验检疫与编码状态。分页对齐统一查询：条数用 top_k，翻页用 filters.offset。已知商品俗称需归类时请用 trade.hs_classify；取完整税率/申报要素用 trade.hs_code_detail。
已开放
调用入口：POST /v1/data/query。
请求体字段
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
| domain | string | 数据域（必填） | trade |
| type | string | 数据类型（必填） | hs_code_search |
| query | string | 关键词：海关编码或税则品名；与 filters.keywords 二选一 | 马 |
| filters | object | 结构化过滤条件，见下方「常用 filters」 | — |
| top_k | integer | 分页参数：每页条数，取值范围 1–100，本能力默认 10 | 10 |
常用 filters
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
| keywords | string | 关键词：海关编码或税则品名（也可用 query） | 马 |
| highlight | boolean | 是否返回名称/描述关键词高亮 HTML（默认 false） | false |
| offset | integer | 分页参数：偏移量（默认 0；配合顶层 top_k 翻页，建议为 top_k 的整数倍） | 0 |
返回字段（hits[]）
| 字段 | 类型 | 说明 |
|---|---|---|
| HSCode | string | 商品编码 |
| Name | string | 商品名称 |
| Remark | string | 商品描述 |
| Units | string | 法定单位 |
| ExportTaxRebateRate | string | 出口退税税率 |
| Regulatory | string | 监管条件 |
| Inspection | string | 检验检疫条件 |
| Status | integer | 编码状态（1 正常 / 2 过期） |
| source | string | 来源标识 |
| disclaimer | 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":"trade", "type":"hs_code_search", "query":"马", "filters":{ "keywords":"马", "highlight":"false", "offset":0 }, "top_k":10 }'将 YOUR_API_KEY 替换为控制台签发的密钥。完整字段与响应约定见 统一查询。