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