海关编码更新记录API

按时间范围查询海关编码字段变更（新增/删除/修改）。range：7d 最近 7 天、30d 最近 30 天（默认）、3m 最近 3 个月。分页对齐统一查询：条数用 top_k，翻页用 filters.offset（本地切片）。通用接口，购买税则/归类能力附赠；日调用上限较低，请按需查询。

已开放调用入口：POST /v1/data/query。

请求体字段

字段	类型	说明	示例
domain	string	数据域（必填）	`trade`
type	string	数据类型（必填）	`hs_code_updates`
query	string	时间范围：7d / 30d / 3m（默认 30d）；与 filters.range 二选一	`30d`
filters	object	结构化过滤条件，见下方「常用 filters」	—
top_k	integer	分页参数：每页条数，取值范围 1–100，本能力默认 20	`20`

常用 filters

字段	类型	说明	示例
range	string	时间范围：7d / 30d / 3m（默认 30d；也可用 query）	`30d`
offset	integer	分页参数：偏移量（默认 0；配合顶层 top_k 翻页，建议为 top_k 的整数倍）	`0`

返回字段（hits[]）

字段	类型	说明
hsCode	string	海关编码
field	string	变更字段名
changeType	string	变更类型（新增/删除/修改）
dataType	string	数据类型（如 CNCode）
before	string	变更前的值
after	string	变更后的值
createTime	string	变更时间
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_updates", "query":"30d", "filters":{ "range":"30d", "offset":0 }, "top_k":20 }'

将 YOUR_API_KEY 替换为控制台签发的密钥。完整字段与响应约定见统一查询。